GET Bucket ACL
The GET Bucket ACL operation returns the access control list (ACL) of a bucket. To use GET
to return the ACL of the bucket, you must have READ_ACP
access to the bucket.
Request Headers
The GET Bucket ACL operation uses only request headers that are common to all operations. For more information, see table "Common Supported Request Headers" in Supported Common Request Headers.
Response Headers
The GET Bucket ACL operation uses only response headers that are common to most responses. For more information, see table "Supported Response Headers" in Supported Common Response Headers.
Response Elements
For a list of supported elements in the XML response for the GET Bucket ACL operation, see GET Bucket acl.
Error Response Code
The GET Bucket API return special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.
Example
GET ?acl HTTP/1.1 200 OK x-amz-request-id: tx318BC8BC148832E5 Date: Wed, 28 Oct 2009 22:32:00 GMT Last-Modified: Sun, 1 Jan 2018 12:00:00 GMT Content-Length: 124 Content-Type: text/plain Server: Apache <AccessControlPolicy> <Owner> <ID>john</ID> <DisplayName>mary</DisplayName> </Owner> <AccessControlList> <Grant> <Grantee xsi:type="CanonicalUser"> <ID>jane</ID> <DisplayName>Bob</DisplayName> </Grantee> <Permission>FULL_CONTROL</Permission> </Grant> </AccessControlList> </AccessControlPolicy>