restorevolume

Use the restorevolume command to restore a volume for cloud tiering.

Syntax

Read syntax diagramSkip visual syntax diagram restorevolume -fromuidvolume_UID-restoreuid-generationgen_id-deletelatergenerations-cancel volume_namevolume_id

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.

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