Todos os produtos
Search
Central de documentação

Object Storage Service:put-object-acl

Última atualização: Jul 03, 2026

O comando put-object-acl define ou modifica a lista de controle de acesso (ACL) de um objeto.

Observações de uso

  • Por padrão, uma conta Alibaba Cloud tem permissão para definir a ACL de um objeto. Usuários RAM ou chamadas via Security Token Service (STS) exigem a permissão oss:PutObjectAcl. Para mais informações, consulte Conceder uma política personalizada.

    Somente o proprietário do bucket com permissões de leitura e gravação de objetos no bucket pode chamar esta operação para modifique as ACLs do objeto.

  • A ACL de um objeto tem precedência sobre a ACL do bucket onde ele está armazenado. Por exemplo, se um objeto com ACL public-read-write estiver em um bucket com ACL private, todos os usuários poderão ler e gravar esse objeto.

Sintaxe do comando

ossutil api put-object-acl --bucket value --key value --object-acl value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--key

string

Caminho completo do objeto.

--object-acl

string

ACL do objeto. Valores válidos:

  • private

  • public-read

  • public-read-write

  • default (o objeto herda a ACL do bucket)

--version-id

string

ID da versão do objeto.

Nota
  • O comando put-object-acl corresponde à operação PutObjectACL. Para obter mais detalhes sobre os parâmetros dessa operação, consulte PutObjectACL.

  • Para ver as opções globais de linha de comando compatíveis, consulte Opções de linha de comando.

Exemplo

Defina a ACL de examplebucket como private.

ossutil api put-object-acl --bucket examplebucket --key exampleobject --object-acl private