Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página descreve como restaurar um disco de máquina virtual (VM) de um snapshot de disco de imagem criado
com os procedimentos de backup e restauração isolados do Google Distributed Cloud (GDC).
Antes de começar
Para restaurar um disco de VM de um snapshot, você precisa do seguinte:
Administrador de VirtualMachine do projeto: gerencia VMs no namespace do projeto. Peça ao administrador do IAM do projeto para conceder a você o papel de administrador de máquinas virtuais do projeto (project-vm-admin).
Criador de backup: cria e restaura backups manuais. Peça ao administrador do IAM do projeto para conceder a você o papel de Criador de backup (backup-creator).
Leitor do projeto: tem acesso somente leitura a todos os recursos nos namespaces do projeto. Peça ao administrador do IAM do projeto para conceder a você o papel de Leitor do projeto (project-viewer).
Restaurar um snapshot
Crie uma VM usando um snapshot de disco com o console do GDC ou a interface de programação de aplicativos (API).
Console
Faça login no console do GDC.
No menu de navegação, clique em Máquinas virtuais > Snapshots.
Selecione um projeto.
Na lista de snapshots, encontre o que você quer restaurar e clique em
Restaurar.
No campo Novo nome do disco, insira o nome do disco em que o backup será restaurado.
Insira um Nome da restauração.
Clique em Restaurar.
API
Crie um recurso personalizado VirtualMachineRestoreRequest para iniciar o processo de restauração.
A restauração da capacidade do aplicativo está sujeita ao sistema operacional ou à imagem da VM.
Crie um recurso personalizado VirtualMachineRestoreRequest para iniciar o
processo de restauração:
VM_BACKUP_NAME: o nome do recurso VirtualMachineBackup a ser restaurado.
PROJECT_NAME: o nome do projeto do GDC.
RESTORE_REQUEST_NAME: o nome da solicitação de restauração que está sendo iniciada.
RESTORE_NAME: o nome da restauração que está sendo iniciada.
RESTORE_PREFIX: um prefixo anexado ao início do nome dos backups que essa solicitação restaura.
RESTORED_RESOURCE_DESCRIPTION: descrição do motivo da restauração.
O resultado da restauração cria um novo disco com a mesma configuração e
estado do disco que o snapshot, concluindo o processo de backup e recuperação de dados.
Ver uma restauração
Confira uma restauração usando o console do GDC ou a interface de linha de comando (CLI) kubectl.
Console
Faça login no console do GDC.
No menu de navegação, clique em Máquinas virtuais > Snapshots.
Selecione um projeto.
Clique na guia Restaurações.
Na lista de restaurações, clique no nome da restauração para ver os detalhes.
kubectl
Para ver uma restauração, liste as restaurações e confira os detalhes delas:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis guide details the process of restoring a virtual machine (VM) disk from a snapshot created through Google Distributed Cloud (GDC) air-gapped backup and restore procedures.\u003c/p\u003e\n"],["\u003cp\u003eRestoring a VM disk from a snapshot requires an existing snapshot and specific identity and access roles, including Project VirtualMachine Admin, Backup Creator, and Project Viewer.\u003c/p\u003e\n"],["\u003cp\u003eYou can restore a snapshot using either the GDC console by navigating to the Snapshots section and selecting the Restore option or by creating a \u003ccode\u003eVirtualMachineRestoreRequest\u003c/code\u003e custom resource via the API.\u003c/p\u003e\n"],["\u003cp\u003eAfter initiating the restoration, a new disk is created with the same configuration and state as the snapshot, effectively completing the data recovery process.\u003c/p\u003e\n"],["\u003cp\u003eYou can use either the GDC console or the \u003ccode\u003ekubectl\u003c/code\u003e CLI to view and delete restores, and the guide provides the specific steps for each method.\u003c/p\u003e\n"]]],[],null,["# Restore a VM from a snapshot\n\nThis page describes how to restore a virtual machine (VM) disk from an image disk snapshot that was created\nthrough Google Distributed Cloud (GDC) air-gapped backup and restore procedures.\n\nBefore you begin\n----------------\n\nTo restore a VM disk from a snapshot, you must have the following:\n\n- An existing snapshot. For more information, see [Back up disks](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/vm-backup/back-up-disks).\n- The necessary identity and access roles:\n\n - Project VirtualMachine Admin: manages VMs in the project namespace. Ask your Project IAM Admin to grant you the Project VirtualMachine Admin (`project-vm-admin`) role.\n - Backup Creator: creates manual backups and restores. Ask your Project IAM Admin to grant you the Backup Creator (`backup-creator`) role.\n - Project Viewer: has read-only access to all resources within project namespaces. Ask your Project IAM Admin to grant you the Project Viewer (`project-viewer`) role.\n\nRestore a snapshot\n------------------\n\nCreate a new VM from a disk snapshot by using the GDC console or the\napplication programming interface (API). \n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Virtual Machines \\\u003e Snapshots**.\n3. Select a project.\n4. In the list of snapshots, find the snapshot to restore and click **Restore**.\n5. In the **New disk name** field, enter the name of the disk to restore the backup in.\n6. Enter a **Restore name** for the restore.\n7. Click **Restore**.\n\n### API\n\nCreate a `VirtualMachineRestoreRequest` custom resource to initiate the restore\nprocess.\n\nThe restoration of application capability is subject to the VM operating system or image.\nCreate a `VirtualMachineRestoreRequest` custom resource to initiate the\nrestore process: \n\n apiVersion: virtualmachine.gdc.goog/v1\n kind: VirtualMachineRestoreRequest\n metadata:\n name: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eRESTORE_REQUEST_NAME\u003c/span\u003e\u003c/var\u003e\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePROJECT_NAME\u003c/span\u003e\u003c/var\u003e\n spec:\n virtualMachineBackup: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eVM_BACKUP_NAME\u003c/span\u003e\u003c/var\u003e\n restoreName: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eRESTORE_NAME\u003c/span\u003e\u003c/var\u003e\n restoredResourceName: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eRESTORE_PREFIX\u003c/span\u003e\u003c/var\u003e\n restoredResourceDescription: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eRESTORED_RESOURCE_DESCRIPTION\u003c/span\u003e\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eVM_BACKUP_NAME\u003c/var\u003e: the name of the `VirtualMachineBackup` resource to restore from.\n- \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e: the name of the GDC project.\n- \u003cvar translate=\"no\"\u003eRESTORE_REQUEST_NAME\u003c/var\u003e: the name of the restore request that is being initiated.\n- \u003cvar translate=\"no\"\u003eRESTORE_NAME\u003c/var\u003e: the name to give the restore that is being initiated.\n- \u003cvar translate=\"no\"\u003eRESTORE_PREFIX\u003c/var\u003e: a prefix that is appended to the start of the name for backups that this request restores.\n- \u003cvar translate=\"no\"\u003eRESTORED_RESOURCE_DESCRIPTION\u003c/var\u003e: description of why the restore is performed.\n\nThe result of the restore creates a new disk with the same configuration and\ndisk state as the snapshot, completing the data backup and recovery process.\n\nView a restore\n--------------\n\nView a restore using the GDC console or `kubectl` command-line interface\n(CLI). \n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Virtual Machines \\\u003e Snapshots**.\n3. Select a project.\n4. Click the **Restores** tab.\n5. In the list of restores, click the restore name to view its details.\n\n### kubectl\n\nView a restore by listing the restores and viewing their details:\n\n1. List the existing snapshots:\n\n kubectl get virtualmachinerestores.virtualmachine.gdc.goog -n \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e with the name of the project.\n2. In the list, find the restore that you want to view.\n\n3. View the restore details:\n\n kubectl describe virtualmachinerestore.virtualmachine.gdc.goog \u003cvar translate=\"no\"\u003eRESTORE_NAME\u003c/var\u003e -n \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eRESTORE_NAME\u003c/var\u003e: the name of the restore.\n - \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e: the name of the project.\n\nDelete a restore\n----------------\n\nDelete a restore by using the GDC console or `kubectl` command-line interface\n(CLI). \n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Virtual Machines**.\n3. Select a project.\n4. Click the **Restores** tab.\n5. In the list of restores, find the restore to delete and click **Delete Restore**.\n6. In the **Restore name** field, enter the name of the restore to delete.\n7. Click **Delete Restore**.\n\n### kubectl\n\nView a restore by listing the restores and viewing their details:\n\n1. List the existing restores:\n\n kubectl get virtualmachinerestores.virtualmachine.gdc.goog -n \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e with the name of the project.\n2. In the list, find the restore that you want to delete.\n\n3. Delete the restore:\n\n kubectl delete virtualmachinerestores.virtualmachine.gdc.goog \u003cvar translate=\"no\"\u003eRESTORE_NAME\u003c/var\u003e -n \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eRESTORE_NAME\u003c/var\u003e: the name of the restore.\n - \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e: the name of the project.\n\nWhat's next\n-----------\n\n- [Clean up labels after restoring VM-attached disks](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/vm-backup/clean-up-labels-after-restore)"]]