功能说明

GetBucketACL接口用于获取桶的访问控制列表。

注意事项

该操作需要READ_ACP权限。需要注意的是，如果设置桶的ACL时以邮箱类型设置，返回结果中将会以对应被授权用户的ID形式出现，即Type不会是AmazonCustomerByEmail，而是CanonicalUser，这种情况会将邮箱信息一并返回。

请求消息样式

GET /{Bucket}?acl HTTP/1.1
Host: xxx.zos.ctyun.cn 
x-amz-date: Date
x-amz-content-sha256: Content-SHA256
Authorization: Auth String

请求消息参数

请求消息头

该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。

请求消息元素

该请求消息中不带消息元素。

响应消息样式

HTTP/1.1 Status Code
x-amz-request-id: Request Id
Content-Type: ContentType
Content-Length: ContentLength
Date: Date
Connection: Keep-Alive

<?xml version="1.0" encoding="UTF-8"?>
<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Owner>
        <ID>string</ID>
        <DisplayName>string</DisplayName>
    </Owner>
    <AccessControlList>
        <Grant>
            <Grantee  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xsi:type=string>
                <ID>string</ID>
                <DisplayName>string</DisplayName>
                <EmailAddress>string</EmailAddress>
                <URI>string</URI>
            </Grantee>
            <Permission>string</Permission>
        </Grant>
    </AccessControlList>
</AccessControlPolicy>

响应消息头

该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。

响应消息元素

表AccessControlPolicy

表Owner

表AccessControlList

表Grant

表Grantee

错误码

请参见调用前必知-错误码-全局错误码。