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
Host: bucketname.obs.cn-north-1.myhwclouds.com
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="http://obs.cn-north-1.myhwclouds.com/doc/2015-06-30/">
    <Owner>
        <ID>id</ID>
        <DisplayName>name</DisplayName>
    </Owner>
    <AccessControlList>
        <Grant>
            <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
                <ID>id</ID>
                <DisplayName>name</DisplayName>
            </Grantee>
            <Permission>permission</Permission>
        </Grant>
    </AccessControlList>
</AccessControlPolicy>

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

Element

Description

Owner

Indicates the bucket owner.

Type: XML

ID

Indicates the domain ID of the user.

Type: string

DisplayName

Indicates the username.

Type: string

AccessControlList

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

Type: XML

Grant

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

Type: XML

Grantee

Indicates the container for the details about the grantee.

Type: XML

Permission

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.

Registration