Removing Nodes from Clusters
Remove nodes from clusters with the POST /controller/ejectNode HTTP method and URI.
HTTP method and URI
Server nodes are typically removed from a cluster when the node is temporarily or permanently down.The method /controller/ejectNode cannot remove active nodes. It can be used only on failed over nodes, nodes in pending state, or nodes that have been recently added or joined but not yet rebalanced into the cluster. Removing an active node must be done with the /controller/rebalance endpoint.
HTTP request syntax:
POST /controller/ejectNode Host: [localhost]:8091 Authorization: Basic xxxxxxxxxxxx Accept: */* Content-Length: xxxxxxxxxx Content-Type: application/x-www-form-urlencoded otpNode=[node@hostname]
Curl request syntax:
curl -u admin:password -d otpNode=[node@hostname] \ http://[localhost]:8091/controller/ejectNode
HTTP request example:
POST /controller/ejectNode Host: 192.168.0.106:8091 Authorization: Basic xxxxxxxxxxxx Accept: */* Content-Length: xxxxxxxxxx Content-Type: application/x-www-form-urlencoded otpNodefirstname.lastname@example.org
Curl request example:
curl -u Administrator:password -d 'otpNodeemail@example.com' \ http://192.168.0.106:8091/controller/ejectNode
200 OK - node ejected 400 Error, the node to be ejected does not exist 401 Unauthorized - Credentials were not supplied and are required 403 Forbidden - Credentials were supplied and are incorrect