Todos os produtos
Search
Central de documentação

Object Storage Service:put-object-acl

Última atualização: Sep 25, 2026

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

Notas de uso

  • Por padrão, uma conta Alibaba Cloud tem permissão para defina a ACL de um objeto. defina a ACL como usuário RAM ou usando o Security Token Service (STS) requer a permissão oss:PutObjectAcl. Para mais informações, consulte Grant a custom policy.

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

  • A ACL de um objeto tem precedência sobre a ACL do bucket onde o objeto está armazenado. Por exemplo, se um objeto com a ACL public-read-write for armazenado em um bucket com a ACL private, todos os usuários podem ler e gravar o 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 mais informações sobre os parâmetros da operação PutObjectACL, consulte PutObjectACL.

  • Para obter mais detalhes sobre as opções globais de linha de comando compatíveis, consulte Command-line options.

Exemplo

defina a ACL de examplebucket como private.

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