接口描述

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

可在创建时通过 x-bce-tag-list 头域为 Bucket 绑定标签，通过请求 Body 指定多 AZ、元数据类型等属性。

请求（Request）

• 请求语法

  Plain Text 复制

  1    PUT / HTTP/1.1
  2    Host: <BucketName>.<Region>.bcebos.com
  3    Date: <Date>
  4    Authorization: <AuthorizationString>
  5    Content-Type: application/json;charset=utf-8
  6    Content-Length: <ContentLength>
  7
  8    <RequestBody>

  默认为 virtual-host 寻址，Bucket 名在 Host 中，URI 为 /。path style 寻址下 URI 为 /<BucketName>。

• 请求头域

  除公共请求头域外，本接口支持以下头域：

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

• 请求参数

  无

• 请求 Body 字段

  Body 为 JSON，Content-Type: application/json;charset=utf-8。不需要设置任何属性时可以不带 Body（此时 Content-Length: 0）。

  字段	类型	描述	是否必须
  enableMultiAz	Boolean	指定创建的 Bucket 中数据是否多 AZ 分布，达到机房级别的数据容灾。true 代表创建多 AZ Bucket，false 代表创建单 AZ Bucket。带 Body 时该字段必然出现	否
  lccLocation	String	指定 Bucket 所在的边缘节点位置	否
  enableDedicated	Boolean	是否创建专属 Bucket	否
  metaType	String	Bucket 元数据组织方式，取值 FLAT、HIERARCHY、HIERARCHY_XH	否

  注意事项

  • 字段名是 enableMultiAz（末位小写 z），不是 enableMultiAZ。
  • enableMultiAz 在序列化时不带 omitempty，因此只要携带 Body，该字段就一定出现在 JSON 中（取默认值时为 false）。
  • 标签走 x-bce-tag-list 头域，不进 Body。

响应（Response）

• 响应头域

  除公共响应头域外，本接口返回以下头域：

  名称	类型	描述
  Location	String	新建 Bucket 所在的 region，如 bj

• 响应元素

  无

参数校验规则

• 客户端校验

  校验项	规则	不满足时的表现
  Bucket 名称	匹配 ^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$，即只含小写字母、数字和 -，首尾为小写字母或数字，长度 3~63	本地报错 invalid bucket name: {name}，请求不发出

• 服务端校验

  校验项	规则	不满足时的表现
  Bucket 数量	单账号不超过 100 个	400 Bad Request，错误码 TooManyBuckets
  Bucket 名唯一性	Bucket 名全局唯一	409 Conflict，错误码 BucketAlreadyExists

注意事项

• 若一个用户创建的 Bucket 超过 100 个，服务将返回 400 Bad Request，错误码 TooManyBuckets。
• 若请求的 Bucket 已存在，无论该 Bucket 是否是请求者创建，都会返回 409 Conflict，错误码 BucketAlreadyExists。
• 创建数据多 AZ 分布的 Bucket 的前提是该 region 已经支持创建多 AZ 的 Bucket。
• 本接口不返回响应 Body，创建结果通过状态码和 Location 响应头判断。

示例

• 请求示例

  Plain Text 复制

  1   PUT / HTTP/1.1
  2   Host: example-bucket.bj.bcebos.com
  3   Date: Wed, 06 Apr 2016 06:34:40 GMT
  4   Authorization: bce-auth-v1/1f63ff09fbc9455a89d4c3b4d78e6e21/2016-04-06T06:34:40Z/1800/content-length;content-md5;content-type;host;x-bce-date/1a1cbc...
  5   Content-Type: application/json;charset=utf-8
  6   Content-Length: 45
  7
  8   {"enableMultiAz":true,"metaType":"HIERARCHY"}

  不带 Body 的最简形式：

  Plain Text 复制

  1   PUT / HTTP/1.1
  2   Host: example-bucket.bj.bcebos.com
  3   Date: Wed, 06 Apr 2016 06:34:40 GMT
  4   Authorization: <AuthorizationString>
  5   Content-Type: application/json;charset=utf-8
  6   Content-Length: 0

• 响应示例

  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