O comando initiate-multipart-upload inicia uma tarefa de upload multipart.
Notas de uso
Ao executar o comando initiate-multipart-upload, o Object Storage Service (OSS) cria e retorna um ID de upload globalmente exclusivo para identificar a tarefa de upload multipart. Você pode usar esse ID para realizar operações relacionadas, como cancelar ou consultar o upload multipart.
Iniciar uma requisição de upload multipart não afeta um objeto existente que tenha o mesmo nome.
Permissões
Por padrão, uma conta Alibaba Cloud possui permissões completas. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm nenhuma permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de RAM policies ou Bucket Policy.
|
API |
Action |
Description |
|
InitiateMultipartUpload |
|
Inicializa tarefas de upload multipart. |
|
|
Ao inicializar uma tarefa de upload multipart com tags de objeto especificadas via x-oss-tagging, esta permissão é obrigatória. |
|
|
|
Ao fazer upload de um objeto cujos metadados contenham X-Oss-Server-Side-Encryption: KMS, essas duas permissões são obrigatórias. |
|
|
|
Sintaxe do comando
ossutil api initiate-multipart-upload --bucket value --key value [flags]|
Parâmetro |
Tipo |
Descrição |
|
--bucket |
string |
O nome do bucket. |
|
--key |
string |
O caminho completo do objeto. |
|
--encoding-type |
string |
Especifica a codificação do conteúdo retornado. |
|
--content-encoding |
string |
O formato de codificação do conteúdo do objeto no download. |
|
--content-type |
string |
O tipo de conteúdo do objeto. |
|
--content-disposition |
string |
O nome do objeto no download. |
|
--cache-control |
string |
O comportamento de cache da página web no download do objeto. |
|
--metadata |
stringArray |
Os metadados definidos pelo usuário do objeto no formato key=value. Para especificar metadados personalizados, configure parâmetros com o prefixo x-oss-meta-*. |
|
--server-side-data-encryption |
string |
O algoritmo de criptografia do objeto. |
|
--server-side-encryption |
string |
O método de criptografia do lado do servidor usado para criptografar cada parte do objeto que será carregado. |
|
--server-side-encryption-key-id |
string |
O ID da chave mestra do cliente (CMK) gerenciada pelo Key Management Service (KMS). |
|
--storage-class |
string |
A classe de armazenamento do objeto. |
|
--tagging |
string |
As tags do objeto. |
|
--expires |
string |
O tempo de expiração em milissegundos. |
|
--forbid-overwrite |
string |
Especifica se um objeto com o mesmo nome deve ser substituído ao chamar a operação CompleteMultipartUpload. |
O comando initiate-multipart-upload corresponde à operação de API InitiateMultipartUpload. Para mais informações sobre os parâmetros dessa operação de API, consulte InitiateMultipartUpload.
Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Supported global command-line options.
Exemplos
-
Inicie uma tarefa de upload multipart.
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject -
Inicie uma tarefa de upload multipart e exiba o resultado no formato JSON.
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format json -
Inicie uma tarefa de upload multipart e exiba o resultado no formato YAML.
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format yaml -
Inicie uma tarefa de upload multipart e especifique metadados personalizados.
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com -
Inicie uma tarefa de upload multipart e especifique tags para o objeto.
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --tagging "TagA=A&TagB=B" -
Inicie uma tarefa de upload multipart e especifique o método de criptografia do lado do servidor para o objeto.
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac**** -
Inicie uma tarefa de upload multipart e impeça a substituição de um objeto com o mesmo nome.
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --forbid-overwrite true -
Inicie uma tarefa de upload multipart e defina o comportamento de cache da página web no download do objeto.
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --cache-control no-cache -
Inicie uma tarefa de upload multipart e especifique o nome do objeto no download.
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --content-disposition "attachment;filename=oss_download.jpg"