GetBucketAcl接口用于獲取某個存儲空間(Bucket)的訪問權限(ACL)。只有Bucket的擁有者才能獲取Bucket的訪問權限。
請求語法
GET /?acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
當您在OSS ON云盒中調用該接口時,您需要將Host替換為云盒Endpoint。更多信息,請參見云盒Endpoint。
請求頭
此接口僅涉及公共請求頭。更多信息,請參見公共請求頭(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: Fri, 24 Feb 2012 04:11:23 GMT
Authorization: OSS qn6q**************:77Dv****************
返回示例
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如下:
錯誤碼
錯誤碼 | HTTP 狀態碼 | 描述 |
NoSuchBucket | 404 | 目標Bucket不存在。 |
AccessDenied | 403 | 沒有操作權限。只有Bucket的擁有者才能獲取Bucket的訪問權限。 |
文檔內容是否對您有幫助?