创建存储桶
更新时间: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 | 
响应体参数
响应体字段数据结构说明
请求示例
                JSON
                
            
            1PUT /v1/bucketname_example
2<公共请求头>
3
4
5{
6  "enableMultiAz" : true
7}
            响应示例
                JSON
                
            
            1HTTP/1.1 200 OK
2<公共响应头>
3
4{ }
            错误码
请参考通用错误码
