S3 Object Acl Operations:Set Object ACL

Search (SHIFT+S)




Set Object ACL

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

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.

Request Headers

x-amz-acl optionalUsed 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 optionalAllows grantee to read the object data and metadata
x-amz-grant-read-acp optionalAllows grantee to read the object ACL
x-amz-grant-write-acp optionalAllows grantee to write the ACL for the object
x-amz-grant-full-control optionalAllows 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

No Request Payload


Response Body

Response indicating Success or Failure to set object ACL

Notes: