Erstellen eines Azure Recovery Services-Tresors mit der REST-API für Azure Backup

Artikel
04/15/2024

In diesem Artikel wird beschrieben, wie Sie einen Azure Recovery Services-Tresors mit der REST-API erstellen. Informationen zum Erstellen des Tresors mithilfe des Azure-Portals finden Sie in diesem Artikel.

Ein Recovery Services-Tresor ist eine Speicherentität in Azure, die Daten enthält. Bei den Daten handelt es sich in der Regel um Kopien von Daten oder Konfigurationsinformationen für virtuelle Computer (VMs), Workloads, Server oder Arbeitsstationen. Mit Recovery Services-Tresoren können Sie Sicherungsdaten für verschiedene Azure-Dienste speichern, z. B. IaaS-VMs (Linux oder Windows) und SQL Server auf Azure-VMs. Recovery Services-Tresore unterstützen System Center DPM, Windows Server, Azure Backup Server etc. Recovery Services-Tresore vereinfachen die Organisation Ihrer Sicherungsdaten und minimieren gleichzeitig den Verwaltungsaufwand.

Vor der Installation

Das Erstellen eines Azure Recovery Services-Tresors mit der REST-API wird im Artikel REST-API zum Erstellen von Tresoren beschrieben. Wir verwenden diesen Artikel als Referenz, um einen Tresor namens testVault in West US zu erstellen.

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-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=2016-06-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		VaultProperties	Eigenschaften des Tresors
sku		sku	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 einen Tresor zu erstellen. Geben Sie den Standort an. Die SKU lautet immer Standard.

{
  "properties": {},
  "sku": {
    "name": "Standard"
  },
  "location": "West US"
}

Antworten

Es gibt zwei erfolgreiche Antworten für den Vorgang, um einen Recovery Services-Tresor zu erstellen oder zu aktualisieren:

Name	Typ	BESCHREIBUNG
200 – OK	Tresor	OK
201 – Erstellt	Tresor	Erstellt

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:

{
  "location": "westus",
  "name": "testVault",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/testVault",
  "type": "Microsoft.RecoveryServices/vaults",
  "sku": {
    "name": "Standard"
  }
}

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