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

RemoveDrives

Contributors netapp-pcarriga

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.

Parameter

This method has the following input parameter:

Name Description Type Default value Required

drives

List of driveIDs to remove from the cluster.

integer array

None

Yes

Return value

This method has the following return value:

Name Description Type

asyncHandle

Handle value used to obtain the operation result.

integer

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

9.6

Find more information