PutBucket
更新时间:2024-07-24
接口描述
本接口用于创建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)
注意事项
- 若一个用户创建的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