Restaurer sélectivement des fichiers

Cette page explique comment effectuer une restauration sélective de fichiers.

Avant de commencer

Avant de restaurer sélectivement des fichiers, vérifiez les conditions préalables suivantes :

  • Configuration de l'instantané : le répertoire d'instantanés du volume cible à partir duquel la restauration est lancée doit être visible. Sur la page Créer un volume à partir d'une sauvegarde, cochez la case Rendre le répertoire d'instantanés visible. Pour en savoir plus, consultez Créer un volume.

  • Version de Google Cloud CLI : pour accéder à la restauration sélective de fichiers, assurez-vous que votre version de Google Cloud CLI est au moins 2025.08.08. Cette fonctionnalité est exposée sous le composant beta et doit être installée dans la suite Google Cloud CLI.

    Pour vérifier et mettre à jour la version de Google Cloud CLI :

    1. Vérifiez votre version de Google Cloud CLI :

      gcloud --version

    2. Si le composant bêta n'est pas installé, exécutez la commande suivante :

      gcloud components install beta

    3. Si votre version de Google Cloud CLI est antérieure à la version 2025.08.08, mettez-la à jour :

      gcloud components update beta

Restaurer sélectivement des fichiers

Vous pouvez utiliser la restauration sélective de fichiers pour récupérer des fichiers des manières suivantes :

  • Restaurez les fichiers dans le volume source et le même répertoire source.

  • Restaurez les fichiers sur le volume source dans un autre répertoire.

  • Restaurez les fichiers sur un nouveau volume dans le répertoire de votre choix.

La restauration sélective de fichiers est compatible avec les sauvegardes intrarégionales et interrégionales. Cette procédure décrit deux cas différents :

Scénario 1 : Restauration dans la même région vers le volume source dans le même répertoire source

Suivez les instructions ci-dessous pour effectuer une restauration sélective de fichiers dans la même région à l'aide de Google Cloud CLI.

gcloud

Pour effectuer une restauration sélective de fichiers :

gcloud beta netapp volumes restore-backup-files DESTINATION_VOLUME_NAME \
  --location=LOCATION --project=PROJECT_ID \
  --backup=projects/PROJECT_ID/locations/LOCATION/backupVaults/VAULT_NAME/backups/BACKUP_NAME \
  --file-list=FILE_LIST \
  --restore-destination-path=RESTORE_DESTINATION_PATH

Remplacez les informations suivantes :

  • DESTINATION_VOLUME_NAME : nom du volume de destination pour l'opération de restauration. Il peut s'agir du volume d'origine à partir duquel la sauvegarde a été effectuée ou d'un nouveau volume.

  • LOCATION : région dans laquelle se trouve le volume.

  • PROJECT_ID : ID du projet dans lequel le volume et le pool de stockage sont créés.

  • VAULT_NAME : nom du coffre-fort de sauvegarde. Les coffres de sauvegarde dans la région et interrégionaux sont acceptés.

  • BACKUP_NAME : nom de la sauvegarde contenant les fichiers à restaurer.

  • FILE_LIST : liste des chemins d'accès aux fichiers de la sauvegarde choisie qui doivent être restaurés, séparés par une virgule.

  • RESTORE_DESTINATION_PATH : (facultatif) chemin d'accès spécifique où les fichiers seront restaurés. Si aucun chemin d'accès n'est fourni dans ce paramètre, une restauration sur place est effectuée.

Exemple :

Prenons l'exemple d'une opération de restauration sélective de fichiers effectuée sur une sauvegarde d'un volume source nommé sfr-demo-vol-1. Ce volume source est sauvegardé dans sfr-demo-backup-1 au sein du coffre de sauvegarde nommé sfr-demo-vault-in-region.

Le volume source contient trois fichiers texte :

  • 1.txt

  • 2.txt

  • directory/3.txt

Une sauvegarde, sfr-demo-backup-1, a été identifiée dans le coffre de sauvegarde régional.

Scénario : Le fichier directory/3.txt et son répertoire parent sont supprimés du volume source. Une opération de restauration est ensuite effectuée avec des paramètres spécifiques.

Première tentative : restaurez le fichier sans recréer le répertoire dans le volume source.

Tout d'abord, une tentative de restauration du fichier directory/3.txt est effectuée sans recréer le répertoire dans le volume source. Cette tentative devrait échouer.

Restaurez le fichier :

gcloud beta netapp volumes restore-backup-files sfr-demo-vol-1
--location=us-central1 --project=my-project
--backup=projects/my-project/locations/us-central1/backupVaults/sfr-demo-vault-in-region/backups/sfr-demo-backup-1
--file-list=/directory/3.txt --restore-destination-path=/directory/

Vous serez invité à confirmer l'opération de restauration :

