Eseguire un ripristino selettivo dei file

Questa pagina descrive come eseguire un ripristino selettivo dei file.

Prima di iniziare

Rivedi i seguenti prerequisiti prima di eseguire un ripristino selettivo dei file:

  • Configurazione snapshot: la directory snapshot del volume di destinazione in cui viene avviato il ripristino deve essere visibile. Nella pagina Crea nuovo volume dal backup, seleziona la casella di controllo Rendi visibile la directory degli snapshot. Per ulteriori informazioni, vedi Creare un nuovo volume.

  • Versione di Google Cloud CLI: per accedere al ripristino selettivo dei file, assicurati che la tua versione di Google Cloud CLI sia almeno 540.0.0.

    Per verificare e aggiornare la versione di Google Cloud CLI:

    1. Controlla la versione di Google Cloud CLI:

      gcloud --version

    2. Se la tua versione di Google Cloud CLI è precedente alla 540.0.0, aggiornala:

      gcloud components update

Eseguire un ripristino selettivo dei file

Puoi utilizzare il ripristino selettivo dei file per recuperare i file nei seguenti modi:

  • Ripristina i file nel volume di origine e nella stessa directory di origine.

  • Ripristina i file nel volume di origine in una directory diversa.

  • Ripristina i file in un nuovo volume in una directory a tua scelta.

Il ripristino selettivo dei file supporta i backup sia regionali che tra regioni. Questa procedura descrive tre casi diversi:

Scenario 1: ripristino nella regione nel volume di origine nella stessa directory di origine

Segui queste istruzioni per eseguire un ripristino selettivo dei file all'interno della regione utilizzando Google Cloud CLI.

gcloud

Per eseguire un ripristino selettivo dei file:

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

Sostituisci le seguenti informazioni:

  • DESTINATION_VOLUME_NAME: il nome del volume di destinazione per l'operazione di ripristino. Può trattarsi del volume originale da cui è stato eseguito il backup o di un nuovo volume.

  • LOCATION: la regione in cui risiede il volume.

  • PROJECT_ID: l'ID del progetto in cui vengono creati il volume e il pool di archiviazione.

  • VAULT_NAME: il nome del vault di backup. Sono supportati sia i vault di backup nella regione sia quelli tra regioni.

  • BACKUP_NAME: il nome del backup che contiene i file da ripristinare.

  • FILE_LIST: un elenco separato da virgole di percorsi dei file nel backup scelto che deve essere ripristinato.

  • RESTORE_DESTINATION_PATH: (Facoltativo) il percorso specifico in cui verranno ripristinati i file. Se in questo parametro non viene fornito alcun percorso, viene eseguito un ripristino in loco.

Esempio:

Considera un'operazione di ripristino selettivo dei file eseguita su un backup di un volume di origine denominato sfr-demo-vol-1. Il backup di questo volume di origine viene eseguito in sfr-demo-backup-1 all'interno del vault di backup denominato sfr-demo-vault-in-region.

Il volume di origine contiene tre file di testo:

  • 1.txt

  • 2.txt

  • directory/3.txt

È stato identificato un backup, sfr-demo-backup-1, all'interno del vault di backup regionale. Il file directory/3.txt e la relativa directory principale vengono rimossi dal volume di origine. Viene quindi eseguita un'operazione di ripristino con parametri specifici.

Il file directory/3.txt di sfr-demo-backup-1 verrà ripristinato nel volume di origine.

Ripristina il file:

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/

Ti verrà chiesto di confermare l'operazione di ripristino:

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'operazione viene completata correttamente:

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

Scenario 2: Ripristino tra regioni in un nuovo volume in una nuova directory

Utilizza le seguenti istruzioni per eseguire un ripristino selettivo dei file tra regioni utilizzando Google Cloud CLI.

gcloud

Per eseguire un ripristino selettivo dei file:

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

Sostituisci le seguenti informazioni:

  • DESTINATION_VOLUME_NAME: il nome del volume di destinazione per l'operazione di ripristino. Può trattarsi del volume originale da cui è stato eseguito il backup o di un nuovo volume.

  • LOCATION: la regione in cui risiede il volume.

  • PROJECT_ID: l'ID del progetto in cui vengono creati il volume e il pool di archiviazione.

  • VAULT_NAME: il nome del vault di backup. Sono supportati sia i vault di backup nella regione sia quelli tra regioni.

  • BACKUP_NAME: il nome del backup che contiene i file da ripristinare.

  • FILE_LIST: un elenco separato da virgole di percorsi dei file nel backup scelto che deve essere ripristinato.

  • RESTORE_DESTINATION_PATH: (Facoltativo) il percorso specifico in cui verranno ripristinati i file. Se in questo parametro non viene fornito alcun percorso, viene eseguito un ripristino in loco.

Esempio:

Considera un'operazione di ripristino selettivo dei file eseguita su un backup di un volume di origine denominato sfr-demo-vol-2. Il backup di questo volume di origine viene eseguito in sfr-demo-backup all'interno del vault di backup denominato sfr-demo-vault-cross-region.

Il volume di origine contiene due file di testo:

  • 1.txt

  • 2.txt

È stato identificato un backup, sfr-demo-backup, in un vault di backup tra regioni, con us-central1 come regione di origine e us-east4 come regione di destinazione. Dopo la creazione del backup, il file 1.txt è stato rimosso dal volume di origine.

Il file 1.txt di sfr-demo-backup verrà ripristinato in un nuovo volume denominato sfr-demo-vol-3 in una nuova directory chiamata test.

Ripristina il file:

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

Ti verrà chiesto di confermare l'operazione di ripristino:

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

Dopo la conferma, l'operazione va a buon fine.

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

Scenario 3: ripristino in loco in un nuovo volume

Segui queste istruzioni per eseguire un ripristino selettivo dei file in loco utilizzando Google Cloud CLI.

gcloud

Per eseguire un ripristino selettivo dei file:

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

Sostituisci le seguenti informazioni:

  • DESTINATION_VOLUME_NAME: il nome del volume di destinazione per l'operazione di ripristino. Può trattarsi del volume originale da cui è stato eseguito il backup o di un nuovo volume.

  • LOCATION: la regione in cui risiede il volume.

  • PROJECT_ID: l'ID del progetto in cui vengono creati il volume e il pool di archiviazione.

  • VAULT_NAME: il nome del vault di backup. Sono supportati sia i vault di backup nella regione sia quelli tra regioni.

  • BACKUP_NAME: il nome del backup che contiene i file da ripristinare.

  • FILE_LIST: un elenco separato da virgole di percorsi dei file nel backup scelto che deve essere ripristinato.

Esempio:

Considera un'operazione di ripristino selettivo dei file eseguita su un backup di un volume di origine denominato sfr-demo-vol-2. Il backup di questo volume di origine viene eseguito in sfr-demo-backup all'interno del vault di backup denominato sfr-demo-vault-cross-region.

Il volume di origine contiene due file di testo:

  • 1.txt

  • 2.txt

È stato identificato un backup, sfr-demo-backup, in un vault di backup tra regioni, con us-central1 come regione di origine e us-east4 come regione di destinazione. Dopo la creazione del backup, il file 1.txt è stato rimosso dal volume di origine.

Il file 1.txt di sfr-demo-backup verrà ripristinato in un nuovo volume denominato sfr-demo-vol-3, ma la directory per l'operazione di ripristino non verrà specificata.

Ripristina il file:

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

Ti verrà chiesto di confermare l'operazione di ripristino:

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

Dopo la conferma, l'operazione va a buon fine.

Waiting for [operation-1758875604584-63fb0239d87b7-1035ba74-caed1838] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse