Créer et gérer des instantanés immédiats

---

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document explique comment créer et gérer des instantanés immédiats. Les instantanés immédiats capturent le contenu d'un disque et peuvent être utilisés pour créer un nouveau disque en quelques minutes.

Vous ne pouvez créer un instantané immédiat d'un disque que si le disque est associé à une instance de machine virtuelle (VM) en cours d'exécution. Le disque doit également être associé en mode lecture-écriture.

Les instantanés immédiats sont stockés dans la même zone ou région que leurs disques sources et ne remplacent pas les instantanés standards, qui offrent une sauvegarde hors site pour la reprise après sinistre. Découvrez les autres options de protection des données disponibles dans Compute Engine.

Pour accéder aux données d'un instantané immédiat, utilisez l'instantané immédiat pour créer un disque.

Si vous souhaitez copier un instantané immédiat sur un autre emplacement, créez un instantané standard à partir de l'instantané immédiat.

Avant de commencer

• Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :
  

  Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

  Console

  Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.

  gcloud

  1. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :

     gcloud init

     Remarque : Si vous avez déjà installé gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.
  2. Définissez une région et une zone par défaut.

  REST

  Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

  Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :

  gcloud init

Restrictions

Pour vous assurer que les instantanés immédiats sont adaptés à votre cas d'utilisation, consultez les limites associées aux instantanés immédiats.

Créer un instantané immédiat d'un volume de disque persistant

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instantSnapshots.create

Les instantanés immédiats de disques zonaux sont stockés dans la même zone que le disque source. De même, les instantanés immédiats de disques régionaux sont stockés dans les mêmes régions que le disque.

Vous pouvez créer un instantané immédiat d'un volume de disque persistant zonal ou régional à l'aide de la gcloud CLI, de la console Google Cloud ou de REST.

Console

1. Dans la console Google Cloud, accédez à la page Instances de VM.

   Accéder à la page "Instances de VM"

2. Sélectionnez le projet avec lequel vous souhaitez travailler.

3. Dans la colonne Nom, cliquez sur le nom de la VM associée au disque que vous souhaitez sauvegarder.

4. Dans la section Stockage, sélectionnez l'une des options suivantes :

   • Pour sauvegarder le disque de démarrage de la VM, dans la section Disque de démarrage, cliquez sur le Nom du disque de démarrage souhaité.
   • Pour sauvegarder un volume de disque persistant associé, dans la section Disques supplémentaires, cliquez sur le Nom du volume de disque persistant associé souhaité.

5. Pour terminer la création d'un instantané immédiat, procédez comme suit sur la page Créer un instantané :

   1. Dans le champ Nom, saisissez un nom unique pour identifier l'instantané immédiat.
   2. Facultatif : ajoutez des informations supplémentaires sur l'instantané dans le champ Description.
   3. Dans le champ Type, sélectionnez Instantané immédiat. Le champ Emplacement est automatiquement défini sur la même zone ou région que le disque.
   4. Dans le champ Type de source d'instantané, vérifiez que l'option Disque est sélectionnée.
   5. Facultatif : pour organiser votre projet, ajoutez un ou plusieurs libellés.
   6. Cliquez sur Créer.

gcloud

1. Dans la console Google Cloud, activez Cloud Shell.

   Activer Cloud Shell

   En bas de la fenêtre de la console Google Cloud, une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

2. Pour créer un instantané immédiat, exécutez la commande gcloud beta compute instant-snapshots create :

   Disque zonal

   gcloud beta compute instant-snapshots create INSTANT_SNAPSHOT_NAME \
      --source-disk=SOURCE_DISK_NAME \
      --zone=SOURCE_DISK_ZONE
   

   Remplacez les éléments suivants :

   • INSTANT_SNAPSHOT_NAME : nom unique de l'instantané immédiat.
   • SOURCE_DISK_NAME : nom du disque source.
   • SOURCE_DISK_ZONE : zone du disque source. L'instantané immédiat sera créé dans la même zone.

   Disque régional

   gcloud beta compute instant-snapshots create INSTANT_SNAPSHOT_NAME \
      --source-disk=SOURCE_DISK_NAME \
      --region=SOURCE_DISK_REGION
   

   Remplacez les éléments suivants :

   • INSTANT_SNAPSHOT_NAME : nom unique de l'instantané immédiat.
   • SOURCE_DISK_NAME : nom du disque source.
   • SOURCE_DISK_REGION : région du disque source. L'instantané immédiat sera créé dans la même région.

REST

Pour créer un instantané immédiat, envoyez une requête POST à la méthode instantSnapshots.insert.

