创建OB集群
更新时间：2026-01-28
创建OB集群
接口描述
本接口用于创建OB集群，支持创建备集群。
注意事项
- 当前仅支持在北京、保定、武汉地域创建集群。
- 该接口请求成功后会返回两个订单ID，具体说明参考返回值说明
- 支持创建备集群，备集群参数具体见参数说明
请求结构
Plain Text
1POST /v{version}/ddc/ob/instance?clientToken={clientToken} HTTP/1.1
2Host: ddc.bj.baidubce.com
3Authorization: authorization string
4{
5 "billing": {
6 "paymentTiming": "Prepaid",
7 "reservation": {
8 "reservationLength": 1
9 }
10 },
11 "number": 1,
12 "isDirectPay": true,
13 "autoRenewTimeUnit": "month",
14 "autoRenewTime": 0,
15 "tags": [],
16 "version": "4.2.1",
17 "cpu": 16,
18 "memory": 32,
19 "instanceName": "clltest1",
20 "zones": [
21 "cn-bj-d",
22 "cn-bj-e",
23 "cn-bj-f"
24 ],
25 "deployType": "multiple",
26 "replicaMode": "3",
27 "instanceType": "CLUSTER",
28 "diskType": "enhanced_ssd_pl1",
29 "diskSize": 100
30}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| clientToken | String | 是 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见 幂等性。 |
| number | Integer | 否 | RequestBody参数 | 购买数量，默认为1。仅限取值1。 |
| billing | Billing | 是 | RequestBody参数 | 订单、计费相关参数。 |
| isDirectPay | Boolean | 否 | RequestBody参数 | 是否直接支付。 |
| autoRenewTimeUnit | String | 否 | RequestBody参数 | 自动续费周期单位，取值如下： |
| autoRenewTime | Integer | 否 | RequestBody参数 | 自动续费周期数，取值如下： |
| tags | List<Tag> | 否 | RequestBody参数 | 标签信息 |
| version | String | 是 | RequestBody参数 | OB数据库版本。备集群版本必须和主集群保持一致。 |
| cpu | Integer | 是 | RequestBody参数 | cpu配置。取值参考：ObSpecConfig |
| memory | Integer | 是 | RequestBody参数 | 内存配置。取值参考：ObSpecConfig |
| instanceName | String | 否 | RequestBody参数 | 实例名称。长度为 2~64 字符，只能包含中文、数字、英文字母、下划线、短横线。 |
| zones | List<String> | 是 | RequestBody参数 | 可用区列表，多机房部署时，可用区数量固定为3个。当前支持的可用区为：北京地域（cn-bj-d、cn-bj-e、cn-bj-f、cn-bj-i）、保定地域（cn-bd-b、cn-bd-c、cn-bd-d）、武汉地域（cn-fwh-a、cn-fwh-b） |
| instanceType | String | 是 | RequestBody参数 | 实例类型。备集群需要和主集群保持一致。当前仅支持集群版。具体取值参考：ObInstanceType |
| replicaMode | String | 是 | RequestBody参数 | 全功能型副本数。具体取值参考：ObReplicaMode |
| deployType | String | 是 | RequestBody参数 | 部署类型。具体取值参考：ObDeployType |
| diskType | ObDiskType | 否 | RequestBody参数 | 磁盘类型。默认为本地盘。备集群须和主集群保持一致。 |
| diskSize | Integer | 否 | RequestBody参数 | 磁盘大小，单位GB。仅云盘时支持设置大小；本地盘固定大小，不支持设置。 |
| orderParams | OrderParams | 否 | RequestBody参数 | 额外配置参数。 |
OrderParams
| 参数名称 | 类型 | 描述 |
|---|---|---|
| primaryInstanceId | String | 主集群ID。创建备集群时需要设置。 |
| instanceRole | ObInstanceRole | 实例角色。创建备集群时需要设置。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| orderId | String | 订单ID。多个订单ID用逗号分隔。包括OB实例订单和其他关联实例（备份实例、审计实例等）的订单。 |
请求示例
Plain Text
1POST http://ddc.bj.baidubce.com/v1/ddc/ob/instance
2Host: ddc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "billing": {
6 "paymentTiming": "Prepaid",
7 "reservation": {
8 "reservationLength": 1
9 }
10 },
11 "number": 1,
12 "isDirectPay": true,
13 "autoRenewTimeUnit": "month",
14 "autoRenewTime": 0,
15 "tags": [],
16 "version": "4.2.1",
17 "cpu": 16,
18 "memory": 32,
19 "instanceName": "clltest1",
20 "zones": [
21 "cn-bj-d",
22 "cn-bj-e",
23 "cn-bj-f"
24 ],
25 "deployType": "multiple",
26 "replicaMode": "3F",
27 "instanceType": "CLUSTER",
28 "diskType": "enhanced_ssd_pl1",
29 "diskSize": 100
30}响应示例
Plain Text
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 "orderId": "xxx,yyy"
8}评价此篇文章