Teilen über

Aktualisieren von Azure Recovery Services-Tresorkonfigurationen mithilfe der REST-API

In diesem Artikel wird beschrieben, wie Sie sicherungsbezogene Konfigurationen im Azure Recovery Services-Tresor mithilfe der REST-API aktualisieren.

Verwalten von Soft-Löschvorgängen im Recovery Services Speicher

Das Löschen von Sicherungen eines geschützten Elements ist ein wichtiger 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. Mit dieser Funktion können Sie gelöschte Sicherungen ggf. innerhalb eines Zeitraums nach dem Löschen wiederherstellen.

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 ein Problem darstellen, wenn der Tresor sofort gelöscht werden muss. Ein Beispiel: Bereitstellungsoperationen bereinigen häufig die erstellten Ressourcen innerhalb desselben Workflows. Eine Bereitstellung kann einen Tresor erstellen, Sicherungen für ein Element konfigurieren, eine Testwiederherstellung durchführen und dann mit dem Löschen der Sicherungselemente und des Tresors fortfahren. Wenn der Tresor nicht gelöscht werden kann, ist unter Umständen die gesamte Bereitstellung nicht erfolgreich. Das Deaktivieren des vorläufigen Löschens ist die einzige Möglichkeit, sofortige Löschungen zu gewährleisten.

Sie müssen sich je nach Szenario genau überlegen, ob Sie die vorläufige Löschfunktion für einen bestimmten Tresor deaktivieren möchten. Weitere Informationen zum vorläufigen Löschen.

Abrufen des Soft-Löschzustands über die 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 hat die Parameter {subscriptionId}, {vaultName} und {vaultresourceGroupName}. In diesem Beispiel {vaultName} ist "testVault" und {vaultresourceGroupName} "testVaultRG". Da alle erforderlichen Parameter im URI angegeben werden, ist kein separater Anforderungstext erforderlich.

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 Vorgang "GET" wird unten angezeigt:

Name Typ Description
200 – OK BackupResourceVaultConfig OKAY
Beispielantwort

Sobald die Anforderung "GET" übermittelt wurde, wird eine Antwort von 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"
  }
}

Den Soft-Delete-Zustand mithilfe der REST-API aktualisieren

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 {vaultName} ist "testVault" und {vaultresourceGroupName} "testVaultRG". Wenn wir den URI durch die oben genannten Werte ersetzen, sieht der URI 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.

Weitere Details finden Sie in der REST-API-Dokumentation

Name Erforderlich Typ Description
eTag String Optionales ETag
location Wahr String Ressourcenspeicherort
properties VaultProperties Eigenschaften des Tresors
tags Object Ressourcenetiketten

Beispiel für Anforderungstext

Verwenden Sie das folgende Beispiel, um den Zustand des Soft-Löschens auf "deaktiviert" zu aktualisieren.

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

Antworten für den PATCH-Vorgang

Die erfolgreiche Antwort für den PATCH-Vorgang wird unten angezeigt:

Name Typ Description
200 – OK BackupResourceVaultConfig OKAY
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:

  • Last updated on