接口描述

本接口用于创建Bucket。每一个用户只允许创建100个Bucket。创建的Bucket其权限默认为private，即Bucket Owner获得FULL_CONTROL，其他人没有任何权限。

请求（Request）

• 请求语法

  Plain Text 复制

  1    PUT / HTTP/1.1
  2    Host: <BucketName>.bj.bcebos.com
  3    Date: <Date>
  4    Authorization: <AuthorizationString>
  5    Content-Length: <ContentLength>
  6    Content-Type: text/plain

• 请求头域

  名称	类型	描述	是否必须
  x-bce-tag-list	string	创建bucket时为bucket绑定tag，格式为tag1=value1&tag2=value2	否

• 请求参数

  名称	类型	描述	是否必须
  enableMultiAZ	Boolean	指定创建的Bucket中数据是否多AZ分布，达到机房级别的数据容灾，true代表创建多AZ bucket，默认为false代表创建。	否

响应（Response）

• 响应头域

  无特殊Header参数返回

• 响应元素

  无

注意事项

• 若一个用户创建的Bucket超过100个，服务将返回400 Bad Request，错误码TooManyBuckets。
• 若请求的Bucket已存在，无论该Bucket是否是请求者创建，都会返回409 Conflict，错误信息：BucketAlreadyExists。
• 创建数据多AZ分布的bucket的前提是该region已经支持创建多AZ的bucket，目前BOS仅支持北京、广州和苏州三个region，其它region陆续开通中。
• BOS存储桶名称存在限制，只能包含小写字母、数字和“-”，开头结尾为小写字母和数字，长度在4-63之间。

示例

• 请求示例

  Plain Text 复制

  1   PUT / HTTP/1.1
  2   Host: <BucketName>.bj.bcebos.com
  3   Date: Wed, 06 Apr 2016 06:34:40 GMT
  4   Authorization: <AuthorizationString>
  5   Content-Type:text/plain
  6   Content-Length: 0
  7   
  8   {
  9       "enableMultiAz":true,
  10   }

• 响应示例

  Plain Text 复制

  1   HTTP/1.1 200 OK
  2   x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
  3   Date: Wed, 06 Apr 2016 06:34:40 GMT
  4   Location: bj
  5   Content-Length: 0
  6   Connection: close
  7   Server: BceBos