Bagikan melalui

Memperbarui konfigurasi vault Layanan Pemulihan dengan REST API

  • Artikel

Artikel ini menjelaskan cara memperbarui konfigurasi terkait pencadangan di vault Layanan Pemulihan Azure menggunakan REST API.

Kondisi penghapusan sementara

Penghapusan cadangan item yang diproteksi adalah tindakan penting harus dipantau. Untuk melindungi dari penghapusan yang tidak disengaja, vault Layanan Pemulihan Azure memiliki kemampuan penghapusan sementara. Kemampuan ini memungkinkan Anda memulihkan cadangan yang dihapus, jika perlu, dalam periode waktu setelah penghapusan.

Tetapi ada skenario di mana kemampuan ini tidak diperlukan. Vault Layanan Pemulihan Azure tidak dapat dihapus jika ada item cadangan di dalamnya, bahkan yang dihapus sementara. Hal ini dapat menimbulkan masalah jika vault perlu segera dihapus. Misalnya: operasi penyebaran sering membersihkan sumber daya yang dibuat dalam alur kerja yang sama. Penerapan dapat membuat vault, mengkonfigurasi pencadangan untuk item, melakukan pemulihan pengujian lalu melanjutkan untuk menghapus item cadangan dan vault. Jika penghapusan vault gagal, seluruh penerapan mungkin gagal. Menonaktifkan penghapusan sementara adalah satu-satunya cara untuk melakukan penghapusan segera.

Jadi Anda perlu dengan hati-hati memilih untuk menonaktifkan fitur penghapusan sementara untuk vault tertentu tergantung pada skenarionya. Pelajari selengkapnya tentang penghapusan sementara.

Mendapatkan status penghapusan sementara menggunakan REST API

Secara default, status penghapusan sementara akan diaktifkan untuk vault Layanan Pemulihan yang baru dibuat. Untuk mendapatkan/memperbarui status penghapusan sementara untuk vault, gunakan dokumen REST API terkait konfigurasi vault cadangan

Untuk mendapatkan status penghapusan sementara saat ini untuk vault, gunakan fungsi GET berikut

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

GET URI memiliki parameter {subscriptionId}, {vaultName}, {vaultresourceGroupName}. Dalam contoh ini, {vaultName} adalah "testVault" dan {vaultresourceGroupName} adalah "testVaultRG". Karena semua parameter yang diperlukan ada dalam URI, tidak perlu ada permintaan terpisah.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Respons

Respons yang berhasil untuk fungsi 'GET' ditunjukkan di bawah ini:

Nama Tipe Deskripsi
200 OK BackupResourceVaultConfig OK
Contoh tanggapan

Setelah permintaan 'GET' dikirimkan, respons 200 (berhasil) akan muncul.

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

Mendapatkan status penghapusan sementara menggunakan REST API

Untuk memperbarui status penghapusan sementara vault Layanan Pemulihan menggunakan REST API, gunakan operasi PUT berikut 

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

PUT URI memiliki parameter {subscriptionId}, {vaultName}, {vaultresourceGroupName}. Dalam contoh ini, {vaultName} adalah "testVault" dan {vaultresourceGroupName} adalah "testVaultRG". Jika kita mengganti URI dengan nilai-nilai di atas, maka URI akan terlihat seperti ini.

PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Buat isi permintaan

Definisi umum berikut digunakan untuk membuat badan permintaan

Untuk detail selengkapnya, lihat dokumentasi REST API

Nama Wajib Tipe Deskripsi
eTag String eTag opsional
lokasi benar String Lokasi sumber daya
properti VaultProperties Properti vault
tag Objek Tag sumber daya

Contoh isi permintaan

Gunakan contoh berikut untuk memperbarui status penghapusan sementara ke 'dinonaktifkan'.

{
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Respons untuk fungsi PATCH

Respons fungsi 'PATCH' yang berhasil ditunjukkan di bawah ini:

Nama Tipe Deskripsi
200 OK BackupResourceVaultConfig OK
Contoh respons untuk fungsi PATCH

Setelah permintaan 'PATCH' dikirimkan, respons 200 (berhasil) akan muncul.

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Langkah berikutnya

Buat kebijakan pencadangan untuk mencadangkan komputer virtual Azure di vault ini.

Untuk informasi selengkapnya tentang Azure REST API, lihat dokumen berikut ini: