GET Bucket ACL¶

The GET Bucket ACL operation returns a bucket’s access control list (ACL) settings.

Requests¶

Syntax¶

GET /?acl HTTP/1.1
Host: {{BucketName}}.{{StorageService}}.com
Date: {{date}}
Authorization: {{authenticationInformation}}

Parameters¶

The GET Bucket ACL operation does not use request parameters.

Headers¶

The GET Bucket ACL operation uses only request headers common to all operations (see Common Request Headers).

Elements¶

The GET Bucket ACL operation does not use request elements.

Responses¶

Headers¶

The GET Bucket ACL operation uses only response headers that are common to all operations (refer to Common Response Headers).

Elements¶

The GET Bucket ACL operation can return the following XML elements in its response (includes XML containers):

Element	Type	Description
`AccessControlList`	container	Container for ACL information
`AccessControlPolicy`	container	Container for the response
`DisplayName`	string	Bucket owner’s display name; returned only if the owner’s e-mail address (or the forum name, if configured) can be determined from the ID.
`Grant`	container	Container for Grantee and Permission
`Grantee`	container	Container for DisplayName and ID of the person being granted permissions
`ID`	string	Bucket owner’s user ID
`Owner`	container	Container for bucket owner information
`Permission`	string	Permission given to the Grantee for bucket Valid Values: `FULL_CONTROL` \| `WRITE` \| `WRITE_ACP` \| `READ` \| `READ_ACP`

Examples¶

Getting the ACL of the Specified Bucket¶

Request Sample¶

GET ?acl HTTP/1.1
Host: {{bucketName}}.{{storageService}}.com
Date: Wed, 28 Oct 2009 22:32:00 GMT
Authorization: {{authorizationString}}

Response Sample¶

HTTP/1.1 200 OK
x-amz-id-2: eftixk72aD6Ap51TnqcoF8eFidJG9Z/2mkiDFu8yU9AS1ed4OpIszj7UDNEHGran
x-amz-request-id: 318BC8BC148832E5
Date: Wed, 04 Sep 2019 21:22:00 GMT
Last-Modified: Sun, 1 Jan 2006 12:00:00 GMT
Content-Length: 124
Content-Type: text/plain
Connection: close
Server: ScalityS3

<AccessControlPolicy> xmlns="http://example.com/doc/2006-03-01/">
  <Owner>
    <ID>8b27d4b0fc460740425b9deef56fa1af6245fbcccdda813b691a8fda9be8ff0c</ID>
    <DisplayName>user@example.com</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>8b27d4b0fc460740425b9deef56fa1af6245fbcccdda813b691a8fda9be8ff0c</ID>
        <DisplayName>user@example.com</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>