Pour éviter qu'un instantané récupérable (c'est-à-dire un instantané standard supprimé qui se trouve dans la corbeille) ne soit définitivement effacé, restaurez-le depuis la corbeille avant l'expiration de sa période de conservation. Lorsque vous récupérez un instantané, il devient un instantané standard utilisable que vous pouvez utiliser pour créer un disque.
Ce document explique comment lister, récupérer et supprimer des instantanés récupérables.
Pour en savoir plus sur la corbeille, consultez Conserver les ressources supprimées dans la corbeille.
Avant de commencer
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification permet de valider votre identité pour accéder aux services et aux API Cloud de Confiance by S3NS . Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :
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 Cloud de Confiance pour accéder aux services Cloud de Confiance by S3NS et aux API, vous n'avez pas besoin de configurer l'authentification.
gcloud
-
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez la Google Cloud CLI en exécutant la commande suivante :
gcloud init
-
- Définissez une région et une zone par défaut.
REST
Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée.
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Cloud de Confiance .
Rôles et autorisations nécessaires
Pour obtenir les autorisations nécessaires pour gérer les instantanés récupérables, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :
- Administrateur d'instances Compute (
roles/compute.instanceAdmin) -
Pour vous connecter à une VM pouvant s'exécuter en tant que compte de service : Utilisateur du compte de service (v1) (
roles/iam.serviceAccountUser)
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ces rôles prédéfinis contiennent les autorisations requises pour gérer les instantanés récupérables. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour gérer les instantanés récupérables :
-
Pour récupérer un instantané récupérable :
compute.recoverableSnapshots.recoversur l'instantané -
Pour afficher des informations sur un instantané récupérable :
compute.recoverableSnapshots.getsur l'instantané -
Pour supprimer définitivement un instantané récupérable :
compute.recoverableSnapshots.deletesur l'instantané -
Pour lister les instantanés récupérables dans un projet :
compute.recoverableSnapshots.listsur le projet
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Limites
- Ressources compatibles : seules les instantanés standards sont acceptés. Les instantanés d'archive, les instantanés immédiats, les disques et les images sont immédiatement et définitivement effacés lors de leur suppression.
- Conflits de noms : la récupération d'un instantané échouera si un instantané standard portant le même nom existe déjà et que vous ne fournissez pas de nouveau nom pour l'instantané récupéré. Pour récupérer un tel instantané, vous devez utiliser la Google Cloud CLI ou REST pour spécifier un nouveau nom.
- Persistance des tags : les tags associés à un instantané avant sa suppression ne sont pas conservés si l'instantané est restauré depuis la corbeille. Vous devez rajouter les tags à l'instantané après l'avoir récupéré dans la corbeille.
- Modifications de la règle de conservation : les modifications apportées à la règle de conservation de la corbeille ne s'appliquent pas aux instantanés récupérables existants, c'est-à-dire aux instantanés standards supprimés existants qui se trouvent dans la corbeille.
- Instantanés programmés : si vous récupérez un instantané qui a été créé à l'origine selon une programmation, il ne fait plus partie de la programmation et n'est pas supprimé automatiquement après la durée spécifiée par la programmation. Au lieu de cela, Compute Engine conserve l'instantané indéfiniment jusqu'à ce que vous le supprimiez manuellement.
- Clés de chiffrement gérées par le client (CMEK) : si vous révoquez la clé CMEK qui protège un instantané récupérable, puis que vous récupérez l'instantané, vous ne pouvez pas l'utiliser pour créer un disque tant que vous n'avez pas restauré la clé. Si vous ne récupérez pas l'instantané avant l'expiration de la période de conservation, Compute Engine l'efface définitivement.
- Récupération requise avant utilisation : les instantanés récupérables sont en lecture seule. Pour utiliser un instantané récupérable afin de créer un disque, vous devez d'abord récupérer l'instantané standard à partir de la corbeille.
Lister les instantanés récupérables
Pour afficher les instantanés récupérables d'un projet, utilisez la console Cloud de Confiance , la gcloud CLI ou REST.
Console Cloud de Confiance
Dans la console Cloud de Confiance , accédez à la page Instantanés.
Cliquez sur Corbeille.
Cliquez sur l'onglet Instantanés supprimés. La liste des instantanés récupérables s'affiche.
Chaque colonne liste des informations sur les instantanés récupérables, y compris les suivantes :
- Nom : nom de l'instantané récupérable.
- Nom d'origine de l'instantané : nom de l'instantané standard d'origine.
- Heure de suppression de l'instantané : heure à laquelle l'instantané standard d'origine a été supprimé.
- Heure de suppression définitive : heure à laquelle Compute Engine supprimera définitivement l'instantané récupérable.
CLI gcloud
Pour lister tous les instantanés de la corbeille d'un projet, utilisez la commande gcloud beta compute recoverable-snapshots list.
Pour inclure des informations supplémentaires sur chaque instantané récupérable, utilisez l'option --format.
Par exemple, la commande suivante liste chaque instantané récupérable d'un projet et inclut des informations détaillées sur chacun d'eux :
gcloud beta compute recoverable-snapshots list \ --project=PROJECT_ID \ --format="yaml(name, creationTimestamp, purgeTimestamp, originalResource)"
Remplacez PROJECT_ID par l'ID du projet.
Le résultat est une liste des instantanés récupérables dans le projet, semblable à ce qui suit :
creationTimestamp: '2026-09-01T11:13:50.716-07:00'
name: data-disk-snapshot-20260805-qlb6lyqw
purgeTimestamp: '2026-09-06T11:13:50.609-07:00'
originalResource:
...
name: data-disk-snapshot-20260805
...
sourceDisk: projects/my-project/global/disks/data-disk
---
creationTimestamp: '2026-09-01T12:13:50.229-07:00'
name: disk-snapshot-20260901191347-s0c24h1m
purgeTimestamp: '2026-09-06T12:13:50.070-07:00'
originalResource:
...
name: disk-snapshot-20260901191347
...
sourceDisk: projects/my-project/global/disks/my-disk
---
Le résultat liste les propriétés clés suivantes de chaque instantané récupérable :
name: nom de l'instantané récupérable. Pour récupérer l'instantané, vous devez spécifier ce nom si vous utilisez gcloud CLI ou REST.creationTimestamp: heure à laquelle l'instantané standard d'origine a été supprimé.purgeTimestamp: heure à laquelle Compute Engine supprimera définitivement l'instantané récupérable.originalResource: objet contenant des informations sur l'instantané d'origine, y compris son nom et son disque source.
REST
Envoyez une requête GET à la méthode recoverableSnapshots list.
GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/recoverableSnapshots/
Remplacez PROJECT_ID par l'ID du projet.
Le corps de la réponse JSON contient une liste des instantanés récupérables dans le projet, semblable à ce qui suit :
{
"kind": "compute#recoverableSnapshotList",
"id": "projects/PROJECT_ID/global/recoverableSnapshots/",
"items": [
{
"name": "prod-test-snapshot-20260905053732-uj731vz4",
"creationTimestamp": "2026-09-05T22:37:34.164-07:00",
"purgeTimestamp": "2026-09-12T22:37:32.918-07:00",
...
"originalResource": {
"id": "3004584137782651782",
"creationTimestamp": "2025-10-05T22:36:41.868-07:00",
"name": "prod-test-snapshot"
...
}
},
{
"kind": "compute#recoverableSnapshot",
"id": "8914891425536994162",
"name": "my-test-snapshot-20260906053732-uj731vz5",
"creationTimestamp": "2026-09-05T22:37:34.164-07:00",
"purgeTimestamp": "2026-09-12T22:37:32.918-07:00",
...
"originalResource": {
"id": "39904584137782651782",
"creationTimestamp": "2026-08-05T22:36:41.868-07:00",
"name": "my-test-snapshot"
...
}
}
]
}
Le résultat liste les propriétés clés suivantes de chaque instantané récupérable :
name: nom de l'instantané récupérable. Pour récupérer l'instantané, vous devez spécifier ce nom si vous utilisez gcloud CLI ou REST.creationTimestamp: heure à laquelle l'instantané standard d'origine a été supprimé.purgeTimestamp: heure à laquelle Compute Engine supprimera définitivement l'instantané récupérable.originalResource: objet contenant des informations sur l'instantané d'origine, y compris son nom et son disque source.
Rechercher un instantané récupérable par le nom de l'instantané d'origine
Pour trouver un instantané récupérable et le restaurer, vous pouvez utiliser le nom de l'instantané d'origine. Les instantanés récupérables ont un nom unique que Compute Engine génère lorsque vous supprimez l'instantané d'origine.
Pour trouver le nom de l'instantané récupérable, listez les instantanés récupérables et filtrez-les par nom d'instantané d'origine.
Vous pouvez utiliser la console Cloud de Confiance , gcloud CLI ou REST.
Console Cloud de Confiance
Dans la console Cloud de Confiance , accédez à la page Instantanés.
Cliquez sur Corbeille.
Cliquez sur l'onglet Instantanés supprimés. La liste des instantanés récupérables s'affiche.
Dans le champ Filtre filter_list , cliquez sur Saisir le nom ou la valeur de la propriété. Sélectionnez Nom de l'instantané d'origine dans la liste des propriétés.
Saisissez le nom du snapshot d'origine dans le champ Valeur, puis appuyez sur Entrée.
La console Cloud de Confiance affiche la liste des instantanés récupérables dont l'instantané d'origine porte le nom que vous avez saisi.
CLI gcloud
Pour trouver un instantané récupérable par son nom d'origine, utilisez la commande gcloud beta compute recoverable-snapshots list. Pour filtrer par nom d'instantané d'origine, utilisez l'indicateur --filter pour la propriété originalResource.name.
gcloud beta compute recoverable-snapshots list \ --project=PROJECT_ID \ --filter="originalResource.name:ORIGINAL_SNAPSHOT_NAME" \ --format="yaml(name, creationTimestamp, purgeTimestamp)"
Remplacez les éléments suivants par les valeurs correspondantes :
PROJECT_ID: ID du projetORIGINAL_SNAPSHOT_NAME: nom d'origine de l'instantané.
La sortie est une liste des instantanés récupérables dont le nom correspond à celui de l'instantané d'origine que vous avez saisi, comme suit :
creationTimestamp: '2026-09-01T11:13:50.716-07:00'
name: disk-20260805-09550-us-central1-a-202-20260901181348-qlb6lyqw
purgeTimestamp: '2026-09-06T11:13:50.609-07:00'
---
creationTimestamp: '2026-09-01T12:13:50.229-07:00'
name: disk-20260805-09550-us-central1-a-202-20260901191347-s0c24h1m
purgeTimestamp: '2026-09-06T12:13:50.070-07:00'
---
creationTimestamp: '2026-09-01T13:13:51.060-07:00'
name: disk-20260805-09550-us-central1-a-202-20260901201348-ogybudsu
purgeTimestamp: '2026-09-06T13:13:50.904-07:00'
Pour filtrer par heure de création ou de suppression de l'instantané d'origine, étendez l'expression --filter :
- Pour filtrer les résultats par heure de création du snapshot d'origine, ajoutez une condition pour
originalResource.creationTimestampà l'expression--filter. Par exemple, pour trouver les instantanés récupérables d'un instantané d'origine créé à partir d'une heure spécifique :
--filter="originalResource.creationTimestamp >= 'CREATION_FILTER_TIMESTAMP' AND originalResource.name:ORIGINAL_SNAPSHOT_NAME"
Remplacez les éléments suivants :
ORIGINAL_SNAPSHOT_NAME: nom de l'instantané d'origine.CREATION_FILTER_TIMESTAMP: code temporel du filtre, par exemple2026-09-01T10:00:00. L'horodatage est exprimé en heure locale.Pour filtrer les résultats en fonction de la date de suppression du snapshot d'origine, ajoutez une condition pour
creationTimestampà l'expression--filter. Par exemple, pour trouver les instantanés récupérables d'un instantané d'origine spécifique qui a été supprimé à une date ou une heure donnée :
--filter="creationTimestamp >= 'DELETION_FILTER_TIMESTAMP' AND originalResource.name:ORIGINAL_SNAPSHOT_NAME"
Remplacez les éléments suivants :
ORIGINAL_SNAPSHOT_NAME: nom de l'instantané d'origine.DELETION_FILTER_TIMESTAMP: code temporel du filtre, par exemple2026-09-01T10:00:00. L'horodatage est exprimé en heure locale.
REST
Envoyez une requête GET à la méthode recoverableSnapshots.list à l'aide du paramètre de requête filter.
GET 'https://compute.s3nsapis.fr/compute/beta/projects/ PROJECT_ID/global/recoverableSnapshots?filter=originalResource.name:ORIGINAL_SNAPSHOT_NAME'
Remplacez les éléments suivants par les valeurs correspondantes :
PROJECT_ID: ID du projetORIGINAL_SNAPSHOT_NAME: nom d'origine de l'instantané.
Le corps de la réponse est une liste des instantanés récupérables dont le nom d'origine correspond à celui que vous avez saisi, comme suit :
{
"kind": "compute#recoverableSnapshotList",
"id": "projects/PROJECT_ID/global/recoverableSnapshots/",
"items": [
{
"kind": "compute#recoverableSnapshot",
"id": "8914891425536994161",
"name": "prod-test-snapshot-20261006053732-uj731vz4",
"creationTimestamp": "2026-10-05T22:37:34.164-07:00",
"purgeTimestamp": "2026-10-12T22:37:32.918-07:00",
...
"originalResource": {
"name": "prod-test-snapshot",
...
}
}
]
}
Chaque objet du tableau items représente un instantané récupérable et possède les propriétés suivantes :
name: nom de l'instantané récupérable. Pour récupérer l'instantané, vous devez spécifier ce nom si vous utilisez gcloud CLI ou REST.creationTimestamp: heure à laquelle l'instantané standard d'origine a été supprimé.purgeTimestamp: heure à laquelle Compute Engine supprimera définitivement l'instantané récupérable.originalResource: objet contenant des informations sur l'instantané d'origine, y compris son nom et son disque source.
Afficher les informations sur un instantané récupérable
Pour récupérer des informations détaillées sur un instantané récupérable, comme son instantané source ou son heure de création, utilisez la console Cloud de Confiance , la gcloud CLI ou REST.
Pour trouver le nom d'un instantané récupérable si vous ne disposez que du nom de l'instantané d'origine, consultez Trouver le nom d'un instantané récupérable.
Console Cloud de Confiance
Dans la console Cloud de Confiance , accédez à la page Instantanés.
Cliquez sur Corbeille.
Dans l'onglet Instantanés supprimés, affichez la liste des instantanés récupérables.
Chaque colonne liste des informations sur un instantané récupérable, y compris les suivantes :
- Nom : nom de l'instantané récupérable.
- Nom d'origine de l'instantané : nom de l'instantané standard d'origine.
- Heure de suppression de l'instantané : heure à laquelle l'instantané standard d'origine a été supprimé.
- Heure de suppression définitive : heure à laquelle Compute Engine supprimera définitivement l'instantané récupérable.
CLI gcloud
Pour afficher des informations sur un instantané récupérable, utilisez la commande gcloud beta compute recoverable-snapshots describe.
gcloud beta compute recoverable-snapshots describe RECOVERABLE_SNAPSHOT_NAME \ --project=PROJECT_ID
Remplacez les éléments suivants par les valeurs correspondantes :
RECOVERABLE_SNAPSHOT_NAME: nom de l'instantané récupérable.PROJECT_ID: ID du projet
Le résultat est une description du snapshot récupérable, semblable à ce qui suit :
creationTimestamp: '2026-09-01T13:13:51.626-07:00'
id: '2573728532034916112'
kind: compute#recoverableSnapshot
name: prod-test-snapshot-uj731vz4
originalResource:
name: prod-test-snapshot
...
storageBytesStatus: UP_TO_DATE
storageLocations:
- us
purgeTimestamp: '2026-09-06T13:13:51.493-07:00'
selfLink: ..
status: READY
Le résultat inclut les propriétés clés suivantes de l'instantané récupérable :
name: nom de l'instantané récupérable. Pour récupérer l'instantané, vous devez spécifier ce nom si vous utilisez gcloud CLI ou REST.creationTimestamp: heure à laquelle l'instantané standard d'origine a été supprimé.purgeTimestamp: heure à laquelle Compute Engine supprimera définitivement l'instantané récupérable.originalResource: objet contenant des informations sur l'instantané d'origine, y compris son nom et son disque source.
REST
Pour afficher des informations sur un instantané récupérable, envoyez une requête GET à la méthode recoverableSnapshots.get.
GET 'https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/recoverableSnapshots/RECOVERABLE_SNAPSHOT_NAME'
Remplacez les éléments suivants par les valeurs correspondantes :
PROJECT_ID: ID du projet contenant l'instantané récupérable.RECOVERABLE_SNAPSHOT_NAME: nom de l'instantané récupérable.
La réponse est semblable à ce qui suit :
{
"name": "prod-test-snapshot-uj731vz4",
"creationTimestamp": "2026-09-05T22:37:34.164-07:00",
"purgeTimestamp": "2026-09-12T22:37:32.918-07:00",
...
"originalResource": {
"name": "prod-test-snapshot",
...
}
}
Le corps de la réponse inclut les propriétés clés suivantes de l'instantané récupérable :
name: nom de l'instantané récupérable. Pour récupérer l'instantané, vous devez spécifier ce nom si vous utilisez gcloud CLI ou REST.creationTimestamp: heure à laquelle l'instantané standard d'origine a été supprimé.purgeTimestamp: heure à laquelle Compute Engine supprimera définitivement l'instantané récupérable.originalResource: objet contenant des informations sur l'instantané d'origine, y compris son nom et son disque source.
Récupérer des instantanés supprimés
Avant de récupérer un instantané, tenez compte des points suivants :
- Persistance des tags : les tags associés à un instantané avant sa suppression ne sont pas conservés si l'instantané est restauré depuis la corbeille. Vous devez rajouter les tags à l'instantané après l'avoir récupéré dans la corbeille.
- Instantanés programmés : si vous récupérez un instantané qui a été créé à l'origine selon une programmation, il ne fait plus partie de la programmation et n'est pas supprimé automatiquement après la durée spécifiée par la programmation. Au lieu de cela, Compute Engine conserve l'instantané indéfiniment jusqu'à ce que vous le supprimiez manuellement.
- Conflits de noms : la récupération d'un instantané échouera si un instantané standard portant le même nom existe déjà et que vous ne fournissez pas de nouveau nom pour l'instantané récupéré. Pour récupérer un tel instantané, vous devez utiliser la Google Cloud CLI ou REST pour spécifier un nouveau nom.
- Les instantanés récupérables persistent après la récupération : la récupération d'un instantané ne supprime pas l'instantané récupérable de la corbeille. L'instantané récupérable reste dans la corbeille jusqu'à l'expiration de la période de conservation.
- Nouvelle heure de création de l'instantané récupéré : lorsque vous récupérez un instantané, l'heure de création de l'instantané standard correspond à l'heure à laquelle vous l'avez récupéré dans la corbeille, et non à l'heure à laquelle il a été créé à l'origine.
Récupérer un instantané à partir de la corbeille
Pour récupérer un instantané supprimé afin de pouvoir l'utiliser pour créer un disque, vous devez d'abord trouver le nom de l'instantané récupérable. Pour ce faire, suivez les instructions de la section Trouver le nom d'un instantané récupérable.
Lorsque vous connaissez le nom de l'instantané récupérable, utilisez la console Cloud de Confiance , la gcloud CLI ou REST pour le récupérer.
Console Cloud de Confiance
Dans la console Cloud de Confiance , accédez à la page Instantanés.
Cliquez sur Corbeille.
Cliquez sur l'onglet Instantanés supprimés. La liste des instantanés récupérables s'affiche.
Sélectionnez l'instantané que vous souhaitez récupérer.
Cliquez sur restore_from_trash Récupérer.
CLI gcloud
Pour récupérer un instantané, utilisez la commande gcloud beta compute recoverable-snapshots recover.
Pour récupérer un instantané et conserver son nom d'origine :
gcloud beta compute recoverable-snapshots recover \ RECOVERABLE_SNAPSHOT_NAME \ --project=PROJECT_ID
Remplacez les éléments suivants par les valeurs correspondantes :
RECOVERABLE_SNAPSHOT_NAME: nom de l'instantané récupérable.PROJECT_ID: ID du projet
Pour récupérer un instantané et lui attribuer un nouveau nom, spécifiez ce nouveau nom avec l'indicateur
--snapshot-name.gcloud beta compute recoverable-snapshots recover \ RECOVERABLE_SNAPSHOT_NAME \ --project=PROJECT_ID \ --snapshot-name=NEW_SNAPSHOT_NAME
Remplacez les éléments suivants par les valeurs correspondantes :
RECOVERABLE_SNAPSHOT_NAME: nom de l'instantané récupérable.PROJECT_ID: ID du projetNEW_SNAPSHOT_NAME: nouveau nom de l'instantané récupéré.
REST
Pour récupérer un instantané, envoyez une requête POST à la méthode recoverableSnapshots.recover.
POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/recoverableSnapshots/RECOVERABLE_SNAPSHOT_NAME/recover
Remplacez les éléments suivants par les valeurs correspondantes :
PROJECT_ID: ID du projetRECOVERABLE_SNAPSHOT_NAME: nom de l'instantané récupérable.
Pour récupérer un instantané et lui attribuer un nouveau nom, spécifiez ce nouveau nom avec le champ snapshotName dans le corps de la requête :
{
"snapshotName": "NEW_SNAPSHOT_NAME"
}
Remplacez NEW_SNAPSHOT_NAME par le nouveau nom de l'instantané récupéré.
Pour créer un disque à partir de l'instantané récupéré, consultez Créer un disque à partir d'un instantané.
Pour ajouter des tags associés à l'instantané standard d'origine, consultez Ajouter des tags à une ressource.
Supprimer un instantané récupérable
Vous pouvez supprimer définitivement un instantané de la corbeille avant l'expiration de sa période de conservation à l'aide de la console Cloud de Confiance , de gcloud CLI ou de REST.
Console Cloud de Confiance
Dans la console Cloud de Confiance , accédez à la page Instantanés.
Cliquez sur Corbeille.
Dans l'onglet Instantanés supprimés, sélectionnez l'instantané que vous souhaitez supprimer définitivement.
Cliquez sur Supprimer Supprimer définitivement.
CLI gcloud
Pour supprimer définitivement un instantané récupérable, utilisez la commande gcloud beta compute recoverable-snapshots delete.
gcloud beta compute recoverable-snapshots delete RECOVERABLE_SNAPSHOT_NAME \ --project=PROJECT_ID
Remplacez les éléments suivants par les valeurs correspondantes :
RECOVERABLE_SNAPSHOT_NAME: nom de l'instantané récupérable.PROJECT_ID: ID du projet
REST
Pour supprimer définitivement un instantané récupérable, envoyez une requête DELETE à la méthode recoverableSnapshots.delete.
DELETE https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/recoverableSnapshots/RECOVERABLE_SNAPSHOT_NAME
Remplacez les éléments suivants par les valeurs correspondantes :
PROJECT_ID: ID du projetRECOVERABLE_SNAPSHOT_NAME: nom de l'instantané récupérable.