PUT Object acl

Latest revision as of 13:36, 30 May 2016

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

PUT /ObjectName?acl

[edit] 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

[edit] 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.

[edit] 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