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 la 540.0.0.

    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 votre version de Google Cloud CLI est antérieure à la version 540.0.0, mettez-la à jour :

      gcloud components update

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 dans 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 trois 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 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. 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.

Le fichier directory/3.txt du sfr-demo-backup-1 sera restauré dans le volume source.

Restaurez le fichier :

gcloud 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 se termine correctement :

Waiting for [operation-1758048175178-63eef7cfac198-a94afb9b-913b60d5] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.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 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 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.v1.RestoreBackupFilesResponse

Cas 3 : Restauration sur place vers un nouveau volume

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

gcloud

Pour effectuer une restauration sélective de fichiers :

gcloud 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

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.

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, mais le répertoire de l'opération de restauration ne sera pas spécifié.

Restaurez le fichier :

gcloud 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

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-1758875604584-63fb0239d87b7-1035ba74-caed1838] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse