Todos os produtos
Search
Central de documentação

Object Storage Service:get-object-acl

Última atualização: Sep 25, 2026

O comando get-object-acl consulta a lista de controle de acesso (ACL) de um objeto em um bucket.

Notas de uso

  • Por padrão, uma conta Alibaba Cloud tem as permissões necessárias para consultar as ACLs de objetos. Para consultar as ACLs usando um usuário RAM ou o Security Token Service (STS), você deve ter a permissão oss:GetObjectAcl. Para obter mais informações, consulte Grant a custom policy.

  • Quando uma solicitação GetObjectACL é enviada para consultar a ACL de um objeto sem ACL configurada, o OSS retorna a ACL padrão desse objeto. Nesse caso, a ACL do objeto é igual à do bucket em que ele está armazenado. Por exemplo, se a ACL do bucket for private, a ACL do objeto também será private.

Sintaxe do comando

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

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--key

string

Caminho completo do objeto.

--version-id

string

ID de versão do objeto.

Nota
  • O comando get-object-acl corresponde à operação GetObjectACL. Para obter mais informações sobre os parâmetros da operação GetObjectACL, consulte GetObjectACL.

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

Exemplos

  • Consulte a ACL de examplebucket.

    ossutil api get-object-acl --bucket examplebucket --key exampleobject
  • Consulte a ACL de examplebucket e exiba o resultado no formato JSON.

    ossutil api get-object-acl --bucket examplebucket --key exampleobject --output-format json
  • Consulte a ACL de examplebucket e exiba o resultado no formato YAML.

    ossutil api get-object-acl --bucket examplebucket --key exampleobject --output-format yaml