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:date
Authorization: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>