调用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

节点类型,取值如下:

  • shard:Shrad节点。
  • mongos:Mongos节点。
ClientToken String ETnLKlblzczshOTUbOCz****

用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

AutoPay Boolean true

是否自动付费。取值如下:

  • true:自动付费,请确保账号有足够的余额。
  • false:控制台手动付费。您可以单击控制台右上角的费用,进入费用中心页面,选择订单管理 > 我的订单,在订单列表页面找到目标订单进行支付。

默认值为: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****"
}

错误码

访问错误中心查看更多错误码。