接口描述

本接口用于设置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）

• 响应头域

  无特殊Header参数返回

• 响应元素

  无

注意事项

1. 只有Bucket的拥有者和被授予FULL_CONTROL权限的用户才能设置Bucket的ACL权限。
2. 在创建Bucket时，Bucket权限会默认设置为private。

示例

• 使用CannedAcl的请求示例

  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

• 上传ACL文件的示例

  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                  "id":"168bf6fd8fa74d9789f35a283a1f15e2"
  13                }],
  14                "permission":["READ"]
  15          }
  16     ]
  17}

• 响应示例

  Plain Text 复制

  1HTTPS/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