Memulihkan Azure Files dengan Azure CLI

Azure CLI memberikan pengalaman baris perintah untuk mengelola sumber daya Azure. Ini adalah alat yang bagus untuk membangun otomatisasi kustom untuk menggunakan sumber daya Azure. Artikel ini menjelaskan cara memulihkan seluruh File Share atau file tertentu dari titik pemulihan yang dibuat oleh Azure Backup dengan menggunakan Azure CLI. Anda juga dapat memulihkan Azure Files menggunakan portal Microsoft Azure, Azure PowerShell, REST API.

Pada akhir artikel ini, Anda akan mempelajari cara melakukan operasi berikut dengan Azure CLI:

  • Lihat titik pemulihan untuk Azure Files yang sudah dicadangkan.
  • Pulihkan Azure Files lengkap.
  • Pulihkan file atau folder individual.

Nota

  • Pemulihan Azure Files hanya didukung dalam langganan yang sama saat menggunakan PowerShell atau CLI.
  • Azure Backup sekarang mendukung pemulihan beberapa file atau folder ke lokasi asli atau alternatif menggunakan Azure CLI. Lihat bagian Pulihkan beberapa file atau folder ke lokasi asli atau alternatif dari dokumen ini untuk mempelajari lebih lanjut.

Untuk mempelajari tentang skenario pencadangan dan pemulihan Azure Files yang didukung, ketersediaan wilayah, dan batasan, lihat matriks dukungan. Untuk pertanyaan umum, lihat pertanyaan yang sering diajukan.

Prasyarat

Artikel ini mengasumsikan bahwa Anda sudah memiliki Azure Files yang dicadangkan oleh Azure Backup. Jika Anda tidak memilikinya, lihat Cadangkan Azure Files menggunakan CLI untuk mengonfigurasi cadangan File Share Anda. Untuk artikel ini, Anda menggunakan sumber daya berikut:

Bagikan Berkas Akun penyimpanan Wilayah Detail lebih lanjut
azurefiles afsaccount EASTUS Sumber asli dicadangkan menggunakan Azure Backup
azurefiles1 afaccount1 EASTUS Sumber tujuan yang digunakan untuk pemulihan lokasi alternatif

Anda dapat menggunakan struktur serupa untuk Berbagi File Anda untuk mencoba berbagai jenis pemulihan yang dijelaskan dalam artikel ini.

Persiapkan lingkungan Anda untuk Azure CLI

  • Tutorial ini memerlukan versi 2.0.18 atau yang lebih tinggi dari Azure CLI. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terinstal.

Mengambil titik pemulihan untuk Azure Files

Gunakan cmdlet az backup recoverypoint list untuk menampilkan semua titik pemulihan untuk File Share yang dicadangkan.

Contoh berikut ini mengambil daftar titik pemulihan untuk File Share di akun penyimpanan azurefiles.

az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --backup-management-type azurestorage --item-name "AzureFileShare;azurefiles" --workload-type azurefileshare --out table

Anda juga dapat menjalankan cmdlet sebelumnya dengan menggunakan nama yang mudah diingat untuk kontainer dan item dengan memberikan dua parameter tambahan berikut:

  • --backup-management-type: azurestorage
  • --workload-type: azurefileshare
az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --item-name azurefiles --workload-type azurefileshare --out table

Kumpulan hasil adalah daftar titik pemulihan dengan detail waktu dan konsistensi untuk setiap titik pemulihan.

Name                Time                        Consistency
------------------  -------------------------   --------------------
932887541532871865  2020-01-05T07:08:23+00:00   FileSystemConsistent
932885927361238054  2020-01-05T07:08:10+00:00   FileSystemConsistent
932879614553967772  2020-01-04T21:33:04+00:00   FileSystemConsistent

Atribut Nama dalam output sesuai dengan nama titik pemulihan yang dapat digunakan sebagai nilai untuk parameter --rp-name dalam operasi pemulihan.