• Créez un instantané immédiat d'un disque zonal :

  Spécifiez la zone dans l'URL de la requête POST. Dans le corps de la requête, spécifiez un nom pour le nouvel instantané ainsi que l'URL du disque source.

   POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/DISK_ZONE/instantSnapshots
   {
      "name": "INSTANT_SNAPSHOT_NAME",
      "sourceDisk": "projects/PROJECT_ID/zones/DISK_ZONE/disks/SOURCE_DISK_NAME"
   }
   

  Remplacez les éléments suivants par les valeurs correspondantes :
  • PROJECT_ID : nom du projet contenant le disque.
  • DISK_ZONE : zone dans laquelle se trouve le disque. L'instantané immédiat sera créé dans cette zone.
  • INSTANT_SNAPSHOT_NAME : nom unique de l'instantané immédiat.
  • SOURCE_DISK_NAME : nom du disque source.

• Créez un instantané immédiat d'un disque régional :

  Spécifiez la région dans l'URL de la requête POST. Incluez le nom et le disque source du nouvel instantané dans le corps de la requête.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/DISK_REGION/instantSnapshots
         {
            "name": "INSTANT_SNAPSHOT_NAME",
            "sourceDisk": "projects/PROJECT_ID/regions/DISK_REGION/disks/SOURCE_DISK_NAME"
         }
   

  Remplacez les éléments suivants dans le corps de la requête par les valeurs correspondantes :
  • PROJECT_ID : nom du projet contenant le disque.
  • DISK_REGION : région où se trouve le disque source. L'instantané sera créé dans la même région.
  • INSTANT_SNAPSHOT_NAME : nom unique de l'instantané.
  • SOURCE_DISK_NAME : nom du disque source.

Réponse de requête

Si la requête POST aboutit, le corps de la réponse est un objet que vous pouvez interroger pour obtenir l'état de création de l'instantané immédiat. Pour en savoir plus, consultez la page Gérer les réponses de l'API.

Restaurer un instantané immédiat sur un nouveau volume de disque persistant

Pour restaurer des données sauvegardées avec un instantané immédiat, créez un disque à partir de l'instantané immédiat.

Afficher les instantanés immédiats dans un projet ou un emplacement

Vous pouvez afficher la liste de tous les instantanés immédiats d'un projet ou d'un emplacement à l'aide de la gcloud CLI, de la console Google Cloud ou de REST.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instantSnapshots.list sur le projet

Console

1. Dans Google Cloud Console, accédez à la page Instantanés.

   Accéder à la page Instantanés

2. Cliquez sur l'onglet Instantanés immédiats. La liste des instantanés immédiats s'affiche.

3. (Facultatif) Affinez vos résultats à l'aide du champ Filtre. Saisissez un nom ou une valeur de propriété dans le champ Filtre, ou choisissez parmi les propriétés disponibles.

gcloud

Vous pouvez répertorier les instantanés immédiats dans un projet ou un emplacement spécifique à l'aide de la commande gcloud beta compute instant-snapshots list.

1. Dans la console Google Cloud, activez Cloud Shell.

   Activer Cloud Shell

   En bas de la fenêtre de la console Google Cloud, une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

2. Répertoriez tous les instantanés d'un projet ou tous les instantanés d'une zone ou d'une région :

   • Répertoriez tous les instantanés immédiats d'un projet particulier :

     gcloud beta compute instant-snapshots list --project=PROJECT_ID
     

     Remplacez PROJECT_ID par l'ID du projet.

   • Répertoriez les instantanés immédiats dans une zone avec l'argument --zones :

     gcloud beta compute instant-snapshots list --zones=ZONE
     

     Remplacez ZONE par le nom de la zone cible.

   • Répertoriez les instantanés immédiats régionaux dans une région à l'aide de l'argument --regions :

     gcloud beta compute instant-snapshots list --regions=REGION
     

     Remplacez REGION par le nom de la région cible.

REST

Vous pouvez récupérer la liste des instantanés immédiats dans un projet ou un emplacement spécifique.

• Répertoriez les instantanés dans un projet :

  Envoyez une requête GET à la méthode instantSnapshots.aggregatedList :

      GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/instantSnapshots
   

  Remplacez PROJECT_ID par l'ID du projet.

• Répertoriez les instantanés immédiats dans une zone ou une région :

  Envoyez une requête GET à la méthode instantSnapshots.list.

  • Répertoriez les instantanés immédiats dans une zone :

      GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/SOURCE_ZONE//instantSnapshots
  

  Remplacez ce qui suit : - PROJECT_ID : ID du projet. - SOURCE_ZONE : zone cible, par exemple "us-west1-a". + Répertoriez les instantanés iimmédiats régionaux dans une région :

      GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/SOURCE_REGION/instantSnapshots
  

  Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • SOURCE_REGION : région cible, par exemple us-west1.