You are about to restore files from a backup to Volume
projects/my-project/locations/us-central1/volumes/sfr-demo-vol-1.
Are you sure?

Do you want to continue (Y/n)? Y

L'opération échoue avec l'erreur suivante :

Waiting for [operation-1758047951007-63eef6f9e2f5d-40212146-348595a4] to finish...failed.
ERROR: (gcloud.beta.netapp.volumes.restore-backup-files) bad request error: "Error when create - FAILED - The Single File Backup Restore cannot be processed due to invalid destination path/directory."

Deuxième tentative : restaurez le fichier après avoir recréé le répertoire.

Recréez le répertoire dans le volume source et exécutez la même commande de restauration. Cette fois, l'opération réussit.

Restaurez le fichier :

gcloud beta netapp volumes restore-backup-files sfr-demo-vol-1
--location=us-central1 --project=my-project
--backup=projects/my-project/locations/us-central1/backupVaults/sfr-demo-vault-in-region/backups/sfr-demo-backup-1
--file-list=/directory/3.txt --restore-destination-path=/directory/

Vous serez à nouveau invité à confirmer l'opération de restauration :

You are about to restore files from a backup to Volume
projects/my-project/locations/us-central1/volumes/sfr-demo-vol-1.
Are you sure?

Do you want to continue (Y/n)?  y

L'opération s'est déroulée correctement :

Waiting for [operation-1758048175178-63eef7cfac198-a94afb9b-913b60d5] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1beta1.RestoreBackupFilesResponse

Cas d'utilisation 2 : Restauration multirégionale sur un nouveau volume dans un nouveau répertoire

Suivez les instructions ci-dessous pour effectuer une restauration sélective de fichiers multirégion à l'aide de la Google Cloud CLI.

gcloud

Pour effectuer une restauration sélective de fichiers :

gcloud beta netapp volumes restore-backup-files DESTINATION_VOLUME_NAME \
  --location=LOCATION --project=PROJECT_ID \
  --backup=projects/PROJECT_ID/locations/LOCATION/backupVaults/VAULT_NAME/backups/BACKUP_NAME \
  --file-list=FILE_LIST \
  --restore-destination-path=RESTORE_DESTINATION_PATH

Remplacez les informations suivantes :

  • DESTINATION_VOLUME_NAME : nom du volume de destination pour l'opération de restauration. Il peut s'agir du volume d'origine à partir duquel la sauvegarde a été effectuée ou d'un nouveau volume.

  • LOCATION : région dans laquelle se trouve le volume.

  • PROJECT_ID : ID du projet dans lequel le volume et le pool de stockage sont créés.

  • VAULT_NAME : nom du coffre-fort de sauvegarde. Les coffres de sauvegarde dans la région et interrégionaux sont acceptés.

  • BACKUP_NAME : nom de la sauvegarde contenant les fichiers à restaurer.

  • FILE_LIST : liste des chemins d'accès aux fichiers de la sauvegarde choisie qui doivent être restaurés, séparés par une virgule.

  • RESTORE_DESTINATION_PATH : (facultatif) chemin d'accès spécifique où les fichiers seront restaurés. Si aucun chemin d'accès n'est fourni dans ce paramètre, une restauration sur place est effectuée.

Exemple :

Prenons l'exemple d'une opération de restauration sélective de fichiers effectuée sur une sauvegarde d'un volume source nommé sfr-demo-vol-2. Ce volume source est sauvegardé dans sfr-demo-backup au sein du coffre de sauvegarde nommé sfr-demo-vault-cross-region.

Le volume source contient deux fichiers texte :

  • 1.txt

  • 2.txt

Une sauvegarde, sfr-demo-backup, a été identifiée dans un coffre de sauvegarde multirégional, avec us-central1 comme région source et us-east4 comme région de destination. Une fois la sauvegarde créée, le fichier 1.txt a été supprimé du volume source.

Le fichier 1.txt de sfr-demo-backup sera restauré dans un nouveau volume nommé sfr-demo-vol-3, dans un nouveau répertoire appelé test.

Restaurez le fichier :

gcloud beta netapp volumes restore-backup-files sfr-demo-vol-3
--location=us-central1 --project=my-project
--backup=projects/my-project/locations/us-central1/backupVaults/sfr-demo-vault-cross-region/backups/sfr-demo-backup
--file-list=/1.txt --restore-destination-path=/test

Vous serez invité à confirmer l'opération de restauration :

You are about to restore files from a backup to Volume
projects/my-project/locations/us-central1/volumes/sfr-demo-vol-3.
Are you sure?

Do you want to continue (Y/n)?  y

Une fois la confirmation effectuée, l'opération est réussie.

Waiting for [operation-1758050930422-63ef02134743f-8761c12f-b05a405e] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1beta1.RestoreBackupFilesResponse