接口描述
本接口用于创建Bucket。
请求结构
POST /v1/bos/bucket
Host: bec.baidubce.com
Authorization: authorization string
请求头域
除公共头域外,无其它特殊头域。
请求参数
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 |
类型 |
描述 |
bucketId |
String |
创建的BucketId |
bucketName |
String |
创建的Bucket名称 |
错误码
请参照错误返回章节的内容。
请求示例
POST https:
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"paymentMethod":"POST_PAYMENT",
"bucketName":"test1",
"region":"EAST_CHINA",
"serviceProvider":"CHINA_UNICOM",
"city":"XIAN",
"storageClass":"STANDARD",
"accessPermission":"PRIVATE",
"label":"",
"maxCapacity": 1
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"bucketId": "bkt-foblolac",
"bucketName": "abc-test12"
}
Model
CreateBucketRequest
参数名称 |
类型 |
描述 |
paymentMethod |
PaymentMethod |
付费方式 |
bucketName |
String |
名称,限定小写字母/数字/-,每个集群下的bucketName唯一 |
region |
String |
区域 |
serviceProvider |
String |
设备提供商 |
city |
String |
城市 |
storageClass |
BucketStorageClass |
存储方式 |
accessPermission |
AccessPermission |
权限 |
label |
String |
标签 |
maxCapacity |
String |
最大容量,大于等于1,小于等于3.13 |
AccessPermission
枚举类型 |
描述 |
PRIVATE |
仅个人可见 |
PUBLIC_READ |
所有人可读,不可以写 |
PUBLIC_READWRITE |
所有人可读写 |
PaymentMethod
枚举类型 |
描述 |
PRE_PAYMENT |
预付费,暂不支持 |
POST_PAYMENT |
后付费 |
BucketStorageClass
枚举类型 |
描述 |
STANDARD |
标准 |
STANDARD_IA |
低频,因硬件问题暂不支持 |