Azure Backup-kluis maken met behulp van REST API

In dit artikel wordt beschreven hoe u een Back-upkluis maakt met behulp van REST API. U kunt ook een Backup-kluis maken met behulp van Azure Portal.

Het nieuwe Data Protection-platform van Azure Backup biedt verbeterde mogelijkheden voor back-up en herstel voor nieuwere workloads, zoals blobs in opslagaccounts, beheerde schijf en paaS-platform van De PostgreSQL-server. Het is erop gericht om de beheeroverhead te minimaliseren en het eenvoudig te maken om back-ups te organiseren. Een Back-upkluis is de hoeksteen van het platform voor gegevensbeveiliging en dit verschilt van de Recovery Services-kluis.

De stappen voor het maken van een Azure Backup-kluis met behulp van REST API worden beschreven in de documentatie over de REST API voor een kluis maken. Laten we dit document gebruiken als verwijzing om een kluis genaamd testBkpVault te maken in West US en onder de resourcegroep TestBkpVaultRG.

Gebruik de volgende PUT-bewerking om een Azure Backup-kluis te maken of bij te werken.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-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=2021-01-01.

De volgende headers zijn vereist:

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:

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

Voorbeeld van aanvraaginhoud

De volgende voorbeeldtekst wordt gebruikt om een kluis te maken in West-US. Geef de locatie op.

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

Als u een back-upkluis wilt maken en ook een door het systeem toegewezen identiteit wilt genereren, moet de volgende aanvraagbody worden gegeven.

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

Antwoorden

Het maken van een back-upkluis is een asynchrone bewerking. Dit betekent dat met deze bewerking een andere bewerking wordt gemaakt die afzonderlijk moet worden bijgehouden. Er zijn twee geslaagde antwoorden voor de bewerking om een Backup-kluis te maken of bij te werken:

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

Voorbeeld van een antwoord

Een verkorte 201 Created reactie van de vorige voorbeeldaanvraag toont dat een id is toegewezen en dat de provisioningStateSucceeded is:

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

Volgende stappen

Ontwikkel een beleid voor het maken van back-ups van blobs in deze kluis.

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

• REST API van Azure Data Protection-provider
• Aan de slag gaan met Azure REST API