Get Bucket Acl

Get Bucket Acl

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

请求语法

登录后复制GET /?acl HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com

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>

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

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>

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>