返回对象的访问控制列表 (ACL)。
GET /{Key+}?acl HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com
名称 | 描述 | 类型 |
---|---|---|
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>