Afficher les instantanés immédiats d'un disque

Vous pouvez afficher la liste des instantanés immédiats d'un disque à l'aide de la gcloud CLI, de la console Google Cloud ou de REST.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• compute.instantSnapshots.list sur le projet

Console

1. Dans Google Cloud Console, accédez à la page Instantanés.

   Accéder à la page Instantanés

2. Cliquez sur l'onglet Instantanés immédiats. La liste de tous les instantanés immédiats du projet s'affiche.

3. Filtrez les résultats par disque source :

   1. Saisissez Source disk: dans le champ Filtre filter_list.

      La liste des disques avec des instantanés immédiats s'affiche.

   2. Sélectionnez le nom du disque dans la liste Valeurs. La liste des instantanés immédiats affiche tous les instantanés immédiats du disque.

      Si vous ne voyez pas le nom d'un disque dans le champ Filtre filter_list, saisissez les premières lettres du nom du disque afin de modifier la liste d'options filtrées qui s'affiche.

gcloud

1. Dans la console Google Cloud, activez Cloud Shell.

   Activer Cloud Shell

   En bas de la fenêtre de la console Google Cloud, une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

2. Répertoriez les instantanés immédiats d'un disque à l'aide de la commande gcloud beta compute instant-snapshots list et de l'argument --filter :

   • Répertoriez les instantanés immédiats pour un disque zonal :

     gcloud beta compute instant-snapshots list
     --filter="sourceDisk:projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
     

     Remplacez les éléments suivants :

     • PROJECT_ID : ID du projet.
     • ZONE : nom de la zone pour le disque, par exemple, us-west1-a.
     • DISK_NAME : nom du disque source, par exemple disk-1.

   • Répertoriez les instantanés immédiats pour un disque régional :

     gcloud beta compute instant-snapshots list
        --filter=sourceDisk:projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME
     

   Remplacez les éléments suivants :

   • PROJECT_ID : ID du projet.
   • SOURCE_REGION : nom de la région pour le disque, par exemple us-west1.
   • DISK_NAME : nom du disque, par exemple disk-1.

REST

Répertoriez les instantanés immédiats pour un disque zonal ou régional en envoyant une requête GET à la méthode instantSnapshots.list.

Utilisez le paramètre de requête filter=sourceDisk pour spécifier le nom du disque.

• Répertoriez les instantanés immédiats pour un volume de disque persistant zonal :

  GET https://compute.googleapis.com/compute/beta/projects/<var>PROJECT_ID</var>/zones/<var>SOURCE_ZONE/</var>/instantSnapshots?filter=sourceDisk:'https://www.googleapis.com/compute/beta/projects/<var>PROJECT_ID</var>/zones/<var>SOURCE_ZONE</var>/disks/<var>DISK_NAME</var>'
  

  Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • SOURCE_ZONE : zone cible, par exemple us-west1-a.
  • DISK_NAME : nom du disque source, par exemple disk-1.

• Répertoriez les instantanés immédiats pour un volume de disque persistant régional :

  GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/SOURCE_REGION//instantSnapshots?filter=sourceDisk:'https://www.googleapis.com/compute/beta/projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME'

  Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • SOURCE_REGION : région cible, par exemple us-west1.
  • DISK_NAME : nom du disque source, par exemple disk-1.

Afficher les informations sur un instantané immédiat

Récupérez des informations détaillées sur un instantané immédiat, telles que son emplacement, son disque source et sa taille, à l'aide de la gcloud CLI, de la console Google Cloud ou de REST.

Console

1. Dans Google Cloud Console, accédez à la page Instantanés.

   Accéder à la page Instantanés

2. Cliquez sur l'onglet Instantanés immédiats. La liste des instantanés immédiats s'affiche.

3. Dans la colonne Nom, cliquez sur le nom de l'instantané immédiat. La page Détails de l'instantané immédiat de l'instantané sélectionné s'affiche, indiquant ses propriétés.

gcloud

1. Dans la console Google Cloud, activez Cloud Shell.

   Activer Cloud Shell

   En bas de la fenêtre de la console Google Cloud, une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

