Getting Rebalance-Retry Status

reference

HTTP method and URI

GET /pools/default/pendingRetryRebalance

Description

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>
http://<host>:<port>/pools/default/pendingRetryRebalance

Responses

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.

Example

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 \
http://10.143.192.101:8091/pools/default/pendingRetryRebalance | 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": [
    "ns_1@10.143.192.101",
    "ns_1@10.143.192.103"
  ],
  "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"
}