GET Bucket acl
Description
This implementation of the GET operation uses the acl sub-resource to return 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. If READ_ACP permission is
granted to the anonymous user, you can return the ACL of the bucket without using an
authorization header.
Requests
Syntax
GET /?acl HTTP/1.1 Host:BucketName.s3.amazonaws.com Date:dateAuthorization:signatureValue
Request Parameters
This implementation of the operation does not use request parameters.
Request Headers
This implementation of the operation only uses request headers common to all operations. For more information, see
Request Elements
This implementation of the operation does not use request elements.
Responses
Response Headers
This implementation of the operation uses only response headers that are common to most responses. For more information, see Common Response Headers.
Response Elements
| Name | Description |
|---|---|
AccessControlList
|
Container for ACL information. Type: Container Ancestry: AccessControlPolicy |
AccessControlPolicy
|
Container for the reponse. Type: Container Ancestry: None |
DisplayName
|
Bucket owner's display name. This is returned only if the
owner's e-mail address (or the forum name, if configured) can be
determined from the Type: String Ancestry: AccessControlPolicy.Owner |
Grant
|
Container for Type: Container Ancestry: AccessControlPolicy.AccessControlList |
Grantee
|
Container for Type: Container Ancestry: AccessControlPolicy.AccessControlList.Grant |
ID
|
Bucket owner's ID. Type: String Ancestry: AccessControlPolicy.Owner |
Owner
|
Container for bucket owner information. Type: Container Ancestry: AccessControlPolicy |
Permission
|
Permission given to the Type: String Valid Values: FULL_CONTROL | WRITE | WRITE_ACP | READ | READ_ACP Ancestry: AccessControlPolicy.AccessControlList.Grant |
Special Errors
This implementation of the operation does not return special errors. For general information about Amazon S3 errors and a list of error codes, see Error Responses.
Examples
Sample Request
The following request returns the ACL of the specified bucket.
GET ?acl HTTP/1.1 Host: bucket.s3.amazonaws.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: AWS 02236Q3V0WHVSRW0EXG2:0RQf4/cRonhpaBX5sCYVf1bNRuU=
Sample Response
HTTP/1.1 200 OK
x-amz-id-2: eftixk72aD6Ap51TnqcoF8eFidJG9Z/2mkiDFu8yU9AS1ed4OpIszj7UDNEHGran
x-amz-request-id: 318BC8BC148832E5
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: AmazonS3
<AccessControlPolicy>
<Owner>
<ID>8a6925ce4adee97f21c32aa379004fef</ID>
<DisplayName>[email protected]</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="CanonicalUser">
<ID>8a6925ce4adf57f21c32aa379004fef</ID>
<DisplayName>[email protected]</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>