rmvolumebackupgeneration

Use the rmvolumebackupgeneration command to delete a volume backup or cancel a volume snapshot operation that is in progress.

Syntax


>>- rmvolumebackupgeneration -- -------------------------------->

>--+------------------------------+-- -------------------------->
   +- -volume --+- volume_name -+-+      
   |            '- volume_id ---' |      
   '- -uid -- volume_UID ---------'      

>--+-------------------------+---------------------------------><
   +- -generation -- gen_id -+   
   '- -all ------------------'

Parameters

-volume volume_name | volume_id: (Optional) Specifies the volume snapshot by name or ID.
Note: The volume must exist on the local system.
The value for the volume name must be an alphanumeric string and the value for the volume ID must be a number. This parameter is mutually exclusive with -uid.
-uid volume_UID: (Optional) Specifies the volume snapshot UID. The value for a volume UID must be a number 0 - 32. This parameter is mutually exclusive with -volume.
-generation gen_id: (Optional) Specifies the snapshot generation to be deleted for the volume. Only a single snapshot generation is deleted. If the specified generation is for a snapshot operation that is in progress, that snapshot operation is canceled. The value for the generation ID must be a number. This command is mutually exclusive with -all.
-all: (Optional) Specifies deletion for all volume snapshots (which cancels all snapshot generations as well). This command is mutually exclusive with -generation.

Description

This command deletes a volume snapshot or cancels a volume snapshot operation that is in progress.

Note: If the:

Command completes immediately, the delete operation is performed asynchronously
Volume has more than one snapshot generation, you cannot delete the most recent snapshot generation

An invocation example

To delete snapshot generation 22 for volume with the UID 600507680CA880DF1800000000000007:

rmvolumebackupgeneration -uid 600507680CA880DF1800000000000007 -generation 22

The resulting output:

No feedback

An invocation example

To cancel the current snapshot generation 5 that is in progress for volume vdisk7:

rmvolumebackupgeneration -volume vdisk7 -generation 5

The resulting output:

No feedback

An invocation example

To remove all volume snapshots with the name vdisk10:

rmvolumebackupgeneration -volume vdisk10 -all

The resulting output:

No feedback