Skip to main content

volume delete

Contributors
Suggest changes
PDFs

Delete an existing volume

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The volume delete command deletes the specified volumes. Before deleting a volume, the user is prompted to confirm the operation unless the -force flag is specified. If this volume was associated with a policy group the underlying qos workload is deleted.

NOTE:

  • If there is a qtree or quota policy associated with a volume, it is deleted when you delete the volume.

  • A volume must be offline (see volume offline ) to be deleted.

Parameters

-vserver <vserver name> - Vserver Name

This specifies the name of the Vserver from which the volume is to be deleted. If only one data Vserver exists, you do not need to specify this parameter.

-volume <volume name> - Volume Name

This specifies the name of the volume that is to be deleted.

[-force <true>] - Force Delete (privilege: advanced)

If this parameter is specified, the user is not prompted to confirm each deletion operation. In addition, the operation is run only on the local node, and several potential errors are ignored. By default, this setting is false . This parameter is available only at the advanced privilege level and higher.

[-foreground {true|false}] - Foreground Process

This specifies whether the operation runs in the foreground. The default setting is true (the operation runs in the foreground). When set to true, the command will not return until the operation completes.

Examples

The following example deletes a volume named vol1_old from a Vserver named vs0:

cluster1::> volume delete -vserver vs0 -volume vol1_old