Oracle^® ZFS Storage Appliance Object API Guide for Amazon S3 Service Support, Release OS8.8.0

PUT Bucket ACL

The PUT Bucket ACL operation sets permissions on an existing bucket using the Access Control List (ACL). For more details about this operation, see the following:

• Syntax Example

• Request Parameters

• Request Headers

• Request Elements

• Response Headers

• Response Elements

• Error Response Code

Syntax Example

PUT https://<appliance>:443/s3/v1/export/<share_mount_point_path>/<bucketname>?acl

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. For more information, see Figure 7, Table 7, Common Supported Request Headers .

• Common request headers – For more details, see Figure 7, Table 7, Common Supported Request Headers .

• Canned ACL and Grantee Permission request headers – For more details, see Amazon's official PUT Bucket ACL documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html).

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 Amazon's official PUT Bucket ACL documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html).

Response Headers

The PUT Bucket ACL operation uses only response headers that are common to most responses. For more information, see Figure 9, Table 9, Supported 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>