Melakukan pemulihan file selektif

Halaman ini menjelaskan cara melakukan pemulihan file selektif.

Sebelum memulai

Tinjau prasyarat berikut sebelum Anda melakukan pemulihan file selektif:

  • Konfigurasi snapshot: direktori snapshot volume target tempat pemulihan dimulai harus terlihat. Di halaman Create new volume from backup, pilih kotak centang Make snapshot directory visible. Untuk mengetahui informasi selengkapnya, lihat Membuat volume baru.

  • Versi Google Cloud CLI: untuk mengakses pemulihan file selektif, pastikan versi Google Cloud CLI Anda minimal 2025.08.08. Fitur ini tersedia di komponen beta dan harus diinstal sebagai bagian dari kumpulan Google Cloud CLI.

    Untuk memverifikasi dan mengupdate versi Google Cloud CLI:

    1. Periksa versi Google Cloud CLI Anda:

      gcloud --version

    2. Jika komponen beta tidak diinstal, jalankan:

      gcloud components install beta

    3. Jika versi Google Cloud CLI Anda lebih lama dari 2025.08.08, update:

      gcloud components update beta

Melakukan pemulihan file selektif

Anda dapat menggunakan pemulihan file selektif untuk memulihkan file dengan cara berikut:

  • Pulihkan file ke volume sumber dan direktori sumber yang sama.

  • Memulihkan file ke volume sumber di direktori yang berbeda.

  • Pulihkan file ke volume baru di direktori pilihan Anda.

Pemulihan file selektif mendukung pencadangan dalam region dan lintas region. Prosedur ini menjelaskan dua kasus yang berbeda:

Kasus 1: Pemulihan dalam region ke volume sumber di direktori sumber yang sama

Gunakan petunjuk berikut untuk melakukan pemulihan file selektif dalam region menggunakan Google Cloud CLI.

gcloud

Untuk melakukan pemulihan file selektif:

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

Ganti informasi berikut:

  • DESTINATION_VOLUME_NAME: nama volume tujuan untuk operasi pemulihan. Volume ini dapat berupa volume asli tempat cadangan diambil atau volume baru.

  • LOCATION: region tempat volume berada.

  • PROJECT_ID: ID project tempat volume dan storage pool dibuat.

  • VAULT_NAME: nama vault cadangan. Vault pencadangan dalam region dan lintas region didukung.

  • BACKUP_NAME: nama cadangan yang berisi file yang akan dipulihkan.

  • FILE_LIST: daftar jalur file yang dipisahkan koma dalam cadangan yang dipilih yang perlu dipulihkan.

  • RESTORE_DESTINATION_PATH: Opsional: jalur tertentu tempat file akan dipulihkan. Jika tidak ada jalur yang diberikan dalam parameter ini, pemulihan di tempat akan dilakukan.

Contoh:

Pertimbangkan operasi pemulihan file selektif yang dilakukan pada cadangan volume sumber bernama sfr-demo-vol-1. Volume sumber ini dicadangkan ke sfr-demo-backup-1 dalam brankas cadangan bernama sfr-demo-vault-in-region.

Volume sumber berisi tiga file teks:

  • 1.txt

  • 2.txt

  • directory/3.txt

Cadangan, sfr-demo-backup-1, telah diidentifikasi dalam brankas cadangan dalam region.

Skenario: File directory/3.txt dan direktori induknya dihapus dari volume sumber. Kemudian, operasi pemulihan dilakukan dengan parameter tertentu.

Percobaan 1: Pulihkan file tanpa membuat ulang direktori di volume sumber.

Pertama, upaya dilakukan untuk memulihkan file directory/3.txt tanpa membuat ulang direktori di volume sumber. Upaya ini diperkirakan akan gagal.

Pulihkan file:

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/

Anda akan diminta untuk mengonfirmasi operasi pemulihan:

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

Operasi gagal dengan error berikut:

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

Percobaan 2: Pulihkan file setelah membuat ulang direktori.

Buat kembali direktori di volume sumber dan jalankan perintah pemulihan yang sama. Kali ini, operasi berhasil.

Pulihkan file:

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/

Anda akan diminta lagi untuk mengonfirmasi operasi pemulihan:

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

Operasi berhasil diselesaikan:

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

Kasus 2: Pemulihan lintas region ke volume baru dalam direktori baru

Gunakan petunjuk berikut untuk melakukan pemulihan file selektif lintas region menggunakan Google Cloud CLI.

gcloud

Untuk melakukan pemulihan file selektif:

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

Ganti informasi berikut:

  • DESTINATION_VOLUME_NAME: nama volume tujuan untuk operasi pemulihan. Volume ini dapat berupa volume asli tempat cadangan diambil atau volume baru.

  • LOCATION: region tempat volume berada.

  • PROJECT_ID: ID project tempat volume dan storage pool dibuat.

  • VAULT_NAME: nama vault cadangan. Vault pencadangan dalam region dan lintas region didukung.

  • BACKUP_NAME: nama cadangan yang berisi file yang akan dipulihkan.

  • FILE_LIST: daftar jalur file yang dipisahkan koma dalam cadangan yang dipilih yang perlu dipulihkan.

  • RESTORE_DESTINATION_PATH: Opsional: jalur tertentu tempat file akan dipulihkan. Jika tidak ada jalur yang diberikan dalam parameter ini, pemulihan di tempat akan dilakukan.

Contoh:

Pertimbangkan operasi pemulihan file selektif yang dilakukan pada cadangan volume sumber bernama sfr-demo-vol-2. Volume sumber ini dicadangkan ke sfr-demo-backup dalam brankas cadangan bernama sfr-demo-vault-cross-region.

Volume sumber berisi dua file teks:

  • 1.txt

  • 2.txt

Cadangan, sfr-demo-backup, telah diidentifikasi di brankas pencadangan lintas region, dengan us-central1 sebagai region sumber dan us-east4 sebagai region tujuan. Setelah cadangan dibuat, file 1.txt dihapus dari volume sumber.

File 1.txt dari sfr-demo-backup akan dipulihkan ke volume baru bernama sfr-demo-vol-3 di direktori baru bernama test.

Pulihkan file:

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

Anda akan diminta untuk mengonfirmasi operasi pemulihan:

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

Setelah konfirmasi, operasi berhasil.

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