Restore a snapshot
Restoring a snapshot takes a VM’s disks back to the moment the snapshot was taken. It lets you undo a failed upgrade on the same VM, build a separate copy of the VM, or roll back a single disk. Two of the three modes change the existing VM, so read the table below before you start.
Which restore mode to choose
Rolling back can’t be undone. Before Replace Current VM or Restore Selected Disk, take a new snapshot of the current state if there’s any chance you’ll need it.
How it works
- You pick a snapshot on the VM’s Snapshots tab and click Restore.
- You choose a mode. The panel shows a Restore Preview and the Restore Impact.
- You click Confirm Restore. For an in-place restore, the VM is stopped, its disks are rolled back, and it starts again automatically. The VM shows Restoring meanwhile.
- A message says “Recovery restore completed successfully”. Restored data volumes are attached but not mounted.
Before you begin
- A snapshot that is ready (Available on Tools → Snapshots).
- Write access to the workspace.
- For an in-place restore, plan for a short outage: the VM is stopped and started, and open connections drop.
- For Create New VM, credit for the new VM and its volumes, which are billed as new resources. The new VM is created in the original VM’s location, with its own new IP address.
- No other restore, backup or resize running on the VM.
Restore in the portal
Open the snapshot
Open the VM, click Snapshots, and scroll to Recovery Points. Click Details to check the captured disks and Mount Instructions.
Restore with the CLI or API
--target-mode is replace (the default), new_vm or volume_only (with --selected-volume-id). The API call is POST /compute/cloud-vm-snapshots/{snapshot_set_id}/actions/restore; it returns a restore_id to poll at GET /compute/cloud-vm-snapshots/restores/{restore_id}. In new_vm mode you can also send vpc_id, subnet_id, network_connectivity and ssh_keys for the new VM. GPU VMs use ibee gpus snapshots and /compute/gpu-vm-snapshots/....
Verify
Mount restored data volumes
Restored data volumes are attached but not mounted. Open the snapshot’s Details, click Copy commands under Mount Instructions, and run them inside the VM:
Don’t format (mkfs) a restored volume: it already holds your data.
