创建OB只读副本
更新时间：2025-10-23
创建OB只读副本
接口描述
本接口用于创建OB只读副本和只读列存副本。
创建副本后可以在租户中启用或关闭该副本。
注意事项
- 只读列存副本仅4.3.3及以上版本支持。
- 副本当前仅支持云盘类型。
- 主集群状态运行中时才支持创建副本。
- 仅主集群支持创建副本，备集群不支持。
- 副本释放后不支持恢复。
请求结构
Plain Text
1POST /v{version}/ddc/ob/instance/{instanceId}/replication?clientToken={clientToken} HTTP/1.1
2Host: ddc.bj.baidubce.com
3Authorization: authorization string
4{
5 "billing": {
6 "paymentTiming": "Postpaid"
7 },
8 "number": 1,
9 "isDirectPay": true,
10 "autoRenewTimeUnit": "month",
11 "autoRenewTime": 0,
12 "cpu": 4,
13 "memory": 16,
14 "nodeNum": 1,
15 "diskType": "enhanced_ssd_pl1",
16 "diskSize": 200,
17 "orderParams": {
18 "sceneCode": "addReadonly",
19 "readonlyReplicaType": "ROW_STORE",
20 "zone": "cn-bd-b"
21 }
22}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| instanceId | String | 是 | URL参数 | 集群ID。 |
| clientToken | String | 是 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见 幂等性。 |
| number | Integer | 否 | RequestBody参数 | 购买数量，默认为1。仅限取值1。 |
| billing | Billing | 是 | RequestBody参数 | 订单、计费相关参数。副本的计费方式需要和主集群保持一致。 |
| isDirectPay | Boolean | 否 | RequestBody参数 | 是否直接支付。 |
| autoRenewTimeUnit | String | 否 | RequestBody参数 | 自动续费周期单位，仅预付费时有效。取值如下： |
| autoRenewTime | Integer | 否 | RequestBody参数 | 自动续费周期数，仅预付费时有效。取值如下： |
| cpu | Integer | 是 | RequestBody参数 | cpu配置。cpu不能大于主集群的cpu。当前仅支持云盘配置。取值参考：ObSpecConfig |
| memory | Integer | 是 | RequestBody参数 | 内存配置。内存不能大于主集群的内存。当前仅支持云盘配置。取值参考：ObSpecConfig |
| diskType | ObDiskType | 是 | RequestBody参数 | 磁盘类型。当前仅支持云盘类型。 |
| diskSize | Integer | 是 | RequestBody参数 | 磁盘大小，单位GB。仅云盘时支持设置大小；本地盘固定大小，不支持设置。磁盘大小不能大于主集群的磁盘大小。 |
| nodeNum | Integer | 是 | RequestBody参数 | 节点数。节点数可设置的最大值为集群节点数的最大值。 |
| orderParams | OrderParams | 是 | RequestBody参数 | 额外配置参数。 |
OrderParams
| 参数名称 | 类型 | 描述 |
|---|---|---|
| sceneCode | String | 场景码。当前接口取值为：addReadonly。取值说明如下： |
| readonlyReplicaType | ObReadonlyReplicaType | 只读副本类型。支持只读副本和列存副本。 |
| zone | String | 只读副本所在可用区。可以和主集群可用区不一致。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| orderId | String | 订单ID。 |
请求示例
Plain Text
1POST http://ddc.bj.baidubce.com/v1/ddc/ob/instance/ob75rvk37gw5pc/replication
2Host: ddc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "billing": {
6 "paymentTiming": "Postpaid"
7 },
8 "number": 1,
9 "isDirectPay": true,
10 "autoRenewTimeUnit": "month",
11 "autoRenewTime": 0,
12 "cpu": 4,
13 "memory": 16,
14 "nodeNum": 1,
15 "diskType": "enhanced_ssd_pl1",
16 "diskSize": 200,
17 "orderParams": {
18 "sceneCode": "addReadonly",
19 "readonlyReplicaType": "ROW_STORE",
20 "zone": "cn-bd-b"
21 }
22}响应示例
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"
8}评价此篇文章