執行檔案選擇性還原作業

本頁說明如何執行選擇性檔案還原。

事前準備

執行檔案選擇性還原作業前，請先詳閱下列必要條件：

  • 快照設定：必須顯示還原作業啟動的目標磁碟區快照目錄。在「依據備份建立新的磁碟區」頁面中，選取「顯示快照目錄」核取方塊。詳情請參閱「建立新磁碟區」。

  • Google Cloud CLI 版本：如要存取選擇性檔案還原功能，請確認 Google Cloud CLI 版本至少為 540.0.0。

    如要確認及更新 Google Cloud CLI 版本，請按照下列步驟操作：

    1. 檢查 Google Cloud CLI 版本：

      gcloud --version

    2. 如果 Google Cloud CLI 版本低於 540.0.0，請更新版本：

      gcloud components update

執行檔案選擇性還原作業

你可以透過下列方式，使用選擇性檔案還原功能復原檔案：

  • 將檔案還原至來源磁碟區和相同的來源目錄。

  • 將檔案還原至來源磁碟區中的其他目錄。

  • 將檔案還原到所選目錄的新磁碟區。

選擇性檔案還原功能支援同區域和跨區域備份。這個程序說明三種不同情況：

案例 1：在相同來源目錄中，將資料還原至來源磁碟區

請按照下列操作說明，使用 Google Cloud CLI 執行區域內檔案的選擇性還原作業。

gcloud

如要選擇性還原檔案，請按照下列步驟操作：

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

取代下列資訊：

  • DESTINATION_VOLUME_NAME：還原作業的目標磁碟區名稱。可以是備份來源磁碟區，也可以是新磁碟區。

  • LOCATION：磁碟區所在的區域。

  • PROJECT_ID：建立磁碟區和儲存集區的專案 ID。

  • VAULT_NAME：備份儲存空間的名稱。支援區域內和跨區域 backup vault。

  • BACKUP_NAME：備份名稱，其中包含要還原的檔案。

  • FILE_LIST：以逗號分隔的檔案路徑清單，這些檔案位於所選備份中，需要還原。

  • RESTORE_DESTINATION_PATH：選用：檔案還原的特定路徑。如果這個參數未提供路徑，系統會執行就地還原。

範例：

假設您要對名為 sfr-demo-vol-1 的來源磁碟區備份執行檔案選取還原作業。這個來源磁碟區會備份到名為「sfr-demo-vault-in-region」的 backup vault 內，備份名稱為「sfr-demo-backup-1」。

來源磁碟區包含三個文字檔：

  • 1.txt

  • 2.txt

  • directory/3.txt

系統在同區域 backup vault 中找到備份「sfr-demo-backup-1」。檔案 directory/3.txt 和上層目錄會從來源磁碟區中移除。然後使用特定參數執行還原作業。

系統會將 sfr-demo-backup-1 中的 directory/3.txt 檔案還原至來源磁碟區。

還原檔案：

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/

系統會提示您確認還原作業：

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

作業順利完成：

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

案例 2：跨區域還原到新目錄中的新磁碟區

請按照下列操作說明，使用 Google Cloud CLI 執行跨區域的檔案選擇性還原作業。

gcloud

如要選擇性還原檔案，請按照下列步驟操作：

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

取代下列資訊：

  • DESTINATION_VOLUME_NAME：還原作業的目標磁碟區名稱。可以是備份來源磁碟區，也可以是新磁碟區。

  • LOCATION：磁碟區所在的區域。

  • PROJECT_ID：建立磁碟區和儲存集區的專案 ID。

  • VAULT_NAME：備份儲存空間的名稱。支援區域內和跨區域 backup vault。

  • BACKUP_NAME：備份名稱，其中包含要還原的檔案。

  • FILE_LIST：以逗號分隔的檔案路徑清單，這些檔案位於所選備份中，需要還原。

  • RESTORE_DESTINATION_PATH：選用：檔案還原的特定路徑。如果這個參數未提供路徑，系統會執行就地還原。

範例：

假設您要對名為 sfr-demo-vol-2 的來源磁碟區備份執行檔案選取還原作業。這個來源磁碟區會備份到名為「sfr-demo-vault-cross-region」的 backup vault 內，備份名稱為「sfr-demo-backup」。

來源磁碟區包含兩個文字檔：

  • 1.txt

  • 2.txt

系統在跨區域 backup vault 中發現備份 sfr-demo-backup，來源區域為 us-central1，目的地區域為 us-east4。建立備份後，檔案「1.txt」已從來源磁碟區中移除。

sfr-demo-backup 中的 1.txt 檔案會還原到新磁碟區，並儲存在名為 test 的新目錄中，新磁碟區則命名為 sfr-demo-vol-3。

還原檔案：

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

系統會提示您確認還原作業：

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

確認後，作業就會成功。

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

案例 3：就地還原至新磁碟區

請按照下列操作說明，使用 Google Cloud CLI 執行就地選擇性檔案還原作業。

gcloud

如要選擇性還原檔案，請按照下列步驟操作：

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

取代下列資訊：

  • DESTINATION_VOLUME_NAME：還原作業的目標磁碟區名稱。可以是備份來源磁碟區，也可以是新磁碟區。

  • LOCATION：磁碟區所在的區域。

  • PROJECT_ID：建立磁碟區和儲存集區的專案 ID。

  • VAULT_NAME：備份儲存空間的名稱。支援區域內和跨區域 backup vault。

  • BACKUP_NAME：備份名稱，其中包含要還原的檔案。

  • FILE_LIST：以逗號分隔的檔案路徑清單，這些檔案位於所選備份中，需要還原。

範例：

假設您要對名為 sfr-demo-vol-2 的來源磁碟區備份執行檔案選取還原作業。這個來源磁碟區會備份到名為「sfr-demo-vault-cross-region」的 backup vault 內，備份名稱為「sfr-demo-backup」。

來源磁碟區包含兩個文字檔：

  • 1.txt

  • 2.txt

系統在跨區域 backup vault 中發現備份 sfr-demo-backup，來源區域為 us-central1，目的地區域為 us-east4。建立備份後，檔案「1.txt」已從來源磁碟區中移除。

檔案 1.txt 會從 sfr-demo-backup 還原到名為 sfr-demo-vol-3 的新磁碟區，但不會指定還原作業的目錄。

還原檔案：

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

系統會提示您確認還原作業：

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

確認後，作業就會成功。

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