Create a restore

This page describes how to create a restore for virtual machine (VM) workloads in Google Distributed Cloud (GDC) air-gapped.

You can create a restore for a backup that was created manually or automatically by a backup plan. The restored VM and its associated disks contain different names based on the value you specify in the restoredResourceName field. All of the VM resources mentioned in the scope of VirtualMachineBackupPlan resource are restored. All the resources that are restored get their name prefixed with the value of the restoredResourceName field.

When a backup is restored, the entire VM is restored. After the resources are created, the restoration of application capability is subject to the VM operating system or image.

Before you begin

To create a restore, you must have the following:

• An existing backup. Create backups on a schedule using backup plans, or create backups manually. For more information, see Create a manual VM backup.
• The necessary identity and access role. For more information, see Prepare roles and permissions.

Create a manual VM backup

Create the VirtualMachineRestoreRequest resource using the API:

apiVersion: virtualmachine.gdc.goog/v1
kind: VirtualMachineRestoreRequest
metadata:
  name: RESTORE_REQUEST_NAME
  namespace: PROJECT_NAME
spec:
  virtualMachineBackup: VM_BACKUP_NAME
  restoreName: RESTORE_NAME
  restoredResourceName: RESTORE_PREFIX
  restoredResourceDescription: RESTORED_RESOURCE_DESCRIPTION

Replace the following:

• VM_BACKUP_NAME: the name of the VirtualMachineBackup resource to restore from.
• PROJECT_NAME: the name of the GDC project.
• RESTORE_REQUEST_NAME: the name to give the restore request that is being initiated.
• RESTORE_NAME: the name to give the restore that is being initiated.
• RESTORE_PREFIX: the prefix given to newly created VM resources. The restored VM and VM disk names are prefixed with restoredResourceName value in the restore request.
• RESTORED_RESOURCE_DESCRIPTION: a description of the restore being performed.