GET object ACL

描述

此GET操作使用 acl 子资源来返回 object 的 ACL(access control list)。

只有bucket的所有者拥有调用该接口的权限。

请求

语法

GET /{ObjectKey}?acl HTTP/1.1
Host: {BucketName}.kss.ksyun.com
Date: date
Authorization: authorization string

请求参数

该接口不使用请求参数。

请求头部

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

请求内容

该接口不使用请求内容。

响应

响应头部

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

响应内容

名称	描述
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: bucket.kss.ksyun.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>NzM0MDAyMjE=</ID>
    <DisplayName>NzM0MDAyMjE=</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>NzM0MDAyMjE=</ID>
        <DisplayName>NzM0MDAyMjE=</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

GET Object acl

描述

请求

语法