接口描述

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

请求（Request）

• 请求语法

      PUT / HTTP/1.1
      Host: <BucketName>.bj.bcebos.com
      Date: <Date>
      Authorization: <AuthorizationString>
      Content-Length: <ContentLength>
      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之间。

示例

• 请求示例

     PUT / HTTP/1.1
     Host: <BucketName>.bj.bcebos.com
     Date: Wed, 06 Apr 2016 06:34:40 GMT
     Authorization: <AuthorizationString>
     Content-Type:text/plain
     Content-Length: 0
     
     {
         "enableMultiAz":true,
     }

• 响应示例

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