GET Bucket ACL

The GET Bucket ACL operation returns the access control list (ACL) of a bucket. To use GET to return the ACL of the bucket, you must have READ_ACP access to the bucket.

Syntax Example

GET https://appliance:443/s3/v1/export/share_mount_point_path/bucket_name?acl

Request Parameters

The GET Bucket ACL operation does not support the use of request parameters.

Request Headers

The GET Bucket ACL operation uses only request headers that are common to all operations. For more information, see table "Common Supported Request Headers" in Supported Common Request Headers.

Request Elements

The GET Bucket ACL operation does not support the use of request elements.

Response Headers

The GET 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

For a list of supported elements in the XML response for the GET Bucket ACL operation, see GET Bucket acl.

Normal Response Code

200

Error Response Code

The GET Bucket API return special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

GET ?acl
HTTP/1.1 200 OK
x-amz-request-id: tx318BC8BC148832E5
Date: Wed, 28 Oct 2009 22:32:00 GMT
Last-Modified: Sun, 1 Jan 2018 12:00:00 GMT
Content-Length: 124
Content-Type: text/plain
Server: Apache

<AccessControlPolicy>
  <Owner>
    <ID>john</ID>
    <DisplayName>mary</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xsi:type="CanonicalUser">	
        <ID>jane</ID>
        <DisplayName>Bob</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>