GetBucketAcl介面用於擷取某個儲存空間（Bucket）的存取權限（ACL）。
注意事項
擷取某個儲存空間（Bucket）的存取權限（ACL），您必須擁有oss:GetBucketAcl許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。
請求文法
GET /?acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue要求標頭
此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。
響應元素
名稱 | 類型 | 描述 |
AccessControlList | 容器 | 儲存ACL資訊的容器類。 父節點：AccessControlPolicy |
AccessControlPolicy | 容器 | 儲存GetBucketACL結果的容器 父節點：None |
DisplayName | 字串 | Bucket擁有者的名稱（目前和使用者ID一致）。 父節點：AccessControlPolicy.Owner |
Grant | 枚舉字串 | Bucket的ACL許可權。 有效值：private、public-read、public-read-write 父節點：AccessControlPolicy.AccessControlList |
ID | 字串 | Bucket擁有者的使用者ID。 父節點：AccessControlPolicy.Owner |
Owner | 容器 | 儲存Bucket擁有者資訊的容器。 父節點：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>SDK
此介面所對應的各語言SDK如下：
命令列工具ossutil
GetBucketAcl介面所對應的ossutil命令，請參見get-bucket-acl。
錯誤碼
錯誤碼 | HTTP 狀態代碼 | 描述 |
NoSuchBucket | 404 | 目標Bucket不存在。 |
AccessDenied | 403 | 沒有操作許可權。只有Bucket的擁有者才能擷取Bucket的存取權限。 |