restorevolume

Use the restorevolume command to restore a volume from a snapshot generation.

Syntax

Parameters

-fromuid volume_UID: (Optional) Specifies the volume snapshot to restore (specified by volume UID). The value must be a hexadecimal number.
Use this parameter to restore a snapshot from a different volume. This means that the specified UID must be different from the UID of the volume being restored (when you specify volume_name or volume_id).
Note: The volume being restored to cannot have cloud snapshot enabled if you specify this parameter.
-restoreuid: (Optional) Specifies the UID of the restored volume should be set to the UID of the volume snapshot that is being restored. You must specify -fromuid with this parameter. The -restoreuid parameter is not supported if cloud account is in import mode.
-generation gen_id: (Optional) Specifies the snapshot generation to restore. The value must be a number.
-deletelatergenerations: (Optional) Specifies that all snapshot generations should be deleted after the generation is restored.
Note: This parameter is required when the volume has cloud snapshot enabled and the generation being restored is not the most recent snapshot of the volume.
-cancel: (Optional) Cancels the restore operation.
volume_name | volume_id: (Required) Specifies the volume name or ID to restore. The value for the volume ID must be a number and the value for the volume name must be an alphanumeric string.

Note: Restoring a cloud backup to a volume other than the backup source volume is not allowed if the target volume has snapshots.

Note: The restorevolume command is not allowed if the specified target (restore to) volume is a Safeguarded backup.

Description

This command restores a volume from a snapshot generation.

The restore operation is performed directly on the volume specified by volume name or volume ID (without use of a temporary volume). The volume is offline while the restore operation is in progress. If the restore process is canceled before it completes the data on the volume is inconsistent and not usable.

An invocation example

To restore an earlier generation (generation 3) for volume volume7:

restorevolume -generation 3 -deletelatergenerations volume7

The resulting output:

No feedback

An invocation example

To restore the most recent snapshot (generation 5) for volume ID 7:

restorevolume -generation 5 volume7

The resulting output:

No feedback

An invocation example

restorevolume -generation 1 -fromuid 6005076400B70038E00000000000001C 1

The resulting output:

No feedback