Consulta la lista de control de acceso (ACL) de un bucket.
Notas
Requiere el permiso oss:GetBucketAcl. Para obtener más información, consulte Grant a custom policy.
Sintaxis de la solicitud
GET /? acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueEncabezados de la solicitud
DescribeRegions utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
|
AccessControlList |
Contenedor |
Contiene la información de la ACL. Nodo padre: AccessControlPolicy. |
|
AccessControlPolicy |
Contenedor |
Contiene la respuesta de GetBucketACL. Nodo padre: Ninguna. |
|
DisplayName |
String |
Nombre del propietario del bucket, que actualmente coincide con el ID de usuario. Nodo padre: AccessControlPolicy y Owner. |
|
Grant |
Enumeración |
La ACL del bucket. Valores válidos: private, public-read y public-read-write. Nodo padre: AccessControlPolicy y AccessControlList. |
|
ID |
String |
El ID de usuario del propietario del bucket. Nodo padre: AccessControlPolicy y Owner. |
|
Owner |
Contenedor |
Contiene la información del propietario del bucket. Nodo padre: AccessControlPolicy. |
Ejemplos
Solicitud de ejemplo
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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eRespuesta de ejemplo
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>SDK de OSS
Los siguientes SDK de OSS admiten GetBucketAcl:
ossutil
Para obtener información sobre el comando de ossutil correspondiente a la operación GetBucketAcl, consulte get-bucket-acl.
Códigos de error
|
Código de error |
Código de estado HTTP |
Descripción |
|
NoSuchBucket |
404 |
El bucket especificado no existe. |
|
AccessDenied |
403 |
No tiene autorización para consultar la ACL del bucket. Solo el propietario del bucket puede ejecutar esta operación. |