PUT Object acl

set the access control list (ACL) permissions for an object that already exists in a bucket.

PUT /ObjectName?acl

Requests

Syntax

PUT /ObjectName?acl HTTP/1.1
Host: BucketName.hs2.hostway.com
Date: date
Authorization: signatureValue

Parameters

This implementation of the operation does not use request parameters.

Headers

• x-amz-acl: The canned ACL to apply to the object.

Elements in body

• AccessControlList: Container for ACL information
• AccessControlPolicy: Contains the elements that set the ACL permissions for an object per Grantee
• DisplayName: Screen name of the bucket owner
• Grant: Container for the grantee and his or her permissions
• Grantee: The subject whose permissions are being set.
• ID: ID of the bucket owner, or the ID of the grantee
• Owner: Container for the bucket owner's display name and ID
• Permission: Specifies the permission given to the grantee

Responses

Headers

This implementation of the operation uses only response headers that are common to most responses

Elements

This implementation of the operation does not return response elements.

Examples

Sample Request

PUT /ObjectName?acl HTTP/1.1
Host: BucketName.hs2.hostway.com
Date: date
Authorization: AWS signatureValue
Content-Length: length

<AccessControlPolicy>
  <Owner>
    <ID>id</ID>
    <DisplayName>email</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>id</ID>
        <DisplayName>email</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

Sample Response

HTTP/1.1 200 OK
Date : date
Connection : keep-alive
Content-Length : 0