Een Azure Recovery Services-kluis maken met rest API voor Azure Backup

Artikel
04/10/2024

In dit artikel wordt beschreven hoe u een Azure Recovery Services-kluis maakt met behulp van REST API. Zie dit artikel voor het maken van de kluis met behulp van Azure Portal.

Een Recovery Services-kluis is een opslagentiteit in Azure waarin gegevens worden opgeslagen. De gegevens bestaan meestal uit kopieën van gegevens of configuratiegegevens voor virtuele machines (VM's), workloads, servers of werkstations. U kunt Recovery Services-kluizen gebruiken om back-upgegevens te bewaren voor verschillende Azure-services, zoals IaaS-VM's (Linux of Windows) en SQL Server in Azure-VM's. Recovery Services-kluizen ondersteunen System Center DPM, Windows Server, Azure Backup Server en meer. Recovery Services-kluizen maken het eenvoudig om uw back-upgegevens te ordenen, terwijl de beheertaken minimaal zijn.

Voordat u begint

Het maken van een Azure Recovery Services-kluis met behulp van REST API wordt beschreven in het artikel over het maken van de REST API van de kluis. Laten we dit artikel gebruiken als verwijzing naar het maken van een kluis met de naam testVault in West US.

Gebruik de volgende PUT-bewerking om een Azure Recovery Services-kluis te maken of bij te werken:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-01

Een aanvraag maken

Als u de PUT-aanvraag wilt maken, is de {subscription-id} parameter vereist. Zie Werken met meerdere abonnementen als u meerdere abonnementen hebt. U definieert een {resourceGroupName} en {vaultName} voor uw resources, samen met de api-version parameter. In dit artikel wordt gebruikgemaakt van api-version=2016-06-01.

De volgende headers zijn vereist:

Aanvraagheader	Beschrijving
Inhoudstype:	Vereist. Ingesteld op `application/json`.
Autorisatie:	Vereist. Ingesteld op een geldig `Bearer`toegangstoken.

Zie Onderdelen van een REST API-aanvraag/-antwoord voor meer informatie over het maken van de aanvraag.

De hoofdtekst van de aanvraag maken

De volgende algemene definities worden gebruikt om een aanvraagbody te bouwen:

Naam	Vereist	Type	Description
eTag		String	Optionele eTag
locatie	true	String	Resourcelocatie
properties		VaultProperties	Eigenschappen van de kluis
sku		SKU	Identificeert de unieke systeem-id voor elke Azure-resource
tags		Object	Resourcetags

Houd er rekening mee dat kluisnaam en resourcegroepnaam worden opgegeven in de PUT-URI. De hoofdtekst van de aanvraag definieert de locatie.

Voorbeeld van aanvraagbody

De volgende voorbeeldtekst wordt gebruikt om een kluis in West USte maken. Geef de locatie op. De SKU is altijd Standard.

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

Antwoorden

Er zijn twee geslaagde antwoorden voor de bewerking om een Recovery Services-kluis te maken of bij te werken:

Name	Type	Description
200 OK	Kluis	OK
201 Gemaakt	Kluis	Gemaakt

Zie Het antwoordbericht verwerken voor meer informatie over REST API-antwoorden.

Voorbeeld van een antwoord

Een verkort antwoord van 201 Gemaakt antwoord van de vorige voorbeeldaanvraagtekst geeft aan dat er een id is toegewezen en dat de provisioningState is geslaagd:

{
  "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"
  }
}

Volgende stappen

Maak een back-upbeleid voor het maken van een back-up van een Virtuele Azure-machine in deze kluis.

Zie de volgende documenten voor meer informatie over de Azure REST API's:

Delen via