All Documents
Current Document
Content is empty
If you don't find the content you expect, please try another search term
Found 0 result in total
Content is empty
If you don't find the content you expect, please try another search term
Last updated：2021-09-14 16:18:12
This GET operation uses the acl sub resource to return the ACL(access control list)' of the object'.
Only the bucket owner has permission to call the interface.
GET /{ObjectKey}?acl HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}Attention：
The interface does not use request parameters.
This interface can use all common request headers. For more information, please click Public Request Headers.
The interface does not use the requested elements.
This interface can use all common response headers. For more information, please click Public Response Headers.
| Name | Description |
|---|---|
| AccessControlList | Container containing Grant,Grantee,PermissionType：Container Ancestors：AccessControlPolicy |
| AccessControlPolicy | Contains the ACL permission setting information of each Grantee for an objectType：Container Ancestors：None |
| Grant | Contains information about authorized persons and their permissions. Type：String Ancestors:AccessControlPolicy.AccessControlList |
| Grantee | Authorized person Type：String Ancestors：AccessControlPolicy.AccessControlList.Grant |
| DisplayName | Bucket owner's name Type：String Ancestors：AccessControlPolicy.Owner |
| ID | The user ID of the bucket owner or the ID of the authorized person Type：String Ancestors：AccessControlPolicy.Owner or AccessControlPolicy.AccessControlList.Grant |
| Owner | Container containing bucket owner information (DisplayName,ID)Type：Container Ancestors：AccessControlPolicy |
| Permission | Indicates the permission information granted to the authorized person（FULL_CONTROL,READ,WRITE）Type：String Ancestors：AccessControlPolicy.AccessControlList.Grant |
The interface does not return any special errors.
ACL information of the corresponding object, my-image.jpg.Sample Request
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 stringSample Response
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>73410125</ID>
<DisplayName>ks3@kingsoft.com</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>73404060</ID>
<DisplayName>ks3_dt@kingsoft.com</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
Pure Mode