调用GetBucketAcl用于获取某个存储空间的访问权限

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的访问权限。