Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment restaurer un disque de machine virtuelle (VM) à partir d'un instantané de disque d'image créé à l'aide des procédures de sauvegarde et de restauration Google Distributed Cloud (GDC) air-gapped.
Avant de commencer
Pour restaurer un disque de VM à partir d'un instantané, vous devez disposer des éléments suivants :
Administrateur VirtualMachine du projet : gère les VM dans l'espace de noms du projet. Demandez à votre administrateur IAM de projet de vous attribuer le rôle Administrateur de machines virtuelles du projet (project-vm-admin).
Backup Creator : crée des sauvegardes manuelles et les restaure. Demandez à votre administrateur IAM de projet de vous accorder le rôle Créateur de sauvegardes (backup-creator).
Lecteur du projet : dispose d'un accès en lecture seule à toutes les ressources des espaces de noms du projet. Demandez à votre administrateur de projet IAM de vous accorder le rôle Lecteur de projet (project-viewer).
Restaurer un instantané
Créez une VM à partir d'un instantané de disque à l'aide de la console GDC ou de l'interface de programmation d'application (API).
Console
Connectez-vous à la console GDC.
Dans le menu de navigation, cliquez sur Machines virtuelles > Instantanés.
Sélectionnez un projet.
Dans la liste des instantanés, recherchez celui à restaurer, puis cliquez sur Restaurer.
Dans le champ Nom du nouveau disque, saisissez le nom du disque sur lequel restaurer la sauvegarde.
Saisissez un nom de restauration.
Cliquez sur Restaurer.
API
Créez une ressource personnalisée VirtualMachineRestoreRequest pour lancer le processus de restauration.
La restauration de la capacité de l'application dépend du système d'exploitation ou de l'image de la VM.
Créez une ressource personnalisée VirtualMachineRestoreRequest pour lancer le processus de restauration :
VM_BACKUP_NAME : nom de la ressource VirtualMachineBackup à partir de laquelle effectuer la restauration.
PROJECT_NAME : nom du projet GDC.
RESTORE_REQUEST_NAME : nom de la demande de restauration en cours d'initialisation.
RESTORE_NAME : nom à attribuer à la restauration en cours d'initialisation.
RESTORE_PREFIX : préfixe ajouté au début du nom des sauvegardes que cette requête restaure.
RESTORED_RESOURCE_DESCRIPTION : description de la raison pour laquelle la restauration est effectuée.
La restauration crée un disque avec la même configuration et le même état que l'instantané, ce qui termine le processus de sauvegarde et de récupération des données.
Afficher une restauration
Affichez une restauration à l'aide de la console GDC ou de l'interface de ligne de commande (CLI) kubectl.
Console
Connectez-vous à la console GDC.
Dans le menu de navigation, cliquez sur Machines virtuelles > Instantanés.
Sélectionnez un projet.
Cliquez sur l'onglet Restaurations.
Dans la liste des restaurations, cliquez sur le nom de la restauration pour afficher ses détails.
kubectl
Affichez une restauration en listant les restaurations et en consultant leurs détails :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)"]]