A newer version of this documentation is available.

View Latest

Rebalance

  • reference
February 16, 2025
+ 12
When one or more nodes have been brought into or taken out of a cluster, rebalance redistributes data, indexes, event processing, and query processing among available nodes. Rebalance can be performed and configured by means of the REST API.

APIs in this Section

Rebalance must be performed whenever the number of nodes in a cluster have changed, and whenever buckets have been added or removed. A complete overview is provided in Rebalance.

The REST API for rebalance is as follows:

HTTP Method URI Documented at

POST

/controller/rebalance

Rebalancing the Cluster

GET

/pools/default/rebalanceProgress

Getting Rebalance Progress

GET

/pools/default/retryRebalance

Configuring Rebalance Retries

POST

/pools/default/retryRebalance

Configuring Rebalance Retries

GET

/pools/default/pendingRetryRebalance

Getting Rebalance-Retry Status

POST

/controller/cancelRebalanceRetry/<rebalance-id>

Canceling Rebalance Retries

GET

/settings/rebalance

Limiting Concurrent vBucket Moves

POST

/settings/rebalance

Limiting Concurrent vBucket Moves

POST

/internalSettings

Disabling Consistent View Query Results on Rebalance