Selektive Dateiwiederherstellung durchführen

Auf dieser Seite wird beschrieben, wie Sie eine selektive Dateiwiederherstellung durchführen.

Hinweise

Prüfen Sie vor dem selektiven Wiederherstellen von Dateien die folgenden Voraussetzungen:

  • Snapshot-Konfiguration: Das Snapshot-Verzeichnis des Zielvolumes, für das die Wiederherstellung initiiert wird, muss sichtbar sein. Wählen Sie auf der Seite Neues Volume aus Sicherung erstellen das Kästchen Snapshot-Verzeichnis sichtbar machen aus. Weitere Informationen finden Sie unter Neues Volume erstellen.

  • Google Cloud CLI-Version: Damit Sie die selektive Dateiwiederherstellung nutzen können, muss Ihre Google Cloud CLI-Version mindestens 2025.08.08 sein. Diese Funktion ist über die beta-Komponente verfügbar und muss als Teil der Google Cloud CLI installiert werden.

    So prüfen und aktualisieren Sie die Google Cloud CLI-Version:

    1. Prüfen Sie Ihre Google Cloud CLI-Version:

      gcloud --version

    2. Wenn die Betakomponente nicht installiert ist, führen Sie Folgendes aus:

      gcloud components install beta

    3. Wenn Ihre Google Cloud CLI-Version älter als 2025.08.08 ist, aktualisieren Sie sie:

      gcloud components update beta

Selektive Dateiwiederherstellung durchführen

Sie können Dateien auf folgende Arten selektiv wiederherstellen:

  • Stellen Sie Dateien im Quellvolume und im selben Quellverzeichnis wieder her.

  • Dateien im Quellvolume in einem anderen Verzeichnis wiederherstellen

  • Stellen Sie Dateien auf einem neuen Volume in einem Verzeichnis Ihrer Wahl wieder her.

Die selektive Dateiwiederherstellung wird sowohl für Sicherungen innerhalb der Region als auch für regionenübergreifende Sicherungen unterstützt. In diesem Verfahren werden zwei verschiedene Fälle beschrieben:

Fall 1: Wiederherstellung in derselben Region auf das Quellvolume im selben Quellverzeichnis

Folgen Sie der Anleitung unten, um mit der Google Cloud CLI eine selektive Dateiwiederherstellung in der Region durchzuführen.

gcloud

So führen Sie eine selektive Dateiwiederherstellung durch:

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

Ersetzen Sie die folgenden Informationen:

  • DESTINATION_VOLUME_NAME: Der Name des Zielvolumes für den Wiederherstellungsvorgang. Das kann das ursprüngliche Volume sein, von dem die Sicherung erstellt wurde, oder ein neues Volume.

  • LOCATION: die Region, in der sich das Volume befindet.

  • PROJECT_ID: Die ID des Projekts, in dem das Volume und der Speicherpool erstellt werden.

  • VAULT_NAME: der Name des Sicherungstresors. Sicherungen in derselben Region und regionenübergreifende Backup Vaults werden unterstützt.

  • BACKUP_NAME: der Name der Sicherung, die die wiederherzustellenden Dateien enthält.

  • FILE_LIST: eine durch Kommas getrennte Liste von Dateipfaden in der ausgewählten Sicherung, die wiederhergestellt werden müssen.

  • RESTORE_DESTINATION_PATH: Optional: Der spezifische Pfad, in dem die Dateien wiederhergestellt werden. Wenn in diesem Parameter kein Pfad angegeben ist, wird eine In-Place-Wiederherstellung durchgeführt.

Beispiel:

Angenommen, Sie führen einen selektiven Dateiwiederherstellungsvorgang für eine Sicherung eines Quellvolumes mit dem Namen sfr-demo-vol-1 durch. Dieses Quellvolume wird im Backup Vault mit dem Namen sfr-demo-vault-in-region in sfr-demo-backup-1 gesichert.

Das Quellvolume enthält drei Textdateien:

  • 1.txt

  • 2.txt

  • directory/3.txt

