Get Permission to Access Object
Last Updated：2021-09-13
Interface Description
This command is used to get access control of an object.
Request URI
GET /v1/{bucketName}/{objectKey}?acl
| Parameter Name | Parameter Type | Required? | Description | Example Value | Parameter Position |
|---|---|---|---|---|---|
| bucketName | String | Yes | Bucket name | "bucketName_example" | Path |
| objectKey | String | Yes | Object name | "objectKey_example" | Path |
Request Body Parameters
Description of Data Structure for Request Body Field
Response Body Parameters
Description of Data Structure for Response Body Field
| Parameter Name | Parameter Type | Description | Example Value |
|---|---|---|---|
| accessControlList | List |
Access control list (ACL) |
Data Structure Description of AccessControlList Field
| Parameter Name | Parameter Type | Description | Example Value |
|---|---|---|---|
| grantee | List |
Agrantee | |
| permission | List |
The authorized permission can be FULL_CONTROL and READ. |
Description of Data Structure for Grantee Field
| Parameter Name | Parameter Type | Description | Example Value |
|---|---|---|---|
| id | String | Authorized user name ID | 8c47a952db4444c5a097b41be3f24c94 |
Request Example
GET /v1/bucketName_example/objectKey_example?acl
Common Request Header
{ }Response Example
HTTP/1.1 200 OK
<Common response header>
{
"accessControlList" : [ {
"grantee" : [ {
"id" : "8c47a952db4444c5a097b41be3f24c94"
}, {
"id" : "8c47a952db4444c5a097b41be3f24c94"
} ],
"permission" : [ "FULL_CONTROL", "FULL_CONTROL" ]
}, {
"grantee" : [ {
"id" : "8c47a952db4444c5a097b41be3f24c94"
}, {
"id" : "8c47a952db4444c5a097b41be3f24c94"
} ],
"permission" : [ "FULL_CONTROL", "FULL_CONTROL" ]
} ]
}Error Code
Refer to the universal error code.