Todos os produtos
Search

Este produto

    Object Storage Service:initiate-multipart-upload

    Central de documentação

    Object Storage Service:initiate-multipart-upload

    Última atualização: Jul 03, 2026

    O comando initiate-multipart-upload inicia uma tarefa de upload multipart.

    Observações 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. Use esse ID para realizar operações relacionadas, como abortar ou consultar o upload multipart.

    • Iniciar um upload multipart não afeta objetos existentes com o mesmo nome.

    Permissões

    Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a essa conta não possuem permissões iniciais. A conta Alibaba Cloud ou o administrador deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

    API

    Action

    Descrição

    InitiateMultipartUpload

    oss:PutObject

    Inicializa tarefas de upload multipart.

    oss:PutObjectTagging

    Necessária ao especificar tags de objeto via x-oss-tagging durante a inicialização do upload multipart.

    kms:GenerateDataKey

    Ambas as permissões são obrigatórias se os metadados do objeto contiverem X-Oss-Server-Side-Encryption: KMS durante o upload.

    kms:Decrypt

    Sintaxe do comando

    ossutil api initiate-multipart-upload --bucket value --key value [flags]

    Parâmetro

    Tipo

    Descrição

    --bucket

    string

    Nome do bucket.

    --key

    string

    Caminho completo do objeto.

    --encoding-type

    string

    Define a codificação do conteúdo retornado.

    --content-encoding

    string

    Formato de codificação de conteúdo aplicado ao objeto durante o download.

    --content-type

    string

    Tipo de conteúdo do objeto.

    --content-disposition

    string

    Nome atribuído ao objeto no momento do download.

    --cache-control

    string

    Comportamento de cache da página web durante o download do objeto.

    --metadata

    stringArray

    Metadados do usuário no formato chave=valor. Para definir metadados personalizados, configure parâmetros com o prefixo x-oss-meta-*.

    --server-side-data-encryption

    string

    Algoritmo de criptografia do objeto.

    --server-side-encryption

    string

    Método de criptografia no lado do servidor usado para criptografar cada parte do objeto a ser enviado.

    --server-side-encryption-key-id

    string

    ID da chave mestra do cliente (CMK) gerenciada pelo Key Management Service (KMS).

    --storage-class

    string

    Classe de armazenamento do objeto.

    --tagging

    string

    Tags associadas ao objeto.

    --expires

    string

    Tempo de expiração em milissegundos.

    --forbid-overwrite

    string

    Indica se a substituição de um objeto com o mesmo nome deve ser bloqueada ao chamar a operação CompleteMultipartUpload.
    Nota

    Exemplos

    • Execute uma tarefa de upload multipart.

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject

    • Execute um upload multipart e exiba o resultado em formato JSON.

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format json

    • Execute um upload multipart e exiba o resultado em formato YAML.

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format yaml

    • Execute um upload multipart e especifique metadados personalizados.

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com

    • Execute um upload multipart e especifique tags de objeto.

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --tagging "TagA=A&TagB=B"

    • Execute um upload multipart e defina o método de criptografia no 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****

    • Execute um upload multipart e impeça a substituição de objetos com o mesmo nome.

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --forbid-overwrite true

    • Execute um upload multipart e defina o comportamento de cache da página web para downloads do objeto.

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --cache-control no-cach

    • Execute um upload multipart e especifique o nome do objeto quando ele for baixado.

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --content-disposition "attachment;filename=oss_download.jpg"