Erstellen eines Azure Backup-Tresors mithilfe der REST-API

Artikel
07/18/2024

Die neue Datenschutzplattform von Azure Backup bietet erweiterte Funktionen für die Sicherung und Wiederherstellung neuerer Workloads, z. B. BLOB in Speicherkonten, verwalteter Datenträger und PaaS-Plattform des PostgreSQL-Servers. Das Ziel ist es, den Verwaltungsaufwand zu minimieren und gleichzeitig die Organisation von Sicherungen zu beschleunigen. Ein „Sicherungstresor“ ist der Grundbaustein der Datenschutzplattform und unterscheidet sich vom Recovery Services-Tresor.

Die Schritte zum Erstellen eines Azure Backup-Tresors mit der REST-API finden Sie in der Dokumentation zur REST-API zum Erstellen von Tresoren. Nutzen Sie dieses Dokument als Referenz zum Erstellen eines Tresors mit dem Namen „testBkpVault“ in der Region „USA, Westen“ unter der Ressourcengruppe „TestBkpVaultRG“.

Verwenden Sie den folgenden PUT-Vorgang, um einen Azure Backup-Tresor zu erstellen oder zu aktualisieren:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-01

Erstellen einer Anforderung

Zum Erstellen der PUT-Anforderung ist der {subscription-id}-Parameter erforderlich. Wenn Sie über mehrere Abonnements verfügen, lesen Sie Verwenden mehrerer Abonnements: Sie definieren zusammen mit dem api-version-Parameter einen {resourceGroupName} und {vaultName} für Ihre Ressourcen. In diesem Artikel wird api-version=2021-01-01 verwendet.

Die folgenden Header sind erforderlich:

Anforderungsheader	BESCHREIBUNG
Content-Type:	Erforderlich. Legen Sie diese Option auf `application/json` fest.
Authorization:	Erforderlich. Legen Sie diese Option auf ein gültiges `Bearer`-Zugriffstoken fest.

Weitere Informationen zum Erstellen der Anforderung finden Sie unter Komponenten einer REST-API-Anforderung/Antwort.

Erstellen des Anforderungstexts

Die folgenden allgemeinen Definitionen werden verwendet, um einen Anforderungstext zu erstellen:

Name	Erforderlich	Type	BESCHREIBUNG
eTag		String	Optionales ETag
location	true	String	Ressourcenspeicherort
properties	true	BackupVault	Eigenschaften des Tresors
Identity		DPPIdentityDetails	Gibt den eindeutigen Systembezeichner für jede Azure-Ressource an.
tags		Object	Ressourcentags

Beachten Sie, dass der Tresorname und Ressourcengruppenname im PUT-URI bereitgestellt werden. Im Anforderungstext wird der Standort definiert.

Beispiel für Anforderungstext

Der folgende Beispieltext wird verwendet, um in „West US“ (USA, Westen) einen Tresor zu erstellen. Geben Sie den Standort an.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "None"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Wenn Sie einen Sicherungstresor erstellen und auch eine systemseitig zugewiesene Identität generieren möchten, sollte der folgende Anforderungstext angegeben werden.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "systemAssigned"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Antworten

Das Erstellen eines Sicherungstresors ist ein asynchroner Vorgang. Das bedeutet, dass in diesem Vorgang ein anderer Vorgang erstellt wird, der separat nachverfolgt werden muss. Es gibt zwei erfolgreiche Antworten für den Vorgang, um einen Sicherungstresor zu erstellen oder zu aktualisieren:

Name	Typ	BESCHREIBUNG
200 – OK	BackupVaultResource	OK
201 – Erstellt	BackupVaultResource	Erstellt
Andere Statuscodes	CloudError

Weitere Informationen zu REST-API-Antworten finden Sie unter Verarbeiten der Antwortnachricht.

Beispielantwort

Die komprimierte Antwort 201 – Erstellt aus dem vorherigen Beispielanforderungstext zeigt, dass eine id zugewiesen wurde und provisioningState auf Succeeded festgelegt ist:

{
    "eTag": null,
    "id": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/TestBkpVaultRG/providers/Microsoft.DataProtection/BackupVaults/testBkpVault",
    "identity": {
      "principalId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "tenantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "SystemAssigned"
    },
    "location": "westUS",
    "name": "testBkpVault",
    "properties": {
      "provisioningState": "Succeeded",
      "storageSettings": [
        {
          "datastoreType": "VaultStore",
          "type": "GeoRedundant"
        }
      ]
    },
    "resourceGroup": "TestBkpVaultRG",
    "systemData": null,
    "tags": {},
    "type": "Microsoft.DataProtection/backupVaults"
  }

Nächste Schritte

Erstellen Sie eine Sicherungsrichtlinie zum Sichern von Blobs in diesem Tresor.

Weitere Informationen zu den Azure-REST-APIs finden Sie in den folgenden Dokumenten:

Freigeben über