文档中心

GET Bucket acl


描述

此GET操作使用 acl 子资源来返回 bucketACL(access control list)。 即用户空间的访问权限控制列表。 使用此接口,只有bucket的所有者有权限操作。

请求

语法

GET /?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。
类型:String
父节点:AccessControlPolicy.Owner
Owner 包含bucket拥有者信息(DisplayName,ID)的容器。
类型:Container
父节点:AccessControlPolicy
Permission 指明授予被授权者的权限信息(FULL_CONTROL,READ,WRITE)。
类型:String
父节点:AccessControlPolicy.AccessControlList.Grant

特殊错误

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

示例

请求示例

GET /?acl HTTP/1.1
Host: kss.ksyun.com
Date: Wed, 01 Mar  2006 12:00:00 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Wed, 28 Oct 2009 22:32:00 GMT
Last-Modified: Sun, 1 Jan 2006 12:00:00 GMT
Content-Length: 124
Content-Type: text/plain
Connection: close
Server: Tengine

<AccessControlPolicy>
  <Owner>
    <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
    <DisplayName>CustomersName@kingsoft.com</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:type="CanonicalUser">
        <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
        <DisplayName>CustomersName@kingsoft.com</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

接口细节说明

  • 只有bucket的所有者拥有GET Bucket acl的权限