Pemulihan berbagi penuh dengan menggunakan Azure CLI

Anda dapat menggunakan opsi pemulihan ini untuk memulihkan Berbagi File lengkap di lokasi asli atau alternatif.

Tentukan parameter berikut untuk melakukan operasi pemulihan:

  • --container-name: Nama akun penyimpanan yang menghosting File Share yang asli dicadangkan. Untuk mengambil nama atau nama ramah dari kontainer Anda, gunakan perintah az backup container list.
  • --item-name: Nama File Share asli yang dicadangkan yang ingin Anda gunakan untuk operasi pemulihan. Untuk mengambil nama atau nama yang mudah diingat dari item yang dicadangkan, gunakan perintah az backup item list .

Memulihkan bagian penuh ke lokasi asal

Saat memulihkan ke lokasi asli, Anda tidak perlu menentukan parameter terkait target. Hanya Atasi Konflik yang harus disediakan.

Contoh berikut menggunakan az backup restore restore-azurefileshare cmdlet dengan mode pemulihan yang diatur ke originallocation untuk memulihkan azurefiles Berbagi File di lokasi asli. Anda menggunakan titik pemulihan 932883129628959823, yang Anda peroleh dalam Pengambilan titik pemulihan untuk Azure Files:

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932887541532871865   --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation --resolve-conflict overwrite --out table
Name                                  ResourceGroup
------------------------------------  ---------------
6a27cc23-9283-4310-9c27-dcfb81b7b4bb  azurefiles

Atribut Name dalam output sesuai dengan nama pekerjaan yang dibuat oleh layanan cadangan untuk operasi pemulihan Anda. Untuk melacak status pekerjaan, gunakan cmdlet az backup job show .

Memulihkan berbagi penuh ke lokasi alternatif

Anda dapat menggunakan opsi ini untuk memulihkan Berbagi File ke lokasi alternatif dan mempertahankan Berbagi File asli apa adanya. Tentukan parameter berikut untuk pemulihan lokasi alternatif:

  • --target-storage-account: Akun penyimpanan untuk memulihkan konten yang dicadangkan. Akun penyimpanan target harus berada di lokasi yang sama dengan kubah.
  • --target-file-share: Berbagi File dalam akun penyimpanan target di mana konten yang dicadangkan dipulihkan.
  • --target-folder: Folder di bawah Berbagi File tempat data dipulihkan. Jika konten yang dicadangkan akan dipulihkan ke folder akar, berikan nilai folder target sebagai string kosong.
  • --resolve-conflict: Instruksi jika ada konflik dengan data yang dipulihkan. Menerima opsi Timpa atau Lewati.

Contoh berikut menggunakan az backup restore restore-azurefileshare dengan mode pemulihan sebagai alternatelocation untuk memulihkan azurefiles File Share di akun penyimpanan afsaccount ke File Share azurefiles1 di akun penyimpanan afaccount1.

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932883129628959823 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --out table
Name                                  ResourceGroup
------------------------------------  ---------------
babeb61c-d73d-4b91-9830-b8bfa83c349a  azurefiles

Atribut Name dalam output sesuai dengan nama pekerjaan yang dibuat oleh layanan cadangan untuk operasi pemulihan Anda. Untuk melacak status pekerjaan, gunakan cmdlet az backup job show .

Pemulihan tingkat item

Anda dapat menggunakan opsi pemulihan ini untuk memulihkan file atau folder individu di lokasi asli atau alternatif.

Tentukan parameter berikut untuk melakukan operasi pemulihan:

  • --container-name: Nama akun penyimpanan yang menghosting File Share yang asli dicadangkan. Untuk mengambil nama atau nama ramah dari kontainer Anda, gunakan perintah az backup container list.
  • --item-name: Nama File Share asli yang dicadangkan yang ingin Anda gunakan untuk operasi pemulihan. Untuk mengambil nama atau nama yang mudah diingat dari item yang dicadangkan, gunakan perintah az backup item list .

