调用ModifyNodeSpec接口变更MongoDB分片集群实例中节点的规格和存储空间。

请确保在使用该接口前，已充分了解MongoDB产品的收费方式和价格。

该接口仅适用于分片集群实例。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyNodeSpec

系统规定参数。取值：ModifyNodeSpec。

RegionId String 否 cn-hangzhou

地域ID，您可以调用DescribeRegions查询。

DBInstanceId String 是 dds-bpxxxxxxxx

实例ID。
NodeId String 是 d-bpxxxxxxxx

分片集群实例中Shard节点ID或Mongos节点ID，您可以通过调用DescribeDBInstanceAttribute接口进行查询。

说明 当传入的值为Shard节点ID时，还需要传入 NodeStorage参数。
NodeClass String 否 dds.shard.standard

Shard节点或Mongos节点的规格，规格详情请参见实例规格表。

说明 本参数和 NodeStorage参数两者必须传入一个。
NodeStorage Integer 否 20

设置Shard节点的存储空间。

  • 取值范围：10~2000，单位为GB。
  • 每10GB进行递增。
说明
  • 本参数和NodeClass参数两者必须传入一个。
  • 当NodeId传入的值为Shard节点ID时，本参数才可用。
ClientToken String 否 ETnLKlblzczshOTUbOCzxxxxxxxxxx

用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符，且该参数值中不能包含非ASCII字符。
FromApp String 否 OpenApi

请求来源，取值：

  • OpenApi：请求来源为OpenApi。
  • mongo_buy：请求来源为控制台。
AutoPay Boolean 否 true

是否自动付费。取值：

  • true：自动付费，请确保账号有足够的余额。
  • false：控制台手动付费。具体操作为：登录控制台，在右上角选择费用>进入费用中心，在订单管理找到目标订单进行支付。

默认值为：true。

EffectiveTime String 否 Immediately

变更配置的生效时间，取值：

  • Immediately：立即生效。
  • MaintainTime：实例可运维时间段内生效。

默认值为Immediately。

OrderType String 否 UPGRADE

订单类型。取值：

  • UPGRADE：升配
  • DOWNGRADE：降配
ReadonlyReplicas Integer 否 5

调整Shard节点中只读节点的个数。取值范围：0~5。默认值：0。

说明 当前仅中国站支持本参数。
BusinessInfo String 否 {“ActivityId":"000000000"}

附加参数，业务信息。
CouponNo String 否 1111111111111111

优惠码，默认为：youhuiquan_promotion_option_id_for_blank。

返回数据

名称 类型 示例值 描述
RequestId String EFFC5788-8BB5-41B5-9F15-9CFC5A0E8FCC

请求ID。
OrderId String 2033xxxxxxxxx

订单ID。

示例

请求示例

http(s)://mongodb.aliyuncs.com/?Action=ModifyNodeSpec
&NodeId=d-bpxxxxxxxx
&DBInstanceId=dds-bpxxxxxxxx
&NodeClass=dds.shard.standard
&NodeStorage=20
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<ModifyNodeSpecResponse>
    <OrderId>2033xxxxxxxxx</OrderId>
    <RequestId>EFFC5788-8BB5-41B5-9F15-9CFC5A0E8FCC</RequestId>
</ModifyNodeSpecResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "OrderId" : "2033xxxxxxxx",
  "RequestId" : "EFFC5788-8BB5-41B5-9F15-9CFC5A0E8FCC"
}

错误码

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