Envia um objeto para um bucket.
Observações de uso
O objeto a ser enviado não pode exceder 5 GB.
Por padrão, se já existir um objeto com o mesmo nome e você tiver as permissões de acesso necessárias, o novo objeto substituirá o existente.
Permissões
Uma conta Alibaba Cloud tem permissões totais por padrão. Usuários RAM ou funções RAM vinculados a essa conta não têm nenhuma permissão configurada inicialmente. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.
|
API |
Ação |
Descrição |
|
PutObject |
|
Envia um objeto. |
|
|
Necessário ao especificar tags de objeto com o cabeçalho |
|
|
|
Necessário se o cabeçalho |
|
|
|
Sintaxe do comando
ossutil api put-object --bucket value --key value [flags]|
Parâmetro |
Tipo |
Descrição |
|
--body |
string |
O corpo da requisição. |
|
--bucket |
string |
O nome do bucket. |
|
--cache-control |
string |
O comportamento de cache do objeto. |
|
--content-disposition |
string |
O nome do arquivo para baixe do objeto. |
|
--content-encoding |
string |
O formato de codificação do conteúdo do objeto. |
|
--expires |
string |
O tempo de expiração. |
|
--forbid-overwrite |
boolean |
Indica se a substituição de um objeto com o mesmo nome é proibida. |
|
--key |
string |
O caminho completo do objeto. |
|
--metadata |
stringArray |
Os metadados do objeto. Use parâmetros com o prefixo x-oss-meta-* para metadados personalizados. |
|
--object-acl |
string |
A lista de controle de acesso (ACL) do objeto. |
|
--server-side-data-encryption |
string |
O algoritmo de criptografia no lado do servidor para o objeto. |
|
--server-side-encryption |
string |
O método de criptografia no lado do servidor. |
|
--server-side-encryption-key-id |
string |
O ID da chave mestra do cliente (CMK) gerenciada pelo KMS. |
|
--storage-class |
string |
A classe de armazenamento do objeto. |
|
--tagging |
string |
As tags do objeto. Especifique várias tags no formato TagA=A&TagB=B. |
O comando put-object corresponde à operação da API PutObject. Para obter mais detalhes sobre os parâmetros dessa operação, consulte PutObject.
Para saber mais sobre as opções globais de linha de comando compatíveis, consulte Opções globais de linha de comando.
Exemplos
-
Envie um objeto a partir de uma string.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" -
Envie um objeto de um arquivo local.
ossutil api put-object --bucket examplebucket --key exampleobject --body file://uploadFile -
Envie uma string com metadados personalizados.
ossutil api put-object --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com --body "hi oss" -
Envie uma string com tags.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --tagging "TagA=A&TagB=B" -
Envie uma string com uma ACL e uma classe de armazenamento específicas.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --object-acl private --storage-class IA -
Envie uma string com criptografia no lado do servidor.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac**** -
Envie uma string sem substituir um objeto com o mesmo nome.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --forbid-overwrite true -
Envie uma string com configurações de controle de cache.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --cache-control no-cache -
Envie uma string com um nome de arquivo personalizado para baixe.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"