2. Pour afficher des informations sur un instantané immédiat, utilisez la commande gcloud beta compute instant-snapshots describe.

   • Si l'instantané est basé sur un disque zonal, spécifiez la zone avec l'option --zone :

     gcloud beta compute instant-snapshots describe INSTANT_SNAPSHOT_NAME  \
        --zone=ZONE
     

     Remplacez les éléments suivants par les valeurs correspondantes :

     • INSTANT_SNAPSHOT_NAME : nom de l'instantané immédiat.
     • ZONE : zone dans laquelle l'instantané immédiat a été créé, par exemple us-west1-a.

   • Si l'instantané provient d'un disque régional, spécifiez la région avec l'option --region :

     gcloud beta compute instant-snapshots describe INSTANT_SNAPSHOT_NAME \
     --region=REGION
     

     Remplacez les éléments suivants par les valeurs correspondantes :

     • INSTANT_SNAPSHOT_NAME : nom de l'instantané immédiat.
     • REGION : région dans laquelle l'instantané a été créé, par exemple us-central1.

REST

La requête de méthode API que vous utilisez varie selon que vous utilisez un instantané immédiat régional ou zonal.

Instantané immédiat zonal

Envoyez une requête GET à la méthode instantSnapshots.get en spécifiant la zone dans la requête :

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instantSnapshots/INSTANT_SNAPSHOT_NAME

Remplacez les éléments suivants par les valeurs correspondantes :

• PROJECT_ID : nom du projet contenant l'instantané immédiat.
• ZONE : zone dans laquelle l'instantané immédiat a été créé.
• INSTANT_SNAPSHOT_NAME : nom de l'instantané immédiat.

Instantané immédiat régional

Envoyez une requête GET à la méthode instantSnapshots.get en spécifiant la région dans la requête :

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instantSnapshots/INSTANT_SNAPSHOT_NAME

Remplacez les éléments suivants par les valeurs correspondantes :

• PROJECT_ID : nom du projet contenant l'instantané immédiat.
• REGION : région dans laquelle l'instantané immédiat a été créé.
• INSTANT_SNAPSHOT_NAME : nom de l'instantané immédiat.

Supprimer un instantané immédiat

Vous pouvez supprimer un instantané immédiat à l'aide de la gcloud CLI, de la console Google Cloud ou de REST.

Console

1. Dans Google Cloud Console, accédez à la page Instantanés.

   Accéder à la page Instantanés

2. Cliquez sur l'onglet Instantanés immédiats.

3. Sélectionnez un ou plusieurs instantanés à supprimer.

4. En haut de la page Instantanés, cliquez sur Supprimer.

gcloud

Supprimez un instantané immédiat à l'aide de la commande gcloud beta compute instant-snapshots delete, en spécifiant la zone source ou la région source.

• Supprimez un instantané immédiat d'un disque zonal :

  gcloud beta compute instant-snapshots delete INSTANT_SNAPSHOT_NAME \
      --zone=ZONE
   

  Remplacez les éléments suivants par les valeurs correspondantes :

  • ZONE : nom de la zone.
  • INSTANT_SNAPSHOT_NAME : nom de l'instantané immédiat.

• Supprimez un instantané immédiat d'un disque régional :

  gcloud beta compute instant-snapshots delete INSTANT_SNAPSHOT_NAME \
     --region=REGION
  

  Remplacez les éléments suivants :

  • REGION : nom de la région.
  • INSTANT_SNAPSHOT_NAME : nom de l'instantané immédiat.

REST

Supprimez un instantané immédiat avec une requête DELETE à la méthode instantSnapshots.delete :

• Supprimez un instantané immédiat d'un disque zonal :

  DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instantSnapshots/INSTANT_SNAPSHOT_NAME
  

  Remplacez les éléments suivants par les valeurs correspondantes :

  • PROJECT_ID : ID du projet.
  • ZONE : nom de la zone.
  • INSTANT_SNAPSHOT_NAME : nom de l'instantané immédiat.

• Supprimez un instantané immédiat d'un disque régional :

  DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instantSnapshots/INSTANT_SNAPSHOT_NAME

  Remplacez les éléments suivants par les valeurs correspondantes :

  • PROJECT_ID : ID du projet.
  • REGION : nom de la région.
  • INSTANT_SNAPSHOT_NAME : nom de l'instantané immédiat.

Modifier l'emplacement de stockage d'un instantané immédiat

Un instantané immédiat est toujours stocké au même emplacement que le disque source. Vous ne pouvez pas rendre un instantané immédiat accessible depuis une autre zone ou région. Au lieu de cela, vous pouvez créer un instantané standard à partir de l'instantané immédiat et utiliser cet instantané standard.

Apprenez à créer un instantané standard à partir d'un instantané immédiat.

Dépannage

Consultez la page Résoudre les problèmes liés aux instantanés immédiats pour résoudre les problèmes que vous rencontrez.