Get Bucket ACL

Last Updated: Mar 20, 2017

Get Bucket ACL is used to obtain the access permissions for a bucket.

Request syntax

  1. GET /?acl HTTP/1.1
  2. Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  3. Date: GMT Date
  4. Authorization: SignatureValue

Response elements

Name Description
AccessControlList Container used for storing the ACL information
Type: container
Parent node: AccessControlPolicy
AccessControlPolicy Specify the container that stores the Get Bucket ACL result
Type: container
Parent node: none
DisplayName Name of the bucket owner. (Consistent with the ID at present)
Type: string
Parent node: AccessControlPolicy.Owner
Grant ACL permissions of the bucket.
Type: enumerative string
Valid values: private,public-read,public-read-write
Parent node: AccessControlPolicy.AccessControlList
ID User ID of the bucket owner
Type: string
Parent node: AccessControlPolicy.Owner
Owner Container used for saving the information about the bucket owner.
Type: container
Parent node: AccessControlPolicy

Detail analysis

  1. Only the bucket owner can use the Get Bucket ACL interface.

Example

Request example:

  1. GET /?acl HTTP/1.1
  2. Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  3. Date: Fri, 24 Feb 2012 04:11:23 GMT
  4. Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:CTkuxpLAi4XZ+WwIfNm0FmgbrQ0=

Response example:

  1. HTTP/1.1 200 OK
  2. x-oss-request-id: 534B371674E88A4D8906008B
  3. Date: Fri, 24 Feb 2012 04:11:23 GMT
  4. Content-Length: 253
  5. Content-Tupe: application/xml
  6. Connection: keep-alive
  7. Server: AliyunOSS
  8. <?xml version="1.0" ?>
  9. <AccessControlPolicy>
  10. <Owner>
  11. <ID>00220120222</ID>
  12. <DisplayName>user_example</DisplayName>
  13. </Owner>
  14. <AccessControlList>
  15. <Grant>public-read</Grant>
  16. </AccessControlList>
  17. </AccessControlPolicy>
Thank you! We've received your feedback.