View source

return the access control list (ACL) of an object

'''GET''' /''ObjectName''?acl

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

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

 DELETE /''ObjectName'' 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]]