Tentukan parameter berikut untuk item yang ingin Anda pulihkan:

  • SourceFilePath: Jalur absolut file, untuk dipulihkan dalam File Share, sebagai string. Jalur ini adalah jalur yang sama yang digunakan dalam perintah az storage file download atau az storage file show CLI.
  • SourceFileType: Pilih apakah direktori atau file dipilih. Menerima Direktori atau Berkas.
  • ResolveConflict: Instruksi jika ada konflik dengan data yang dipulihkan. Menerima opsi Timpa atau Lewati.

Memulihkan file atau folder individual ke lokasi asli

az backup restore restore-azurefiles Gunakan cmdlet dengan mode pemulihan yang diatur ke originallocation untuk memulihkan file atau folder tertentu ke lokasi aslinya.

Contoh berikut memulihkan file RestoreTest.txt di lokasi aslinya: azurefiles Berbagi File.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore/RestoreTest.txt" --resolve-conflict overwrite  --out table
Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

Atribut Name dalam output sesuai dengan nama pekerjaan yang dibuat oleh layanan cadangan untuk operasi pemulihan Anda. Untuk melacak status pekerjaan, gunakan cmdlet az backup job show .

Memulihkan file atau folder individual ke lokasi alternatif

Untuk memulihkan file atau folder tertentu ke lokasi alternatif, gunakan az backup restore restore-azurefiles cmdlet dengan mode pemulihan yang diatur ke alternatelocation dan tentukan parameter terkait target berikut:

  • --target-storage-account: Akun penyimpanan untuk memulihkan konten yang dicadangkan. Akun penyimpanan target harus berada di lokasi yang sama dengan kubah.
  • --target-file-share: Berbagi File dalam akun penyimpanan target di mana konten yang dicadangkan dipulihkan.
  • --target-folder: Folder di bawah Berbagi File tempat data dipulihkan. Jika konten yang dicadangkan akan dipulihkan ke direktori root, berikan nilai folder target sebagai string yang kosong.

Contoh berikut memulihkan file RestoreTest.txt yang awalnya ada di azurefiles Berbagi File ke lokasi alternatif: folder restoredata di Berbagi File azurefiles1 yang dihosting di akun penyimpanan afaccount1.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --source-file-type file --source-file-path "Restore/RestoreTest.txt" --out table
Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

Atribut Name dalam output sesuai dengan nama pekerjaan yang dibuat oleh layanan cadangan untuk operasi pemulihan Anda. Untuk melacak status pekerjaan, gunakan cmdlet az backup job show .

Memulihkan beberapa file atau folder ke lokasi asli atau alternatif

Untuk melakukan pemulihan untuk beberapa item, berikan nilai untuk parameter source-file-path sebagai jalur yang dipisahkan spasi dari semua file atau folder yang ingin Anda pulihkan.

Contoh berikut memulihkan file Restore.txt dan pengujian AFS Report.docx di lokasi aslinya.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932889937058317910 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore Test.txt" "AFS Testing Report.docx" --resolve-conflict overwrite  --out table

Outputnya akan mirip dengan yang berikut ini:

Name                                          ResourceGroup
------------------------------------          ---------------
649b0c14-4a94-4945-995a-19e2aace0305          azurefiles

Atribut Name dalam output sesuai dengan nama pekerjaan yang dibuat oleh layanan cadangan untuk operasi pemulihan Anda. Untuk melacak status pekerjaan, gunakan cmdlet az backup job show .

Jika Anda ingin memulihkan beberapa item ke lokasi alternatif, gunakan perintah di atas dengan menentukan parameter terkait target seperti yang dijelaskan di bagian Pulihkan file atau folder individual ke lokasi alternatif .

Langkah berikutnya

Mengelola cadangan Azure Files menggunakan portal Microsoft Azure, Azure PowerShell, Azure CLI, REST API.