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

Článek
05/30/2024

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ě zakázat funkci obnovitelného odstranění konkrétního trezoru v závislosti na konkrétním scénáři. Přečtěte si další informace 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	Type	Popis
Etag		String	Volitelná eTag
location	true	String	Umístění prostředku
vlastnosti		VaultProperties	Vlastnosti trezoru
značky		Object	Značky prostředků

Příklad textu požadavku

Pomocí následujícího příkladu aktualizujte stav 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:

Sdílet prostřednictvím