获取对象的权限

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

请求

  • 请求语法

    • 内容

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

    • 描述

        Endpoint：参考与region地域的关系
  SignatureValue：参考签名算法

  • 请求参数

    无

  • 非公共请求头

    无

  • 请求体

    无

响应

  • 非公共响应头

    无

  • 响应体

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

示例

  • 请求

      GET /my-image.jpg?acl HTTP/1.1
  Host: oss-example.oss-cn-beijing.inspurcloud.com
  Date: Fri, 26 Dec 2014 06:34:32 GMT
  Authorization: authorization string

  • 响应

      <AccessControlPolicy>
      <Owner>
          <ID>73410125</ID>
              <DisplayName>123@163.com</DisplayName>
      </Owner>
  <AccessControlList>
  <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
          <ID>73404060</ID>
          <DisplayName>123@163.com </DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
  </Grant>
  </AccessControlList>
  </AccessControlPolicy>:

错误码

错误码 描述 状态码 描述
... ... ... ...