Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




Get Bucket ACL

GET /?acl

Gets the ACL of a bucket.

Owner in the payload refers to the bucket owner.

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 owner String
DisplayName Screen name of the owner. String
AccessControlList Contains information about Grant, Grantee and the Permission
Grant     0-* Elements
Grantee    
ID Specifying permission for the user by ID String
Permission Specifies the permission being given to the grantee