• S3 Object ACL

Set Object ACL

Sets the ACL of an object or a version of an object. The original ACL is replaced.

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.

Request Headers

x-amz-acl	optional	Used to specify the canned ACL for the object you are creating. Valid Values: private, public-read, public-read-write, authenticated-read, bucket-owner-read, bucket-owner-full-control
x-amz-grant-read	optional	Allows grantee to read the object data and metadata
x-amz-grant-read-acp	optional	Allows grantee to read the object ACL
x-amz-grant-write-acp	optional	Allows grantee to write the ACL for the object
x-amz-grant-full-control	optional	Allows grantee the READ, READ_ACP, and WRITE_ACP permissions on the object

---

Prerequisites

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

• User should have WRITE_ACP permission for 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 and bucket corresponding to this object should exist

---

Request Payload

Table XML

<AccessControlPolicy>
   <Owner>
      <ID></ID>
      <DisplayName></DisplayName>
   </Owner>
   <AccessControlList>
      <Grant>
         <Grantee>
            <ID></ID>
         </Grantee>
         <Permission></Permission>
      </Grant>
   </AccessControlList>
</AccessControlPolicy>

Not Supported

---

Response Body

Response indicating Success or Failure to set object ACL