GET Bucket ACL

Last updated:2021-09-14 16:18:03

Description

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.

Request

Grammar

GET /?acl HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignitureValue}

Note:

Request parameters

The interface does not use request parameters.

Request header

This interface only uses common request headers. For more information, please click Public request headers.

Request content

The interface does not use the requested content.

Response

Response header

This interface can use all common response headers. For more information, please click Public response headers.

Response content

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

Special errors

The interface does not return any special errors.

Example

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 string

Response 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>[email protected]</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="CanonicalUser">
<ID>73410125</ID>
<DisplayName>[email protected]</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>

Interface details

  • Only the bucket owner has get GET Bucket acl permission

Did you find the above information helpful?

Unhelpful
Mostly Unhelpful
A little helpful
Helpful
Very helpful

What might be the problems?

Insufficient
Outdated
Unclear or awkward
Redundant or clumsy
Lack of context for the complex system or functionality

More suggestions

0/200

Please give us your feedback.

Submitted

Thank you for your feedback.

问题反馈