Aktualisieren von Konfigurationen eines Azure Recovery Services-Tresors mithilfe der REST-API
In diesem Artikel erfahren Sie, wie Sie sicherungsbezogene Konfigurationen in einem Azure Recovery Services-Tresor mithilfe der REST-API aktualisieren.
Zustand des vorläufigen Löschens
Das Löschen von Sicherungen eines geschützten Elements ist ein kritischer Vorgang, der überwacht werden muss. Zum Schutz vor versehentlicher Löschung verfügt der Azure Recovery Services-Tresor über eine Funktion für vorläufiges Löschen. Diese Funktion ermöglicht Ihnen, gelöschte Sicherungen ggf. innerhalb eines bestimmten Zeitfensters nach der Löschung wiederherstellen können.
Es gibt jedoch Szenarien, in denen diese Funktion nicht erforderlich ist. Ein Azure Recovery Services-Tresor, der Sicherungselemente enthält, kann auch dann nicht gelöscht werden, wenn sich die Elemente im Zustand „Vorläufig gelöscht“ befinden. Dies kann problematisch sein, wenn der Tresor umgehend gelöscht werden muss. Ein Beispiel: Bei Bereitstellungsvorgängen werden die erstellten Ressourcen häufig im gleichen Workflow bereinigt. Eine Bereitstellung kann einen Tresor erstellen, Sicherungen für ein Element konfigurieren, eine Testwiederherstellung durchführen und anschließend die Sicherungselemente und den Tresor wieder löschen. Wenn der Tresor nicht gelöscht werden kann, ist unter Umständen die gesamte Bereitstellung nicht erfolgreich. Die umgehende Löschung kann nur durch Deaktivieren des vorläufigen Löschens sichergestellt werden.
Sie müssen sich je nach Szenario genau überlegen, ob Sie das vorläufige Löschen für einen bestimmten Tresor deaktivieren möchten. Weitere Informationen finden Sie im Artikel zu vorläufigem Löschen.
Abrufen des Zustands des vorläufigen Löschens mithilfe der REST-API
Das vorläufige Löschen ist für neu erstellte Recovery Services-Tresore standardmäßig aktiviert. Informationen zum Abrufen/Aktualisieren des Zustands des vorläufigen Löschens für einen Tresor finden Sie in der konfigurationsbezogenen REST-API-Dokumentation des Sicherungstresors.
Verwenden Sie den folgenden GET-Vorgang, um den aktuellen Zustand des vorläufigen Löschens für einen Tresor abzurufen:
GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15
Der GET-URI verfügt über die Parameter {subscriptionId}, {vaultName} und {vaultresourceGroupName}. In diesem Beispiel ist {vaultName} auf „testVault“ und {vaultresourceGroupName} auf „testVaultRG“ festgelegt. Da alle erforderlichen Parameter im URI angegeben sind, besteht keine Notwendigkeit eines separaten Anforderungstexts.
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
Antworten
Die erfolgreiche Antwort für den GET-Vorgang sieht wie folgt aus:
| Name | Typ | BESCHREIBUNG |
|---|---|---|
| 200 – OK | BackupResourceVaultConfig | OK |
Beispielantwort
Nach Übermittlung der GET-Anforderung wird eine Antwort vom Typ „200“ (erfolgreich) zurückgegeben.
{
"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"
}
}
Aktualisieren des Zustands des vorläufigen Löschens mithilfe der REST-API
Verwenden Sie den folgenden PUT-Vorgang, um den Zustand des vorläufigen Löschens des Recovery Services-Tresors mithilfe der REST-API zu aktualisieren.
PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15
Der PUT-URI verfügt über die Parameter {subscriptionId}, {vaultName} und {vaultresourceGroupName}. In diesem Beispiel ist {vaultName} auf „testVault“ und {vaultresourceGroupName} auf „testVaultRG“ festgelegt. Wenn wir den URI mit den obigen Werten versehen, sieht er wie folgt aus:
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
Erstellen des Anforderungstexts
Die folgenden allgemeinen Definitionen werden verwendet, um einen Anforderungstext zu erstellen:
Ausführlichere Informationen finden Sie in der REST-API-Dokumentation.
| Name | Erforderlich | Art | BESCHREIBUNG |
|---|---|---|---|
| eTag | String | Optionales ETag | |
| location | true | String | Ressourcenspeicherort |
| properties | VaultProperties | Eigenschaften des Tresors | |
| tags | Object | Ressourcentags |
Beispiel für Anforderungstext
Im folgenden Beispiel wird der Zustand des vorläufigen Löschens in „Disabled“ (Deaktiviert) geändert.
{
"properties": {
"enhancedSecurityState": "Enabled",
"softDeleteFeatureState": "Disabled"
}
}
Antworten für den Patch-Vorgang
Die erfolgreiche Antwort für den PATCH-Vorgang sieht wie folgt aus:
| Name | Typ | BESCHREIBUNG |
|---|---|---|
| 200 – OK | BackupResourceVaultConfig | OK |
Beispielantwort für den PATCH-Vorgang
Nach Übermittlung der PATCH-Anforderung wird eine Antwort vom Typ „200“ (erfolgreich) zurückgegeben.
{
"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"
}
}
Nächste Schritte
Erstellen Sie eine Sicherungsrichtlinie zum Sichern einer Azure-VM in diesem Tresor.
Weitere Informationen zu den Azure-REST-APIs finden Sie in den folgenden Dokumenten: