新增分片集实例组件
更新时间：2022-01-14
说明
- 本接口用于新增分片集群实例的Mongos或Shard组件，目前仅支持一次创建一个。
- 组件计费方式和所属实例计费方式相同。
- 创建计费方式为后付费的组件需要账户现金余额+通用代金券大于100；创建预付费方式的组件则需要账户现金余额大于等于组件费用。
- 创建接口为异步创建，可通过查询指定实例详情接口查询实例状态或组件状态。
请求结构
POST /v{version}/instance/{dbInstanceId}/node?clientToken={clientToken} HTTP/1.1
HOST: mongodb.bj.baidubce.com
Authorization: authorization string
{
"nodeCpuCount": cpuCount,
"nodeMemoryCapacity": memCapacity,
"nodeStorage": storage,
"nodeType": "Shard"
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | string | 是 | URL参数 | API版本号 |
| clientToken | string | 是 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串 |
| dbInstanceId | string | 是 | Query参数 | 实例ID |
| nodeCpuCount | int | 是 | RequestBody参数 | 组件CPU规格。取值参考 |
| nodeMemoryCapacity | int | 是 | RequestBody参数 | 组件内存规格，单位GB取值参考 |
| nodeStorage | int | 否 | RequestBody参数 | 组件存储空间，单位GB。新增Shard组件时该参数必填。取值参考 |
| nodeType | string | 是 | RequestBody参数 | 组件类型。取值参考 |
| purchaseCount | int | 否 | RequestBody参数 | 创建组件个数, 目前仅支持一次创建一个。默认值：1 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| nodeId | List String | 新增组件Id |
请求示例
POST /v1/instance/m-qNlWTz/node?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST: mongodb.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"nodeCpuCount": 1,
"nodeMemoryCapacity": 2,
"nodeStorage": 5,
"nodeType": "shard"
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
Content-Type: application/json
{
"nodeIds": ［"shd-AQsm6p"］
}