Get Bucket Acl

2023-02-19 18:24:41

Get Bucket Acl

返回存储桶的访问控制列表 (ACL)。

请求语法

GET /?acl HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com

URI 请求参数

名称 描述 类型
Bucket 存储桶名称 字符串

请求消息头

该请求没有请求消息头。


请求正文

该请求没有请求正文。


请求元素

该请求没有请求元素。


响应语法

HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<AccessControlPolicy>
   <Owner>
      <DisplayName>string</DisplayName>
      <ID>string</ID>
   </Owner>
   <AccessControlList>
      <Grant>
         <Grantee>
            <DisplayName>string</DisplayName>
            <ID>string</ID>
         </Grantee>
         <Permission>string</Permission>
      </Grant>
   </AccessControlList>
</AccessControlPolicy>

响应元素

名称 描述 类型
Owner 所有者信息 容器
Owner.DisplayName 所有者ID 字符串
Owner.ID 所有者ID 字符串
AccessControlList 访问控制列表,包含Grant、 Grantee、Permission三个元素。 容器
AccessControlList.Grant 用于标记用户及用户的权限。单个桶的ACL,Grant元素不能超过100个。 容器
AccessControlList.Grant.Grantee 记录用户信息 容器
AccessControlList.Grant.Grantee.DisplayName 用户ID 字符串
AccessControlList.Grant.Grantee.ID 用户ID 字符串
AccessControlList.Grant.Permission 授予的权限
取值范围:private、public-read、public-read-write
字符串

响应消息头

该请求没有响应消息头。


示例

请求示例

GET /?acl HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230117/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=411c288058e62dd68f477a050933cd55c2975814064cec09462dd65a5e4ee15b
Content-length: 0
Host: bucket.s3-us-east-1.ossfiles.com
X-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-amz-date: 20230117T035803Z

返回示例

HTTP/1.1 200 OK
Content-length: 460
Content-type: application/xml
Date: Tue, 17 Jan 2023 03:58:04 GMT
x-amz-id-2: c3f6b04ff73340d8900d5442e2dc3ec3
x-amz-request-id: 6662369f32144482820f05af17a0b23c

<?xml version="1.0" encoding="UTF-8"?>
<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Owner>
        <ID>c2287ffd54231d96dfdfe69e798965ca</ID>
        <DisplayName>c2287ffd54231d96dfdfe69e798965ca</DisplayName>
    </Owner>
    <AccessControlList>
        <Grant>
            <Grantee>
                <ID>c2287ffd54231d96dfdfe69e798965ca</ID>
                <DisplayName>c2287ffd54231d96dfdfe69e798965ca</DisplayName>
            </Grantee>
            <Permission>public-read-write</Permission>
        </Grant>
    </AccessControlList>
</AccessControlPolicy>