GET Bucket ACL

The implementation of a GET ACL operation returns the ACL of a bucket. After being granted the READ_ACP or FULL_CONTROL permission for a bucket, you can obtain its ACL.

Request Syntax

GET /?acl HTTP/1.1
Date: date
Authorization: authorization

Request Parameters

This request contains no parameter.

Request Headers

This request uses common headers. For details, see Common Request Headers.

Request Elements

This request contains no element.

Response Syntax

HTTP/1.1 status_code
Date: date
Content-Length: length
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessControlPolicy xmlns="">
            <Grantee xmlns:xsi="" xsi:type="CanonicalUser">

Response Headers

This response uses common headers. For details, see Common Response Headers.

Response Elements

This response contains elements to provide details about a bucket ACL. Table 1 describes the elements.

Table 1 Response elements




Indicates the bucket owner.

Type: XML


Indicates the domain ID of the user.

Type: string


Indicates the username.

Type: string


Indicates the ACL that records all users who have permissions to access the bucket and the permissions granted to the users.

Type: XML


Indicates the container for the grantee and his or her permissions.

Type: XML


Indicates the container for the details about the grantee.

Type: XML


Indicates the grantee's permission for a bucket.

Type: string

Error Responses

No special errors are returned. For details about error responses, see Table 1.