Todos os produtos
Search
Central de documentação

Object Storage Service:append

Última atualização: Jul 03, 2026

Adiciona conteúdo ao final de um objeto anexável.

Observações de uso

  • Para realizar um upload por adição, são necessárias as permissões oss:GetObject e oss:PutObject. Para mais informações, consulte Conceder uma política personalizada.

  • Para obter mais detalhes sobre uploads por adição, consulte Upload por adição.

  • Se o objeto especificado não existir, o comando criará um objeto anexável. Caso o objeto já exista, mas não seja anexável, o comando retornará um erro.

Sintaxe do comando

ossutil append source oss://bucket/object [flags]

Parâmetro

Tipo

Descrição

source

string

Origem dos dados. Especifique um caminho local, um caminho do OSS ou -.

Se você defina -, o ossutil aceitará a entrada padrão (stdin).

--storage-class

string

Classe de armazenamento do objeto. Valores válidos:

  • Standard: Padrão

  • IA: Acesso pouco frequente (IA)

  • Archive: Arquivo morto

--acl

string

Especifique a lista de controle de acesso (ACL) do objeto. Valores válidos:

  • default: A ACL é herdada do bucket

  • private: A ACL é privada.

  • public-read: A ACL permite leitura pública.

  • public-read-write: A ACL permite leitura e escrita públicas.

--request-payer

string

Pagador da requisição. Se o recurso de pagamento pelo solicitante estiver ativado no bucket, defina este parâmetro como requester.

--metadata

strings

Metadados de usuário do objeto no formato de pares chave=valor.

--tagging

strings

Tags do objeto no formato de pares chave=valor.

--cache-control

string

Define o comportamento de cache nos navegadores web durante o download do objeto.

--content-disposition

string

Modo de exibição do objeto.

--content-encoding

string

Método de codificação do objeto.

--content-type

string

Tipo de conteúdo do objeto.

--encoding-type

string

Método de codificação do nome do objeto ou do arquivo. Valor válido: url.

--expires

string

Tempo absoluto de expiração do cache no Horário de Greenwich (GMT). Exemplo: 2022-10-12T00:00:00.000Z.

Nota

Para mais informações, consulte Opções de linha de comando.

Exemplos

  • Faça o upload do arquivo 1.txt do diretório local para o bucket, com a ACL do objeto definida como private e a tag tag=value adicionada ao objeto.

    ossutil append 1.txt oss://dst-bucket/append.txt --acl private --tagging tag=value
  • Adicione o conteúdo de 2.txt ao final do objeto append.txt usando a entrada padrão.

    cat 2.txt | ossutil append - oss://dst-bucket/append.txt
  • Anexe o conteúdo de 3.txt, localizado no bucket src-bucket, ao final do objeto append.txt.

    ossutil append oss://src-bucket/3.txt oss://dst-bucket/append.txt