Upload de um Objeto do Object Storage para um Bucket
Faça upload de um objeto para um bucket ou pasta no serviço Object Storage.
Para fazer upload de objetos com mais de 64 MiB, a Console usa uploads multiparte. Você precisa das permissões OBJECT_CREATE e OBJECT_OVERWRITE para executar uploads em várias partes. Para obter detalhes, consulte Uploads Multiparte do Serviço Object Storage e Detalhes para os serviços Object Storage, Archive Storage e Data Transfer.
Use o comando oci os object put e os parâmetros necessários para fazer upload de um objeto para um bucket:
oci os object put --bucket-name bucket_name --file file_location [OPTIONS]
em que
file_location
é o caminho do diretório de origem do objeto que está sendo submetido a upload, comoC:\workspace\Uploads\MyFile.txt
ou/home/user/Documents/Uploads/MyFile.txt
. O nome do objeto submetido a upload não inclui as informações do caminho (por exemplo,C:\workspace\Uploads\
), apenas o nome do arquivo real (MyFile.txt
).O upload de um objeto pode ser feito como uma única parte ou como várias partes (multiparte). Use a opção
--no-multipart
para fazer upload como uma única parte. Para obter informações detalhadas sobre uploads múltiplos, consulte Uploads Multiparte do Serviço Object Storage.Para obter mais informações sobre atributos que você pode adicionar ao fazer upload de um objeto, consulte Cabeçalhos e Metadados de Resposta Opcionais.
Para adicionar pares chave-valor de metadados personalizados, use a opção
--metadata
:oci os object put --bucket-name bucket_name --file file_location --name object_name --metadata json_formatted_key-value_pairs
em queJSON-formatted_key-value_pair
é uma entrada de dados do par chave-valor na forma de JSON com formatação válida. Consulte Especificando Entrada de Dados Complexa e Usando um Arquivo JSON para Entrada de Dados Complexa para obter mais informações sobre a formatação JSON.Por exemplo:
oci os object put --bucket-name MyBucket --file C:\workspace\MyFile.txt --metadata '{"Department": "Finance"}' { "etag": "3504606b-8412-4b5d-924a-aeaeacf1df1e", "last-modified": "Wed, 20 Nov 2019 04:37:29 GMT", "opc-content-md5": "1B2M2Y8AsgTpgAmY7PhCfg==" }
Especificando a Camada de Armazenamento do Objeto Submetido a Upload
Inclua o parâmetro
storage-tier
para designar uma camada de armazenamento ao objeto que você está fazendo upload.oci os object put --bucket-name bucket_name --file file_location --storage-tier [Archive | InfrequentAccess | Standard] [OPTIONS]
Por exemplo, se você estiver fazendo upload para um bucket configurado pela camada Padrão e quiser designar o objeto à camada de armazenamento InfrequentAccess, inclua
--storage-tier InfrequentAccess
no comando:
Consulte Camadas do Armazenamento de Objetos para obter mais informações sobre como as camadas de armazenamento funcionam.oci os object put --bucket-name MyStandardBucket --file C:\workspace\Uploads\MyDocument.txt --storage-tier InfrequentAccess { "etag": "6b292c1a-b01b-4f36-97c8-4567fb43d071", "last-modified": "Sat, 12 Dec 2020 12:58:01 GMT", "opc-content-md5": "9P61OSaYe4fXxaeK8siuDw==" }
Se você não especificar uma camada de armazenamento no comando, o objeto será designado e transferido por upload automaticamente para a camada de armazenamento padrão do bucket (Padrão ou Arquivo Compactado).
Nomeando o Objeto Submetido a Upload
Inclua o parâmetro
name
para nomear o objeto de upload, excluindo seu caminho. Esse parâmetro será obrigatório se o objeto estiver sendo lido no STDIN. Por exemplo:oci os object put --bucket-name MyBucket --file C:\workspace\Uploads\MyFile.txt --name AboutMyCompany { "etag": "cadb9f8a-3292-45e6-a1e8-f075699fb619", "last-modified": "Fri, 11 Dec 2020 14:04:19 GMT", "opc-content-md5": "9P61OSaYe4fXxaeK8siuDw==" }
Se você não incluir o parâmetro
name
, o nome do arquivo será usado como o nome do objeto submetido a upload (se não estiver sendo lido no STDIN)Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Comando da CLI.
Execute a operação PutObject para fazer upload de um objeto para um bucket.
O serviço Object Storage pré-anexa a string de namespace do Object Storage e o nome do bucket ao nome do objeto ao construir um URL para uso com a API:
/n/object_storage_namespace/b/bucket/o/object_name
O nome do objeto é tudo após
/o/
, o que pode incluir níveis de hierarquia e strings de prefixo.