Get Access Permission for a Bucket
Updated at：2025-11-03
API description
This API retrieves a bucket’s access permissions.
Online debugging
Request URI
GET /v1/{bucketName}/?acl
| Parameter name | Parameter type | Required or not | Description | Example value | Parameter location |
|---|---|---|---|---|---|
| bucketName | String | Yes | Bucket name | "bucketName_example" | Path |
Parameters of request body
Description of the data structure of request body fields
Response body parameters
Description of the data structure of response body fields
| Parameter name | Parameter type | Description | Example value |
|---|---|---|---|
| owner | Owner | Bucket owner information | |
| accessControlList | List |
Container for storing ACL |
Description of Owner field data structure
| Parameter name | Parameter type | Description | Example value |
|---|---|---|---|
| id | String | Owner user ID | 16df583fe6824d73a5f858f06de0af03 |
Description of AccessControlList field data structure
| Parameter name | Parameter type | Description | Example value |
|---|---|---|---|
| grantee | List |
An authorized person | |
| permission | List |
Permissions include: FULL_CONTROL, READ, WRITE, LIST, MODIFY, GetObject, PutObject, DeleteObject, RestoreObject, etc. |
Description of Grantee field data structure
| Parameter name | Parameter type | Description | Example value |
|---|---|---|---|
| id | String | Authorized user ID | 10eb6f5ff6ff4605bf044313e8f3ffa5 |
Request example
JSON
1GET /v1/bucketName_example/?acl
2 <Common request headers>
3{ }Response example
JSON
1HTTP/1.1 200 OK
2 <Common response headers>
3{
4 "owner" : {
5 "id" : "16df583fe6824d73a5f858f06de0af03"
6 },
7 "accessControlList" : [ {
8 "grantee" : [ {
9 "id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
10 }, {
11 "id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
12 } ],
13 "permission" : [ "FULL_CONTROL", "FULL_CONTROL" ]
14 }, {
15 "grantee" : [ {
16 "id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
17 }, {
18 "id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
19 } ],
20 "permission" : [ "FULL_CONTROL", "FULL_CONTROL" ]
21 } ]
22}Error code
Please refer to the general error codes