Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




Get Object ACL

GET /{object_name}?acl[&versionId={version_id}]

Gets the Access Control List(ACL) of an object.

URL Format

Host Style: http://bucketname.ns1.emc.com/{object_name}?acl[&versionId={version_id}]
Path Style: http://ns1.emc.com/bucketname/{object_name}?acl[&versionId={version_id}]

Alternatively, both styles can specify the namespace using the x-emc-namespace header.
Owner in the payload refers to the object owner.


Prerequisites

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

  • User should have READ_ACP permission

  • 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 and bucket corresponding to this object should exist


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