创建存储桶
所有文档
menu

对象存储 BOS

创建存储桶

产品详情自助选购

接口说明

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

注意事项

  • 若一个用户创建的Bucket超过100个,服务将返回400 Bad Request,错误码TooManyBuckets。
  • 若请求的Bucket已存在,无论该Bucket是否是请求者创建,都会返回409 Conflict,错误信息:BucketAlreadyExists。
  • 创建数据多AZ分布的bucket的前提是该region已经支持创建多AZ的bucket,目前BOS仅支持北京和广州两个region,其它region待开通中。

在线调试

请求URI

PUT /v1/{bucketname}

参数名称 参数类型 是否必须 描述 示例值 参数位置
bucketname String 存储桶(Bucket)的名称 "bucketname_example" Path

请求体参数

请求体字段数据结构说明

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

响应体参数

响应体字段数据结构说明

请求示例

PUT /v1/bucketname_example
<公共请求头>


{
  "enableMultiAz" : true
}

响应示例

HTTP/1.1 200 OK
<公共响应头>

{ }

错误码

请参考通用错误码

上一篇
如何调用API
下一篇
删除存储桶