GET Object ACL

描述

此GET操作使用 acl 子资源来返回 object 的 ACL(access control list)。
只有bucket的所有者拥有调用该接口的权限。

请求

语法

GET /{ObjectKey}?acl HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

注意：

• endpoint与Region对应关系
• SignatureValue签名算法

请求参数

该接口不使用请求参数。

请求头部

该接口可以使用所有常用请求头部。获取更多信息，请点击常用请求头部。

请求内容

该接口不使用请求内容。

响应

响应头部

该接口可以使用所有常用响应头部。获取更多信息，请点击常用响应头部。

响应内容

名称	描述
AccessControlList	包含 Grant,Grantee,Permission 的容器 类型：Container 父节点：AccessControlPolicy
AccessControlPolicy	包含了每一个 Grantee 对于某个对象的 ACL 权限设置信息 类型：Container 父节点：无
Grant	包含被授权者和其权限信息。 类型：String 父节点：AccessControlPolicy.AccessControlList
Grantee	被授权者 类型：String 父节点：AccessControlPolicy.AccessControlList.Grant
DisplayName	Bucket拥有者的名称 类型：String 父节点：AccessControlPolicy.Owner
ID	Bucket拥有者的用户ID，或者是被授权者的ID 类型：String 父节点：AccessControlPolicy.Owner 或者 AccessControlPolicy.AccessControlList.Grant
Owner	包含bucket拥有者信息（DisplayName,ID）的容器 类型：Container 父节点：AccessControlPolicy
Permission	指明授予被授权者的权限信息（FULL_CONTROL,READ,WRITE） 类型：String 父节点：AccessControlPolicy.AccessControlList.Grant

特殊错误

该接口不返回任何特殊错误。

示例

下面的请求将会返回相应object的 ACL 信息, my-image.jpg。

请求示例

GET /my-image.jpg?acl HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Fri, 26 Dec 2014 07:14:18 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Fri, 26 Dec 2014 07:14:18 GMT
Last-Modified: Sun, 1 Jan 2009 12:00:00 GMT
Content-Length: 124
Content-Type: text/plain
Connection: close
Server: Tengine

<AccessControlPolicy>
<Owner>
<ID>73410125</ID>
<DisplayName>[email protected]</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>73404060</ID>
<DisplayName>[email protected]</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>