最近更新时间:2022-12-30 15:47:56
此GET操作使用 acl
子资源来返回 object
的 ACL(AccessControlList)
。
使用此接口,必须是bucket
的所有者或具有ks3:GetObjectAcl
权限。
GET /{ObjectKey}?acl HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
注意:
该接口不使用请求参数。
该接口可以使用所有常用请求头部。获取更多信息,请点击常用请求头部。
该接口不使用请求内容。
该接口可以使用所有常用响应头部。获取更多信息,请点击常用响应头部。
名称 | 描述 |
---|---|
AccessControlList | 包含 Grant ,Grantee ,Permission 的容器类型:Container 父节点:AccessControlPolicy |
AccessControlPolicy | 包含了每一个 Grantee 对于某个对象的 ACL 权限设置信息类型:Container 父节点:无 |
Grant | 包含被授权者和其权限信息。 类型:String 父节点:AccessControlPolicy.AccessControlList |
Grantee | 被授权者 类型:String 父节点:AccessControlPolicy.AccessControlList.Grant |
DisplayName | Object拥有者或被授权者用户ID的Base64编码。 类型:String 父节点:AccessControlPolicy.Owner 或者 AccessControlPolicy.AccessControlList.Grant |
ID | Object拥有者或被授权者用户ID的Base64编码。 类型:String 父节点:AccessControlPolicy.Owner 或者 AccessControlPolicy.AccessControlList.Grant |
Owner | 包含bucket拥有者信息(DisplayName ,ID )的容器类型:Container 父节点:AccessControlPolicy |
Permission | 指明授予被授权者的权限信息(FULL_CONTROL ,READ )类型: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: keep-alive
x-kss-request-id: f87d4t80heh8bs7bgdib7no5lm8r92hj
Server: KS3
<AccessControlPolicy>
<Owner>
<ID>NzM0MTAxMjU=</ID>
<DisplayName>NzM0MTAxMjU=</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>NzM0MDQwNjA=</ID>
<DisplayName>NzM0MDQwNjA=</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
纯净模式