Todos os produtos
Search
Central de documentação

Object Storage Service:get-object-acl

Última atualização: Jul 03, 2026

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

Observações de uso

  • Por padrão, uma conta Alibaba Cloud tem permissão para consultar as ACLs de objetos. Para consultar as ACLs com um usuário RAM ou Security Token Service (STS), é necessária a permissão oss:GetObjectAcl. Para mais informações, consulte Conceder uma política personalizada.

  • Se uma solicitação GetObjectACL consultar a ACL de um objeto sem configuração definida, o OSS retornará a ACL padrão desse objeto. Nesse cenário, a ACL do objeto corresponderá à do bucket onde ele está armazenado. Por exemplo, se a ACL do bucket for privada, a do objeto também será privada.

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 da versão do objeto.

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

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

Exemplos

  • Consultar a ACL de examplebucket.

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

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

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