View source

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

'''PUT''' /''ObjectName''?acl

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

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

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

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