Get Object Acl

2023-02-19 18:48:22

Get Object Acl

返回对象的访问控制列表 (ACL)。

请求语法

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

URI 请求参数

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

请求消息头

该请求没有请求消息头。


请求正文

该请求没有请求正文。


请求元素

该请求没有请求元素。


响应语法

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 授予的权限
取值范围:FULL_CONTROL
字符串

响应消息头

该请求没有响应消息头。


示例

请求示例

GET /my-image.jpg?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=ae1fa0bdf20c00cf943df38c21f7a2fbd2ba6a84bf036b68ffa1cb30b8e6d3ed
Content-length: 0
Host: bucket.s3-us-east-1.ossfiles.com
X-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-amz-date: 20230117T063615Z

返回示例

HTTP/1.1 200 OK
Content-type: application/xml
Date: Tue, 17 Jan 2023 06:36:17 GMT
x-amz-id-2: fcbd0de4913e4b8a9e3fc62fc595ca43
x-amz-request-id: ded7dde00b584aad80ee13f13df5c483
 
<AccessControlPolicy>
  <Owner>
	<ID>2421a691b4ed625de19f6f92677b6459</ID>
	<DisplayName>2421a691b4ed625de19f6f92677b6459</DisplayName>
  </Owner>
  <AccessControlList>
	<Grant>
	 <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	   <ID>2421a691b4ed625de19f6f92677b6459</ID>
	   <DisplayName>2421a691b4ed625de19f6f92677b6459</DisplayName>
	  </Grantee>
	  <Permission>FULL_CONTROL</Permission>
   </Grant>
  </AccessControlList>
</AccessControlPolicy>