Aktualisieren von Konfigurationen eines Azure Recovery Services-Tresors mithilfe der REST-API

Artikel
11/02/2023

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 die vorläufige Löschfunktion für einen bestimmten Tresor deaktivieren möchten. Erfahren Sie mehr über das vorläufige 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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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/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"
  }
}

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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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	Type	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/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"
  }
}

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:

Freigeben über