All Products
Search
Document Center

ApsaraDB for MongoDB:Add a mongos node

Last Updated:Mar 28, 2026

Add one or more mongos nodes to an ApsaraDB for MongoDB sharded cluster instance to increase query routing capacity or distribute client connection load.

Usage notes

  • Adding a mongos node does not interrupt existing connections. Your application continues to run normally during the operation.

  • In most cases, the node is ready within 5 minutes. This duration is independent of the number of nodes you add in a single operation.

  • If the minor version of your instance has expired or is no longer maintained, ApsaraDB for MongoDB automatically upgrades it to the latest minor version during the configuration change.

Warning

A minor version upgrade requires an instance restart. Schedule the operation during off-peak hours, or make sure your application can automatically reconnect to the instance.

Billing

Adding a mongos node is a configuration change. For pricing details, see Configuration change fees.

Add a mongos node

  1. Go to the Sharded Cluster Instances page. In the top navigation bar, select the region where your instance resides. Find the instance and click its ID.

  2. On the instance details page, go to the Mongos List section and click Add Mongos in the upper-right corner.

  3. In the Add Mongos panel, configure the following parameters.

    ParameterDescription
    CategoryThe category of the mongos node. This parameter applies only to instances that use cloud disks. If a category is not available, it is not supported in the current zone. For available categories and specifications, see Sharded cluster instance types.
    Instance SpecificationsThe specifications of the mongos node to add.
    QuantityThe number of mongos nodes to add. A sharded cluster instance supports up to 32 mongos nodes. For example, if the instance already has 3 mongos nodes, you can add up to 29 more.
  4. Click Pay Now.

    • Pay-as-you-go: The charge is collected in the next hour.

    • Subscription: The charge is automatically collected.

Verify the result

While the mongos nodes are being added, the instance status changes to Creating Node. When the status returns to Running, the nodes have been added successfully.

API reference

OperationDescription
CreateNodeAdds a shard or mongos node to an ApsaraDB for MongoDB sharded cluster instance.