全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

GET Object ACL

最近更新时间:2022-12-30 15:47:56

描述

此GET操作使用 acl 子资源来返回 objectACL(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

特殊错误

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

示例

下面的请求将会返回相应objectACL 信息, 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>

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