Im Backup Vault innerhalb der Region wurde eine Sicherung mit dem Namen sfr-demo-backup-1 gefunden.

Szenario: Die Datei directory/3.txt und ihr übergeordnetes Verzeichnis werden aus dem Quellvolumen entfernt. Anschließend wird ein Wiederherstellungsvorgang mit bestimmten Parametern ausgeführt.

1. Versuch: Stellen Sie die Datei wieder her, ohne das Verzeichnis auf dem Quellvolume neu zu erstellen.

Zuerst wird versucht, die Datei directory/3.txt wiederherzustellen, ohne das Verzeichnis auf dem Quellvolumen neu zu erstellen. Dieser Versuch wird voraussichtlich fehlschlagen.

Stellen Sie die Datei wieder her:

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/

Sie werden aufgefordert, den Wiederherstellungsvorgang zu bestätigen:

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

Der Vorgang schlägt mit dem folgenden Fehler fehl:

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."

2. Versuch: Stellen Sie die Datei wieder her, nachdem Sie das Verzeichnis neu erstellt haben.

Erstellen Sie das Verzeichnis noch einmal im Quell-Volume und führen Sie denselben Wiederherstellungsbefehl aus. Dieses Mal ist der Vorgang erfolgreich.

Stellen Sie die Datei wieder her:

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/

Sie werden noch einmal aufgefordert, den Wiederherstellungsvorgang zu bestätigen:

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

Der Vorgang wird erfolgreich abgeschlossen:

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

Fall 2: Regionenübergreifende Wiederherstellung auf einem neuen Volume in einem neuen Verzeichnis

Mit der folgenden Anleitung können Sie mit der Google Cloud CLI eine regionsübergreifende selektive Dateiwiederherstellung durchführen.

gcloud

So führen Sie eine selektive Dateiwiederherstellung durch:

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

Ersetzen Sie die folgenden Informationen:

  • DESTINATION_VOLUME_NAME: Der Name des Zielvolumes für den Wiederherstellungsvorgang. Das kann das ursprüngliche Volume sein, von dem die Sicherung erstellt wurde, oder ein neues Volume.

  • LOCATION: die Region, in der sich das Volume befindet.

  • PROJECT_ID: Die ID des Projekts, in dem das Volume und der Speicherpool erstellt werden.

  • VAULT_NAME: der Name des Sicherungstresors. Sicherungen in derselben Region und regionenübergreifende Backup Vaults werden unterstützt.

  • BACKUP_NAME: der Name der Sicherung, die die wiederherzustellenden Dateien enthält.

  • FILE_LIST: eine durch Kommas getrennte Liste von Dateipfaden in der ausgewählten Sicherung, die wiederhergestellt werden müssen.

  • RESTORE_DESTINATION_PATH: Optional: Der spezifische Pfad, in dem die Dateien wiederhergestellt werden. Wenn in diesem Parameter kein Pfad angegeben ist, wird eine In-Place-Wiederherstellung durchgeführt.

Beispiel:

Angenommen, Sie führen einen selektiven Dateiwiederherstellungsvorgang für eine Sicherung eines Quellvolumes mit dem Namen sfr-demo-vol-2 durch. Dieses Quellvolume wird im Backup Vault mit dem Namen sfr-demo-vault-cross-region in sfr-demo-backup gesichert.

Das Quellvolumen enthält zwei Textdateien:

  • 1.txt

  • 2.txt

Eine Sicherung, sfr-demo-backup, wurde in einem regionenübergreifenden Backup Vault mit us-central1 als Quellregion und us-east4 als Zielregion gefunden. Nachdem die Sicherung erstellt wurde, wurde die Datei 1.txt vom Quellvolumen entfernt.

Die Datei 1.txt aus sfr-demo-backup wird auf einem neuen Volume mit dem Namen sfr-demo-vol-3 in einem neuen Verzeichnis mit dem Namen test wiederhergestellt.

Stellen Sie die Datei wieder her:

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

Sie werden aufgefordert, den Wiederherstellungsvorgang zu bestätigen:

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

Nach der Bestätigung ist der Vorgang abgeschlossen.

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