调用CreateNode接口为MongoDB分片集群实例增加Shard节点或Mongos节点。
请确保在使用该接口前,已充分了解MongoDB产品的收费方式和价格。
该接口仅适用于分片集群实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateNode |
系统规定参数。取值:CreateNode。 |
RegionId | String | 否 | cn-hangzhou |
地域ID,您可以调用DescribeRegions查询。 |
DBInstanceId | String | 是 | dds-bp11501cd7b5**** |
分片集群实例ID。 |
NodeClass | String | 是 | dds.shard.mid |
Shard节点或Mongos节点的规格,规格详情请参见实例规格表。 |
NodeStorage | Integer | 否 | 10 |
Node的磁盘空间,取值范围为10~2000 GB,步长为10 GB。 说明 当节点类型为Shard时,需要配置该参数。
|
NodeType | String | 是 | shard |
节点类型,取值如下:
|
ClientToken | String | 否 | ETnLKlblzczshOTUbOCz**** |
用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。 |
AutoPay | Boolean | 否 | true |
是否自动付费。取值如下:
默认值为:true。 说明 当付费类型为包年包月时,需要配置该参数。
|
ReadonlyReplicas | Integer | 否 | 5 |
设置Shard节点中只读节点的个数。取值范围为0~5。默认为0。 说明 当前仅中国站支持本参数。
|
BusinessInfo | String | 否 | {“ActivityId":"000000000"} |
附加参数,业务信息。 |
CouponNo | String | 否 | youhuiquan_promotion_option_id_for_blank |
优惠码,默认为:youhuiquan_promotion_option_id_for_blank。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 7D48FB19-20CA-4725-A870-3D8F5CE6**** |
请求ID。 |
NodeId | String | d-bp1b234bf7a4**** |
节点ID。 |
OrderId | String | 20951063702**** |
订单ID。 |
示例
请求示例
http(s)://mongodb.aliyuncs.com/?Action=CreateNode
&DBInstanceId=dds-bp11501cd7b5****
&NodeClass=dds.shard.mid
&NodeStorage=10
&NodeType=shard
&ClientToken=ETnLKlblzczshOTUbOCz****
&FromApp=mongo_buy
&AutoPay=true
&ReadonlyReplicas=5
&BusinessInfo={“ActivityId":"000000000"}
&CouponNo=youhuiquan_promotion_option_id_for_blank
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateNodeResponse>
<RequestId>7D48FB19-20CA-4725-A870-3D8F5CE6****</RequestId>
<NodeId>d-bp1b234bf7a4****</NodeId>
<OrderId>20951063702****</OrderId>
</CreateNodeResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "7D48FB19-20CA-4725-A870-3D8F5CE6****",
"NodeId" : "d-bp1b234bf7a4****",
"OrderId" : "20951063702****"
}
错误码
访问错误中心查看更多错误码。