You can use RemoveNodes to remove one or more nodes that should no longer participate in the cluster.

Before removing a node, you must remove all drives the node contains using the RemoveDrives method. You cannot remove a node until the RemoveDrives process has completed and all data has been migrated away from the node. After you remove a node, it registers itself as a pending node. You can add the node again or shut it down (shutting the node down removes it from the pending node list).

Cluster master node removal

If you use RemoveNodes to remove the cluster master node, the method might time out before returning a response. If the method call fails to remove the node, make the method call again. Note that if you are removing the cluster master node along with other nodes, you should use a separate call to remove the cluster master node by itself.


This method has the following input parameter:

Name Description Type Default value Required
nodes List of NodeIDs for the nodes to be removed. integer array None Yes

Return value

This method has no return value.

Request example

Requests for this method are similar to the following example:

   "method": "RemoveNodes",
   "params": {
     "nodes"  : [3,4,5]
   "id" : 1

Response example

This method returns a response similar to the following example:

  "id" : 1 
  "result" : {},