A newer version of this documentation is available.

View Latest

Getting Rebalance-Retry Status

  • reference

    HTTP method and URI

    GET /pools/default/pendingRetryRebalance


    This returns status on pending rebalance retries. The information can subsequently be used to cancel the retries.

    For an overview of rebalance and rebalance retries, see Rebalance.

    Curl Syntax

    curl -X GET -u <administrator>:<password>


    Success gives 200 OK, and returns an object containing status on pending rebalance retries. Failure to authenticate gives 401 Unauthorized. A malformed URI gives 404 Object Not Found.


    The following example obtains information on pending reblance-retries. Note that the command is piped to the jq tool, to facilitate output-readability.

    curl -u Administrator:password -v -X GET \ | jq '.'

    If successful, the command returns the following object:

      "retry_rebalance": "pending",
      "rebalance_id": "ff5845cdce693db2dce9a9308cbf885d",
      "type": "rebalance",
      "attempts_remaining": 2,
      "retry_after_secs": 291,
      "known_nodes": [
      "eject_nodes": [],
      "delta_recovery_buckets": "all"

    This indicates that the status of retry_rebalance is pending; and provides a rebalance_id for the process, of ff5845cdce693db2dce9a9308cbf885d. This id can be used to cancel the retry. The output also lists the cluster’s nodes, indicates that 2 retry attempts are scheduled to occur if necessary after the current one, and indicates that 291 seconds are still to elapse before the pending retry.

    Note that if no rebalance is pending, the following object is returned:

      "retry_rebalance": "not_pending"

    See Also

    For an overview of rebalance with the Data Service and other services, see Rebalance. For practical examples of adding a node, rebalancing, and cancelling rebalance retries, see Add a Node and Rebalance. For information on using the REST API to cancel pending rebalance retries, see Cancel Rebalance Retries.

    For information on configuring rebalance-retry settings, see Configure Rebalance Retries. For information on obtaining and reading rebalance reports, see the Rebalance Reference.