Aktualizace konfigurací trezorů služby Azure Recovery Services pomocí rozhraní REST API

Tento článek popisuje, jak aktualizovat konfigurace související se zálohováním v trezoru služby Azure Recovery Services pomocí rozhraní REST API.

Stav obnovitelného odstranění

Odstranění záloh chráněné položky je významná operace, která se musí monitorovat. K ochraně před náhodným odstraněním má trezor služby Azure Recovery Services možnost obnovitelného odstranění. Tato funkce umožňuje v případě potřeby obnovit odstraněné zálohy během časového období po odstranění.

Existují ale scénáře, ve kterých tato funkce není nutná. Trezor služby Azure Recovery Services nejde odstranit, pokud v něm existují zálohované položky, a to ani obnovitelné odstraněné položky. To může být problém, pokud je potřeba trezor okamžitě odstranit. Například: Operace nasazení často vyčistí vytvořené prostředky ve stejném pracovním postupu. Nasazení může vytvořit trezor, nakonfigurovat zálohy pro položku, provést testovací obnovení a pak pokračovat odstraněním zálohovaných položek a trezoru. Pokud se odstranění trezoru nezdaří, může selhat celé nasazení. Zakázání obnovitelného odstranění je jediným způsobem, jak zaručit okamžité odstranění.

Proto je potřeba pečlivě zvolit, jestli chcete v závislosti na scénáři zakázat obnovitelné odstranění konkrétního trezoru. Další informace najdete v článku o obnovitelném odstranění.

Načtení stavu obnovitelného odstranění pomocí rozhraní REST API

Ve výchozím nastavení se u nově vytvořeného trezoru služby Recovery Services povolí stav obnovitelného odstranění. Pokud chcete načíst nebo aktualizovat stav obnovitelného odstranění trezoru, použijte dokument rozhraní REST API související s konfigurací trezoru záloh.

Pokud chcete načíst aktuální stav obnovitelného odstranění trezoru, použijte následující operaci GET .

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

Identifikátor URI GET obsahuje {subscriptionId}parametry , {vaultName}{vaultresourceGroupName} V tomto příkladu {vaultName} je "testVault" a {vaultresourceGroupName} je "testVaultRG". Vzhledem k tomu, že všechny požadované parametry jsou uvedené v identifikátoru URI, není nutné použít samostatný text požadavku.

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

Odpovědi

Úspěšná odpověď operace GET je zobrazená níže:

Name	Typ	Popis
200 OK	BackupResourceVaultConfig	OK

Příklad odpovědi

Po odeslání požadavku GET se vrátí odpověď 200 (úspěšná).

{
  "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"
  }
}

Aktualizace stavu obnovitelného odstranění pomocí rozhraní REST API

Pokud chcete aktualizovat stav obnovitelného odstranění trezoru služby Recovery Services pomocí rozhraní REST API, použijte následující operaci PUT .

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

Identifikátor URI PUT obsahuje {subscriptionId}parametry , {vaultName}{vaultresourceGroupName} . V tomto příkladu {vaultName} je "testVault" a {vaultresourceGroupName} je "testVaultRG". Pokud identifikátor URI nahradíme hodnotami uvedenými výše, bude identifikátor URI vypadat takto.

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

Vytvoření textu požadavku

Následující běžné definice se používají k vytvoření textu požadavku.

Další podrobnosti najdete v dokumentaci k rozhraní REST API.

Název	Požadováno	Typ	Popis
Etag		Řetězec	Volitelná eTag
umístění	pravda	Řetězec	Umístění prostředku
vlastnosti		VaultProperties	Vlastnosti trezoru
značek		Objekt	Značky prostředků

Příklad textu požadavku

Následující příklad slouží k aktualizaci stavu obnovitelného odstranění na zakázáno.

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

Odpovědi na operaci PATCH

Úspěšná odpověď operace PATCH je znázorněna níže:

Name	Typ	Popis
200 OK	BackupResourceVaultConfig	OK

Příklad odpovědi pro operaci PATCH

Po odeslání požadavku PATCH se vrátí odpověď 200 (úspěšná).

{
  "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"
  }
}

Další kroky

Vytvořte zásadu zálohování pro zálohování virtuálního počítače Azure v tomto trezoru.

Další informace o rozhraních Azure REST API najdete v následujících dokumentech:

• Rozhraní REST API zprostředkovatele služby Azure Recovery Services
• Začínáme s Azure REST API