Skip to main content
Element Software
A newer release of this product is available.


Contributors netapp-pcarriga netapp-dbagwell

You can use the RemoveDrives method to proactively remove drives that are part of the cluster. You might use this method when reducing cluster capacity or preparing to replace drives nearing the end of their service life. RemoveDrives creates a third copy of the block data on the other nodes in the cluster and waits for syncing to complete before moving the drives to the "Available" list. Drives in the "Available" list are completely removed from the system and have no running services or active data.

RemoveDrives is an asynchronous method. Depending on the total capacity of the drives being removed, it might take several minutes to migrate all of the data.

When removing multiple drives, use a single RemoveDrives method call rather than multiple individual methods with a single drive each. This reduces the amount of data balancing that must occur to evenly stabilize the storage load on the cluster.

You can also remove drives with a "failed" status using RemoveDrives. When you remove a drive with a "failed" status, the drive is not returned to an "available" or “active” status. The drive is unavailable for use in the cluster.


This method has the following input parameter:

Name Description Type Default value Required


List of driveIDs to remove from the cluster.

integer array



Return value

This method has the following return value:

Name Description Type


Handle value used to obtain the operation result.


Request example

Requests for this method are similar to the following example:

   "method": "RemoveDrives",
   "params": {
      "drives"  : [3, 4, 5]
   "id" : 1

Response example

This method returns a response similar to the following example:

   "id": 1,
   "result" : {
     "asyncHandle": 1

New since version


Find more information