创建存储桶
更新时间：2024-07-26
接口说明
本接口用于创建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
<公共响应头>
{ }错误码
请参考通用错误码