Appearance
PutBucket
接口描述
本接口用于创建Bucket。每一个租户只允许创建500个Bucket。创建的Bucket其权限默认为private,即Bucket的创建租户获得FULL_CONTROL,其他人没有任何权限。
请求(Request)
请求语法
PUT /<BucketName> HTTP/1.1
Host: fos.flymeyun.com
Date: <Date>
Content-Length: <ContentLength>
Content-Type: text/plain
请求参数
无
请求头域
名称 | 类型 | 描述 | 是否必须 |
---|---|---|---|
x-fos-tag-list | string | 创建bucket时为bucket绑定tag,格式为tag1=value1&tag2=value2 | 否 |
响应
响应头域
无特殊Header参数返回
响应参数
无
注意事项
- 若一个租户创建的Bucket超过500个,服务将返回400 Bad Request,错误码TooManyBuckets。
- 若请求的Bucket已存在,无论该Bucket是否是请求者创建,都会返回409 Conflict,错误信息:BucketAlreadyExists。
示例
请求示例
PUT /<BucketName> HTTP/1.1
Host: fos.flymeyun.com
Date: <Date>
Content-Length: <ContentLength>
Content-Type: text/plain
响应示例
HTTP/1.1 200 OK
x-fos-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
Date: Wed, 06 Apr 2016 06:34:40 GMT
Content-Length: 0