Freigeben über

Erstellen eines Azure Backup-Tresors mithilfe der REST-API

In diesem Artikel wird beschrieben, wie Sie einen Sicherungstresor mithilfe der REST-API erstellen. Sie können auch einen Sicherungstresor über das Azure-Portal erstellen.

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. Lassen Sie uns dieses Dokument als Referenz verwenden, um einen Tresor mit dem Namen testBkpVault in West US und in der Ressourcengruppe TestBkpVaultRG zu erstellen.

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
Inhaltstyp: Erforderlich. Legen Sie diese Option auf application/json fest.
Autorisierung: Erforderlich. Legen Sie diese Option auf ein gültiges BearerZugriffstoken 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 Typ BESCHREIBUNG
eTag Schnur Optionales ETag
location Wahr Schnur Ressourcenspeicherort
Eigenschaften Wahr BackupVault Eigenschaften des Tresors
Identität DPPIdentityDetails Gibt den eindeutigen Systembezeichner für jede Azure-Ressource an.
Schlagwörter Objekt 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 type BESCHREIBUNG
200 – OK BackupVaultResource OKAY
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:

  • Last updated on