GetBucketAcl用來獲取某個Bucket的存取權限。
請求文法
GET /?acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
響應元素(Response Elements)
名稱 | 類型 | 描述 |
---|---|---|
AccessControlList | 容器 | 儲存ACL資訊的容器類。 父節點:AccessControlPolicy |
AccessControlPolicy | 容器 | 保存Get Bucket ACL結果的容器。 父節點: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 |
細節分析
只有Bucket的擁有者才能使用GetBucketACL這個介面。
樣本
請求樣本:
GET /?acl HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 04:11:23 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:CTkuxpLAi4XZ+WwIfNm0FmgbrQ0=
返回樣本:
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906008B
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>00220120222</ID>
<DisplayName>user_example</DisplayName>
</Owner>
<AccessControlList>
<Grant>public-read</Grant>
</AccessControlList>
</AccessControlPolicy>