この操作を呼び出して、バケットのアクセス制御リスト（ACL）を照会できます。
注意事項
バケットの ACL を照会するには、oss:GetBucketAcl 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。
リクエスト構文
GET /? acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストヘッダー
DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンス要素
要素 | タイプ | 説明 |
AccessControlList | コンテナー | ACL 情報を含むコンテナー。 親ノード：AccessControlPolicy。 |
AccessControlPolicy | コンテナー | GetBucketACL リクエストの結果を含むコンテナー。 親ノード：なし。 |
DisplayName | 文字列 | バケット所有者の名前。現在はユーザー ID と同じです。 親ノード：AccessControlPolicy および Owner。 |
Grant | 列挙型 | バケットの ACL。 有効な値：非公開、公開読み取り、および 公開読み書き。 親ノード：AccessControlPolicy および AccessControlList。 |
ID | 文字列 | バケット所有者のユーザー ID。 親ノード：AccessControlPolicy および Owner。 |
Owner | コンテナー | バケット所有者に関する情報を含むコンテナー。 親ノード：AccessControlPolicy。 |
例
リクエストの例
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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e成功レスポンスの例
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>OSS SDK
さまざまなプログラミング言語に対応する GetBucketAcl 操作の SDK は次のとおりです。
ossutil
GetBucketAcl 操作に対応する ossutil コマンドの詳細については、「get-bucket-acl」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
NoSuchBucket | 404 | 指定されたバケットが存在しないために返されたエラーメッセージ。 |
AccessDenied | 403 | バケットの ACL を照会する権限がないために返されたエラーメッセージ。バケット所有者のみがバケットの ACL を照会できます。 |