GET Bucket acl

Latest revision as of 13:36, 30 May 2016

Returns the access control list (ACL) of a bucket.

GET /?acl

[edit] Requests

Syntax

GET /?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

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

GET /?acl 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>