GET Object ACL

Latest revision as of 13:36, 30 May 2016

return the access control list (ACL) of an object

GET /ObjectName?acl

[edit] Requests

Syntax

GET /ObjectName?acl HTTP/1.1
Host: BucketName.hs2.hostway.com
Date: date
Authorization: signatureValue
Range:bytes=byte_range

Parameters

This implementation of the operation does not use request parameters.

Headers

This implementation of the operation only uses request headers common to all operations

Elements in body

This implementation of the operation does not use request elements.

[edit] Responses

Headers

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

Elements

• AccessControlList: Container for ACL information.
• AccessControlPolicy: Container for the response.
• DisplayName: Bucket owner's display name.
• Grant: Container for Grantee and Permission.
• Grantee: Container for DisplayName and ID of the person being granted permissions.
• ID: Bucket owner's ID.
• Owner: Container for bucket owner information.
• Permission: Permission given to the Grantee for bucket.

[edit] Examples

Sample Request

DELETE /ObjectName HTTP/1.1
Host: BucketName.hs2.hostway.com
Date: date
Authorization: AWS signatureValue

Sample Response

<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Owner>
    <DisplayName>youngbae.oh@hostwaycorp.com</DisplayName>
    <ID>d45dc7d25125281926cac849e6ae78374f200ee1e8072e389d000026b1899d1a</ID>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <DisplayName>youngbae.oh@hostwaycorp.com</DisplayName>    
        <ID>d45dc7d25125281926cac849e6ae78374f200ee1e8072e389d000026b1899d1a</ID>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>