Interface Description
This interface is used to get access control of the bucket.
Request URI
GET /v1/{bucketName}/?acl
| Parameter Name |
Parameter Type |
Required? |
Description |
Example Value |
Parameter Position |
| bucketName |
String |
Yes |
Bucket name |
"bucketName_example" |
Path |
Request Body Parameters
Instructions for Data Structure of Request Body Field
Response Body Parameters
Instructions for Data Structure of Response Body Field
| Parameter name |
Parameter type |
Description |
Example value |
| owner |
Owner |
Bucket owner information |
|
| accessControlList |
List<AccessControlList> |
Container for saving the ACL |
|
Data Structure Description of Owner Field
| Parameter Name |
Parameter type |
Description |
Example value |
| id |
String |
Owner user ID |
16df583fe6824d73a5f858f06de0af03 |
Data Structure Description of AccessControlList Field
| Parameter Name |
Parameter Type |
Description |
Example Value |
| grantee |
List |
Agrantee |
|
| permission |
List |
Authorized permission support：FULL_CONTROL, READ, WRITE, LIST, MODIFY, GetObject, PutObject, DeleteObject, and RestoreObject. |
|
Data Structure Description of Grantee Field
| Parameter Name |
Parameter Type |
Description |
Example Value |
| id |
String |
Authorized user ID |
10eb6f5ff6ff4605bf044313e8f3ffa5 |
Request Example
GET /v1/bucketName_example/?acl
Common Request Header
{ }
Response Example
HTTP/1.1 200 OK
<Common response header>
{
"owner" : {
"id" : "16df583fe6824d73a5f858f06de0af03"
},
"accessControlList" : [ {
"grantee" : [ {
"id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
}, {
"id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
} ],
"permission" : [ "FULL_CONTROL", "FULL_CONTROL" ]
}, {
"grantee" : [ {
"id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
}, {
"id" : "10eb6f5ff6ff4605bf044313e8f3ffa5"
} ],
"permission" : [ "FULL_CONTROL", "FULL_CONTROL" ]
} ]
}
Error Code
Refer to the universal error code.
