Skip to content
大纲

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-liststring创建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