Consulta a lista de controle de acesso (ACL) de um bucket.
Observações
Requer a permissão oss:GetBucketAcl. Para mais informações, consulte Conceder uma política personalizada.
Sintaxe da solicitação
GET /? acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueCabeçalhos da solicitação
O DescribeRegions usa apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.
Elementos da resposta
|
Elemento |
Tipo |
Descrição |
|
AccessControlList |
Container |
Contém as informações de ACL. Nó pai: AccessControlPolicy. |
|
AccessControlPolicy |
Container |
Contém a resposta do GetBucketACL. Nó pai: nenhum. |
|
DisplayName |
String |
Nome do proprietário do bucket. Atualmente, corresponde ao ID do usuário. Nó pai: AccessControlPolicy e Owner. |
|
Grant |
Enumeration |
ACL do bucket. Valores válidos: private, public-read e public-read-write. Nó pai: AccessControlPolicy e AccessControlList. |
|
ID |
String |
ID de usuário do proprietário do bucket. Nó pai: AccessControlPolicy e Owner. |
|
Owner |
Container |
Contém informações sobre o proprietário do bucket. Nó pai: AccessControlPolicy. |
Exemplos
Exemplo de solicitação
GET /? acl HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 04:11:23 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemplo de resposta
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2012 04:11:23 GMT
Content-Length: 253
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<? xml version="1.0" ? >
<AccessControlPolicy>
<Owner>
<ID>0022012****</ID>
<DisplayName>user_example</DisplayName>
</Owner>
<AccessControlList>
<Grant>public-read</Grant>
</AccessControlList>
</AccessControlPolicy>SDKs do OSS
Os seguintes SDKs do OSS oferecem suporte ao GetBucketAcl:
ossutil
Para obter informações sobre o comando do ossutil correspondente à operação GetBucketAcl, consulte get-bucket-acl.
Códigos de erro
|
Código de erro |
Código de status HTTP |
Descrição |
|
NoSuchBucket |
404 |
O bucket especificado não existe. |
|
AccessDenied |
403 |
Você não tem autorização para consultar a ACL do bucket. Somente o proprietário do bucket pode executar essa operação. |