GetBucketAcl用來獲取某個Bucket的存取權限。

請求文法

GET /?acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

響應元素(Response Elements)

表 1. 響應元素
名稱 類型 描述
AccessControlList 容器 儲存ACL資訊的容器類。

父節點:AccessControlPolicy

AccessControlPolicy 容器 保存Get Bucket ACL結果的容器。

父節點:None

DisplayName 字元串 Bucket擁有者的名稱(目前和ID一致)。

父節點:AccessControlPolicy.Owner

Grant 枚舉字元串 Bucket的ACL許可權。

有效值:privatepublic-readpublic-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>