创建Bucket
更新时间：2022-08-24
接口描述
本接口用于创建Bucket。
请求结构
Plain Text
1POST /v1/bos/bucket
2Host: bec.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| request | CreateBucketRequest | 是 | RequestBody参数 | 创建Bucket请求 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| bucketId | String | 创建的BucketId |
| bucketName | String | 创建的Bucket名称 |
错误码
请参照错误返回章节的内容。
请求示例
JSON
1POST https://bec.baidubce.com/v1/bos/bucket
2Host: bec.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "paymentMethod":"POST_PAYMENT",
6 "bucketName":"test1",
7 "region":"EAST_CHINA",
8 "serviceProvider":"CHINA_UNICOM",
9 "city":"XIAN",
10 "storageClass":"STANDARD",
11 "accessPermission":"PRIVATE",
12 "label":"",
13 "maxCapacity": 1
14}响应示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6{
7 "bucketId": "bkt-foblolac",
8 "bucketName": "abc-test12"
9}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 | 低频，因硬件问题暂不支持 |