GET Bucket acl¶
After being granted READ_ACP or FULL_CONTROL permission for a bucket, you can obtain its ACL.
Request Syntax¶
GET /?acl HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: authorization
Request Parameters¶
This request involves no parameters.
Request Headers¶
This request uses common headers. For details about common request headers, see section Common Request Headers.
Request Elements¶
This request involves no elements.
Response Syntax¶
HTTP/1.1 status_code
Server: Server Name
x-amz-request-id: request id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: id
Content-Type: type
Date: date
Content-Length: length
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessControlPolicy xmlns="http://obs.example.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 about common response headers, see section Common Response Headers.
Response Elements¶
This response contains elements to provide details about a bucket ACL. Table 1 describes the elements.
Element | Description |
|---|---|
Owner | Indicates the bucket owner. Type: XML |
ID | DomainId of the user. Type: String |
DisplayName | Indicates the user name. Type: String |
AccessControlList | Indicates the ACL that records all users who have permission to access the bucket and permission granted to the users. Type: XML |
Grant | Container for the grantee and its permission. Type: XML |
Grantee | 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.
Sample Request¶
GET /?acl HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept-Encoding: gzip,deflate
Date: Mon, 27 Sep 2010 01:22:05 GMT
Authorization: AWS 04RZT432N80TGDF2Y2G2:FAcC4bDx0izVL9lEH521v01in/Y=
Sample Response¶
HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: 7B6DFC9BC71DD58B061285550689635
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: N0I2REZDOUJDNzFERDU4QjA2MTI4NTU1MDY4OTYzNUFBQUFBQUFBYmJiYmJiYmJD
Content-Type: application/xml
Date: Mon, 27 Sep 2010 01:24:47 GMT
Content-Length: 560
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessControlPolicy xmlns="http://obs.example.com/doc/2015-06-30/">
<Owner>
<ID>bcaf1ffd86f41caff1a493dc2ad8c2c281e37522a640e161ca5fb16fd081034f</ID>
<DisplayName>apple</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser"> <ID>bcaf1ffd86f41caff1a493dc2ad881e37540e161ca5fb16fd081034f</ID>
<DisplayName>apple</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>