GET Bucket acl

Returns the access control list (ACL) of a bucket.

READ_ACP access is required to return the ACL of a bucket. Authorization headers are not required if the anonymous user is granted READ_ACL privileges.

Request syntax

GET /?acl HTTP/1.1
Host: BucketName.rs2.StorageService.com
Date: date
Authorization: signatureValue

Request headers

You can use the following request headers with the GET Bucket acl operation:
Authorization, Content-Length, Content-Type, Date, and Host.

The Authorization and Date headers are required; the others are optional.
For more information, see Request Headers.

Response headers

Response headers in a GET Bucket acl operation may include: Content-Length, Connection, Date, ETag, and Server. 

For more information, see Response Headers.

Response elements

The GET Bucket acl operation returns the following items (item datatypes in parentheses):

Examples

Request sample

This sample gets the ACL list of the backup bucket:

GET /?acl HTTP/1.1
Host: backup.demo.cloud.it
Date: Thu, 16 Jun 2011 15:14:47 GMT
Authorization: AWS pat:1BmcoCK2KNzgdRRF0srqcStwX3g=
Response sample
<?xml version="1.0" encoding="UTF-8"?>
<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Owner>
    <ID>3452783832C94517345278000000004000000120</ID>
    <DisplayName>Patrick</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlnssi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>3452783832C94517345278000000004000000120</ID>
        <DisplayName>Patrick</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>