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:03
The GET operation uses the 'ACL' sub resource to return the 'ACL (access control list)' of the 'bucket'. That is, access control list of users bucket. With this interface, only the owner of 'bucket' has permission to operate.
GET /?acl HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignitureValue}Note:
The interface does not use request parameters.
This interface only uses common request headers. For more information, please click Public request headers.
The interface does not use the requested content.
This interface can use all common response headers. For more information, please click Public response headers.
| Name | Description |
|---|---|
| AccessControlList | Container containing Grant,Grantee,Permission.Type: Container Parent node: AccessControlPolicy |
| AccessControlPolicy | Contains the ACL permission setting information of each 'Grantee' for an object. Type: Container Parent node: None |
| Grant | Contains information about authorized persons and their permissions. Type: String Parent node: AccessControlPolicy.AccessControlList |
| Grantee | Authorized person. Type: String Parent node: AccessControlPolicy.AccessControlList.Grant |
| DisplayName | The name of the bucket owner. Type: String Parent node: AccessControlPolicy.Owner |
| ID | The user ID of the bucket owner. Type: String Parent node: AccessControlPolicy.Owner |
| Owner | Container containing bucket owner information （DisplayName,ID）.Type: Container Parent node: AccessControlPolicy |
| Permission | Indicates the permission information granted to the authorized person （FULL_CONTROL,READ,WRITE）.Type: String Parent node: AccessControlPolicy.AccessControlList.Grant |
The interface does not return any special errors.
Request example
GET /?acl HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 01 Mar 2006 12:00:00 GMT
Authorization: authorization stringResponse example
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>73410125</ID>
<DisplayName>ks3@kingsoft.com</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="CanonicalUser">
<ID>73410125</ID>
<DisplayName>ks3@kingsoft.com</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>Pure Mode