Todos os produtos
Search
Central de documentação

Object Storage Service:append

Última atualização: Sep 25, 2026

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

Notas de uso

  • Para fazer upload por anexação, você precisa das permissões oss:GetObject e oss:PutObject. Para mais informações, consulte Grant a custom policy.

  • Para mais informações sobre uploads por anexação, consulte Append upload.

  • Se o objeto especificado não existir, o comando cria um objeto anexável. Se o objeto já existir, mas não for anexável, o comando retorna um erro.

Sintaxe do comando

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

Parâmetro

Tipo

Descrição

source

string

A fonte de dados. Especifique um caminho local, um caminho do OSS ou -.

Se você especificar -, o ossutil aceita a entrada padrão.

--storage-class

string

A classe de armazenamento do objeto. Valores válidos:

  • Standard: Standard

  • IA: Infrequent Access (IA)

  • Archive: Archive

--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 é de leitura pública.

  • public-read-write: A ACL é de leitura e gravação pública.

--request-payer

string

O pagador da solicitação. Se o pay-by-requester estiver ativado para o bucket, defina este parâmetro como requester.

--metadata

strings

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

--tagging

strings

As tags do objeto no formato de pares chave=valor.

--cache-control

string

Especifica o comportamento de cache em navegadores da web ao baixar o objeto.

--content-disposition

string

O modo de exibição do objeto.

--content-encoding

string

O método de codificação do objeto.

--content-type

string

O tipo de conteúdo do objeto.

--encoding-type

string

O método de codificação do nome do objeto ou do arquivo. Valores válidos: url.

--expires

string

O tempo absoluto de expiração do cache no Horário de Greenwich (GMT). Por exemplo, 2022-10-12T00:00:00.000Z.

Nota

Para mais informações, consulte Command-line options.

Exemplos

  • Faça 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
  • Anexe o conteúdo de 2.txt ao final do objeto append.txt por meio da entrada padrão.

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

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