PUT Bucket ACL
The PUT Bucket ACL operation sets permissions on an existing bucket using the access control list (ACL).
Note:
For further details about managing access permissions using ACLs, see Controlling Access to Resources Using S3 ACLs.Request Parameters
This implementation of the PUT Bucket ACL operation does not support the use of request parameters.
Request Headers
The PUT Bucket ACL operation supports the following type of request headers.
-
Common request headers. For more details, see table "Common Supported Request Headers" in Supported Common Request Headers.
-
Canned ACL and Grantee Permission request headers. For more details, see PUT Bucket acl.
Request Elements
The PUT Bucket ACL operation only supports the use of request elements when using a request body to specify an ACL. For a description of supported request elements, see PUT Bucket acl.
Response Headers
The PUT Bucket ACL operation uses only response headers that are common to most responses. For more information, see table "Supported Response Headers" in Supported Common Response Headers.
Response Elements
This implementation of the PUT Bucket ACL operation does not return response elements.
Error Response Code
The PUT Bucket ACL operation returns special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.
Example
PUT ?acl HTTP/1.1
Content-Length: 1660
x-amz-date: Thu, 12 Apr 2018 20:04:21 GMT
Authorization: authorization string
<AccessControlPolicy>
<Owner>
<ID>bob</ID>
<DisplayName>bob</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xsi:type="CanonicalUser">
<ID>bill</ID>
<DisplayName>bill</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI xmlns="">http://acs.amazonaws.com/groups/global/AllUsers</URI>
</Grantee>
<Permission xmlns="">READ</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>