Interroge la liste de contrôle d'accès (ACL) d'un bucket.
Notes
L'autorisation oss:GetBucketAcl est requise. Pour plus d'informations, consultez la rubrique Grant a custom policy.
Syntaxe de la requête
GET /? acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueEn-têtes de requête
DescribeRegions utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez la rubrique Common request headers.
Éléments de réponse
|
Element |
Type |
Description |
|
AccessControlList |
Container |
Contient les informations relatives à l'ACL. Nœud parent : AccessControlPolicy. |
|
AccessControlPolicy |
Container |
Contient la réponse GetBucketACL. Nœud parent : aucun. |
|
DisplayName |
String |
Nom du propriétaire du bucket, qui correspond actuellement à l'ID utilisateur. Nœuds parents : AccessControlPolicy et Owner. |
|
Grant |
Enumeration |
ACL du bucket. Valeurs valides : private, public-read et public-read-write. Nœuds parents : AccessControlPolicy et AccessControlList. |
|
ID |
String |
ID utilisateur du propriétaire du bucket. Nœuds parents : AccessControlPolicy et Owner. |
|
Owner |
Container |
Contient les informations relatives au propriétaire du bucket. Nœud parent : AccessControlPolicy. |
Exemples
Exemple de requête
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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemple de réponse
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 OSS
Les SDK OSS suivants prennent en charge GetBucketAcl :
ossutil
Pour plus d'informations sur la commande ossutil correspondant à l'opération GetBucketAcl, consultez la rubrique get-bucket-acl.
Codes d'erreur
|
Error code |
HTTP status code |
Description |
|
NoSuchBucket |
404 |
Le bucket spécifié n'existe pas. |
|
AccessDenied |
403 |
Vous n'êtes pas autorisé à interroger l'ACL du bucket. Seul le propriétaire du bucket peut effectuer cette opération. |