Todos os produtos
Search

Este produto

    Object Storage Service:append-object

    Central de documentação

    Object Storage Service:append-object

    Última atualização: Jul 03, 2026

    Faz o upload de um objeto adicionando dados a ele de forma incremental.

    Observações de uso

    • O objeto final criado pelo comando append-object não pode exceder 5 GB.

    • O comando append-object não oferece suporte à criptografia no lado do servidor com Key Management Service (KMS) usando um ID de chave mestra do cliente (CMK) especificado.

    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 têm nenhuma permissão 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

    Action

    Description

    AppendObject

    oss:PutObject

    Use esta operação para fazer o upload de um objeto anexando-o a um objeto existente.

    oss:PutObjectTagging

    Necessária ao especificar tags de objeto via x-oss-tagging durante o upload por anexação a um objeto existente.

    Sintaxe do comando

    ossutil api append-object --bucket value --key value --position value [flags]

    Parâmetro

    Tipo

    Descrição

    --body

    string

    Corpo da requisição.

    --bucket

    string

    Nome do bucket.

    --cache-control

    string

    Comportamento de cache do objeto.

    --content-disposition

    string

    Nome de exibição do objeto ao ser baixado.

    --content-encoding

    string

    Formato de codificação do objeto.

    --content-md5

    string

    Hash MD5 do conteúdo do objeto, usado para verificar a integridade dos dados.

    --expires

    string

    Tempo de expiração.

    --key

    string

    Caminho completo do objeto.

    --metadata

    stringArray

    Metadados do objeto. Especifique metadados personalizados com parâmetros prefixados por x-oss-meta-*.

    --object-acl

    string

    Lista de controle de acesso (ACL) do objeto.

    --position

    string

    Posição inicial para adicionar dados, em bytes.

    --server-side-encryption

    string

    Método de criptografia no lado do servidor.

    --storage-class

    string

    Classe de armazenamento do objeto.

    --tagging

    string

    Tags do objeto. É possível especificar várias tags. Exemplo: TagA=A&TagB=B.
    Nota

    • O comando append-object corresponde à operação da API AppendObject. Para mais detalhes sobre os parâmetros dessa operação, consulte AppendObject.

    • Para obter mais informações sobre as opções globais de linha de comando compatíveis, consulte Opções globais de linha de comando.

    Exemplos

    • Adicione uma string ao objeto exampleobject.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss"

    • Anexe dados de um arquivo ao objeto exampleobject.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body file://appendFile

    • Inclua uma string no objeto exampleobject com metadados personalizados.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --metadata user=aliyun --metadata email=ali***@aliyuncs.com

    • Acrescente uma string ao objeto exampleobject definindo tags.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --tagging "TagA=A&TagB=B"

    • Adicione uma string ao objeto exampleobject e defina a ACL e a classe de armazenamento.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --object-acl private --storage-class IA

    • Faça o upload de uma string para o objeto exampleobject com criptografia no lado do servidor.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --body "hi oss" --server-side-encryption AES256

    • Anexe uma string e configure o comportamento de cache-control do objeto.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --cache-control no-cache

    • Adicione uma string e defina o nome do arquivo para baixe do objeto.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"

    • Anexe uma string ao objeto exampleobject com verificação de integridade Content-MD5.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-md5 ohhnqLBJFiKkPSBO1eNaUA==