GetBucketAcl
Updated at:2025-11-03
API description
This API retrieves a bucket’s access permissions.
Request
-
Request syntax
Plain Text1GET /?acl HTTP/1.1 2Host: <BucketName>.bj.bcebos.com 3x-bce-date: <Date> 4Authorization: <AuthorizationString> -
Request headers
No special parameters
-
Request parameters
No special parameters
Response
| Name | Types | Description |
|---|---|---|
| owner | Objcet | Bucket owner information |
| +id | String | Owner user ID |
| accessControlList | Array | Container for storing ACL |
| +grantee | Array | An authorized person |
| ++id | String | Authorized user ID |
| +permission | Array | Permissions include: FULL_CONTROL, READ, WRITE, LIST, MODIFY, GetObject, PutObject, DeleteObject, RestoreObject, etc. |
Example
-
Request example
Plain Text1GET /?acl HTTP/1.1 2Host: BucketName.bj.bcebos.com 3x-bce-date: 2016-04-06T08:23:49Z 4Authorization: AuthorizationString -
Response example
Plain Text1HTTP/1.1 200 OK 2x-bce-acl: public-read 3x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409 4Date: Wed, 06 Apr 2016 06:34:40 GMT 5Server: BceBos 6{ 7 "owner":{ 8 "id":"16df583fe6824d73a5f858f06de0af03" 9 } 10 "accessControlList":[ 11 { 12 "grantee":[{ 13 "id":"168bf6fd8fa74d9789f35a283a1f15e2" 14 }], 15 "permission":["FULL_CONTROL"] 16 }, 17 { 18 "grantee":[{ 19 "id":"10eb6f5ff6ff4605bf044313e8f3ffa5" 20 }], 21 "permission":["READ"] 22 } 23 ], 24}
