View source

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

'''GET''' /?acl

== 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.

== 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.

== Examples ==
; Sample Request 

 GET /?acl HTTP/1.1
 Host: ''BucketName''.hs2.hostway.com
 Date: ''date''
 Authorization: AWS ''signatureValue''

; Sample Response
 <nowiki>
<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>
 </nowiki>

[[Category:Hostway API]]
[[Category:Hostway Simple Storage API]]