You are viewing the documentation for a prerelease version.

View Latest

Get Rebalance-Retry Status

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"
}

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.