PutBucketAcl
更新时间：2026-09-06
接口描述
本接口用于设置 Bucket 的访问权限。目前 BOS 支持两种方式设置 ACL。第一种是使用 CannedAcl，在 PutBucketAcl 的时候，通过头域 x-bce-acl 来设置，当前可设置的权限包括：private、public-read、public-read-write（大小写敏感）。第二种方式是上传一个 ACL 文件，文件格式参见 ACL文件格式。
ACL文件内容可以使用 BOS ACL编辑工具 生成。
注意： BOS系统不支持在同一请求中，同时设置“x-bce-acl”和上传ACL文件。
请求（Request）
Plain Text
1PUT /?acl HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3x-bce-date: <Date>
4Content-Length: <ContentLength>
5Content-Type: application/json; charset=utf-8
6Authorization: <AuthorizationString>
7x-bce-acl: <ACLString>-
请求参数
无特殊参数
-
请求头域
名称 类型 描述 是否必需 x-bce-acl String Bucket设置的ACL权限，支持：private、public-read、public-read-write 否
响应（Response）
注意事项
- 只有 Bucket 的拥有者和被授予
FULL_CONTROL权限的用户才能设置 Bucket 的 ACL 权限。- 在创建 Bucket 时，Bucket 权限会默认设置为
private。
示例
Plain Text
1PUT /?acl HTTP/1.1
2Host: BucketName.bj.bcebos.com
3x-bce-date: 2016-04-06T08:23:49Z
4Authorization: AuthorizationString
5x-bce-acl: public-read
6Content-Type: application/json; charset=utf-8
7Content-Length: 0
Plain Text
1PUT /?acl HTTP/1.1
2Host: BucketName.bj.bcebos.com
3x-bce-date: 2016-04-06T08:23:49Z
4Content-Length: 1324
5Content-Type: application/json; charset=utf-8
6Authorization: AuthorizationString
7
8{
9 "accessControlList": [
10 {
11 "grantee": [
12 {
13 "id": "168bf6fd8fa74d9789f35a283a1f15e2"
14 }
15 ],
16 "permission": [
17 "READ"
18 ]
19 }
20 ]
21}
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
3Content-Length: 0
4Date: Wed, 06 Apr 2016 06:34:40 GMT
5Server: BceBos评价此篇文章