Memperbarui konfigurasi vault Azure Recovery Services menggunakan REST API

Artikel ini menjelaskan cara memperbarui konfigurasi terkait pencadangan pada vault Azure Recovery Services dengan menggunakan REST API.

Mengelola operasi penghapusan lunak di Layanan Pemulihan vault

Menghapus cadangan item yang dilindungi adalah operasi signifikan yang harus dipantau. Untuk melindungi dari penghapusan yang tidak disengaja, vault Azure Recovery Services memiliki fitur penghapusan lunak yang memungkinkan pemulihan data yang dihapus. 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 Azure Recovery Services tidak dapat dihapus jika ada item cadangan di dalamnya, bahkan yang dihapus sementara. Ini dapat menimbulkan masalah jika vault perlu segera dihapus. Misalnya: operasi penempatan sering menghapus (membersihkan) sumber daya yang dibuat dalam alur kerja yang sama. Penyebaran dapat membuat vault, mengonfigurasi cadangan untuk item, melakukan pemulihan uji coba, kemudian melanjutkan dengan menghapus item cadangan dan vault. Jika penghapusan vault gagal, seluruh implementasi mungkin gagal. Menonaktifkan penghapusan sementara adalah satu-satunya cara untuk menjamin 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.

Mengambil status penghapusan sementara menggunakan REST API

Secara default, soft delete akan diaktifkan untuk Recovery Services vault yang baru dibuat. Untuk mengambil/memperbarui status hapus lunak sebuah vault, gunakan dokumen REST API terkait konfigurasi vault cadangan.

Untuk mengambil status penghapusan sementara saat ini untuk vault, gunakan operasi 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}, dan {vaultresourceGroupName}. Dalam contoh ini, {vaultName} adalah "testVault" dan {vaultresourceGroupName} merupakan "testVaultRG". Karena semua parameter yang diperlukan sudah ada dalam URI, tidak perlu ada badan permintaan yang terpisah.

GET https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Tanggapan

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

Nama Tipe Deskripsi
200 OK (Permintaan berhasil) BackupResourceVaultConfig OK
Contoh tanggapan

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

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

Mengupdate state soft delete menggunakan REST API

Untuk memperbarui status soft delete dari 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 {subscriptionId}, {vaultName}, {vaultresourceGroupName} parameter. Dalam contoh ini, {vaultName} adalah "testVault" dan {vaultresourceGroupName} merupakan "testVaultRG". Jika kita mengganti URI dengan nilai di atas, maka URI akan terlihat seperti ini.

PUT https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Buat isi permintaan

Definisi umum berikut digunakan untuk membuat isi permintaan

Untuk detail selengkapnya, lihat dokumentasi REST API

Nama Diperlukan Tipe Deskripsi
eTag String ETag Opsional
lokasi benar String Lokasi sumber daya
properties VaultProperties Properti vault
tags Objek Tag sumber daya

Contoh isi permintaan

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

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

Respons untuk operasi PATCH

Respons yang berhasil untuk operasi 'PATCH' ditunjukkan di bawah ini:

Nama Tipe Deskripsi
200 OK (Permintaan berhasil) BackupResourceVaultConfig OK
Contoh respons untuk operasi PATCH tersebut

Setelah permintaan 'PATCH' dikirimkan, respons dikembalikan dengan kode status 200 (berhasil).

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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 cadangan untuk mencadangkan VM Azure di vault ini.

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

  • Last updated on