S3 Bucket Acl Operations:Get Bucket ACL

Search (SHIFT+S)




Get Bucket ACL

GET /?acl

Gets the ACL of a bucket.

URL Format

Host Style: http://bucketname.ns1.emc.com/?acl
Path Style: http://ns1.emc.com/bucketname?acl

Request Headers

x-amz-date optionalTimestamp of the request added by the requester. Example: Tue, 03 Sept 2013 12:00:00 GMT. If the Authorization header is specified, you must specify either the x-amz-date or the Date header. If both the headers are specified, the value of the x-amz-date header is chosen.
Authorization requiredInformation needed to authenticate requests.

Prerequisites

The following conditions must be met in order to call this operation.

  • User must have READ_ACP permission or be the owner of the bucket.

  • BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

  • Namespace corresponding to this bucket should exist (for example, ns1).


Response Body

Field Description Type Notes
<AccessControlPolicy>
<Owner>    
<ID> The ID of the bucket owner String
<DisplayName> Screen name of the owner of the bucket. String
</Owner>      
<AccessControlList> Contains information about Grant, Grantee and the Permission
<Grant>     0-* Elements
<Grantee> Individual whose permissions are to be set.
<Permission> Specifies the permission being given to the grantee
</Grant>      
</AccessControlList>
</AccessControlPolicy>
Notes: