Freigeben über

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

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 beispielsweise System Center DPM, Windows Server und Azure Backup Server. Recovery Services-Tresore vereinfachen die Organisation Ihrer Sicherungsdaten und minimieren gleichzeitig den Verwaltungsaufwand.

Vor der Installation

Bevor Sie mit der Erstellung des Recovery Services-Tresors beginnen, überprüfen Sie bitte die folgenden Details:

  • Für die Erstellung des Tresors wird api-version=2016-06-01 verwendet.
  • 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 Sie eine Anforderung, um den Recovery Services-Tresor zu erstellen.

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
Inhaltstyp: Erforderlich. Legen Sie 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 Sie den Anforderungstext, um den Recovery Services-Tresor zu erstellen

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-Anforderungstext zur Erstellung eines Recovery Services-Tresors

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 type BESCHREIBUNG
200 – OK Vault OK
201 – Erstellt Vault 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 für die Sicherung einer Azure-VM in diesem Tresor.

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

  • Last updated on