Get Access Permission for an Object
Updated at：2025-11-03
API description
This command retrieves the access permissions of an object.
Request URI
GET /v1/{bucketName}/{objectKey}?acl
| Parameter name | Parameter type | Required or not | Description | Example value | Parameter location |
|---|---|---|---|---|---|
| bucketName | String | Yes | Bucket name | "bucketName_example" | Path |
| objectKey | String | Yes | Object name | "objectKey_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 |
|---|---|---|---|
| accessControlList | List |
ACL (Access Control List) |
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 |
Description of Grantee field data structure
| Parameter name | Parameter type | Description | Example value |
|---|---|---|---|
| id | String | Authorized user ID | 8c47a952db4444c5a097b41be3f24c94 |
Request example
JSON
1GET /v1/bucketName_example/objectKey_example?acl
2 <Common request headers>
3{ }Response example
JSON
1HTTP/1.1 200 OK
2 <Common response headers>
3{
4 "accessControlList" : [ {
5 "grantee" : [ {
6 "id" : "8c47a952db4444c5a097b41be3f24c94"
7 }, {
8 "id" : "8c47a952db4444c5a097b41be3f24c94"
9 } ],
10 "permission" : [ "FULL_CONTROL", "FULL_CONTROL" ]
11 }, {
12 "grantee" : [ {
13 "id" : "8c47a952db4444c5a097b41be3f24c94"
14 }, {
15 "id" : "8c47a952db4444c5a097b41be3f24c94"
16 } ],
17 "permission" : [ "FULL_CONTROL", "FULL_CONTROL" ]
18 } ]
19}Error code
Please refer to the general error codes