You can call this operation to modify the type and storage space of the nodes in ApsaraDB for MongoDB sharded cluster instances.

Make sure that you fully understand the billing methods and pricing of ApsaraDB for MongoDB before calling this operation.

This operation can be performed only on sharded cluster instances.


OpenAPI Explorer simplifies API usage. You can use OpenAPI Explorer to perform debugging operations, such as retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Parameter Type Required Example Description
NodeId String Yes d-bpxxxxxxxx

The ID of the shard or mongos in the sharded cluster instance. You can call theDescribeDBInstanceAttributeoperation to query the ID.

Note If you specify this parameter to the ID of a Shard, you must also specify the NodeStorage parameter.
DBInstanceId String Yes dds-bpxxxxxxxx

The ID of the instance for which you want to query the maximum internal bandwidth.

Action String No ModifyNodeSpec

The operation that you want to perform. Set the value toModifyNodeSpec.

NodeClass String No dds.shard.standard

The specification of the shard or mongos. For more information, seeInstance specifications.

Note You must specify either this parameter or theNodeStorageparameter.
NodeStorage Integer Optional 20

The storage space set for the shard.

  • Valid values:10to2000. Unit: GB.
  • You can only specify this value in 10 GB increments.
  • You must specify either this parameter or theNodeClassparameter.
  • This parameter is only valid when you specify theNodeIdparameter to the ID of the shard.
ClientToken String No ETnLKlblzczshOTUbOCzxxxxxxxxxx

The client token that is used to ensure idempotence of the request. You can use the client to generate this value, but you must ensure that it is unique among different requests. The token can contain only ASCII characters, and cannot exceed 64 characters in length.

AutoPay Boolean No true

Indicates whether automatic payment is enabled for the instance. Valid values:

  • true: Automatic payment is enabled. Make sure that your account has sufficient balance.
  • false: Automatic payment is not enabled. You must make payments in the console. Payment instructions: Log on to the console. In the upper-right corner, clickBilling Managementand selectBilling Managementfrom the drop-down list. The Billing Management page appears. In the left-side navigation pane, clickBills. On the Unpaid tab, click Make a Payment in the Actions column corresponding to the bill you want to pay.

Default value:true.

EffectiveTime String No Immediately

The time when the modified configuration values take effect. Valid values:

  • Immediately: The configurations take effect immediately.
  • MaintainTime: The configurations take effect during the maintenance period of the instance.

Default value:Immediately.

FromApp String No OpenApi

The request source. Valid values:

  • OpenApi: The request is sent from an API.
  • mongo_buy: The request is sent from the console.
AccessKeyId String No LTAIgbTGpxxxxxx

The AccessKey ID that Alibaba Cloud provides for you to access services.

Response parameters

Parameter Type Example Description
OrderId String 2033xxxxxxxxx

The ID of the order.

RequestId String EFFC5788-8BB5-41B5-9F15-9CFC5A0E8FCC

The ID of the request.


Sample requests

http(s):// Action=ModifyNodeSpec
&<Common request parameters>

Sample success responses

XML format


JSON format


Error codes

For a list of error codes, visit the API Error Center.