Skapa Azure Backup-valv med HJÄLP av REST API

I den här artikeln beskrivs hur du skapar ett säkerhetskopieringsvalv med hjälp av REST API. Du kan också skapa ett säkerhetskopieringsvalv med hjälp av Azure-portalen.

Azure Backups nya dataskyddsplattform ger förbättrade funktioner för säkerhetskopiering och återställning för nyare arbetsbelastningar, till exempel blobar i lagringskonton, hanterad disk och PostgreSQL-serverns PaaS-plattform. Det syftar till att minimera hanteringskostnaderna och samtidigt göra det enkelt att organisera säkerhetskopior. Ett "Backup-valv" är hörnstenen i dataskyddsplattformen och det skiljer sig från Recovery Services-valvet.

Stegen för att skapa ett Azure Backup-valv med hjälp av REST API beskrivs i dokumentationen för REST API för skapa valv. Nu ska vi använda det här dokumentet som referens för att skapa ett valv med namnet testBkpVault i West US och under TestBkpVaultRG resursgruppen.

Om du vill skapa eller uppdatera ett Azure Backup-valv använder du följande PUT-åtgärd .

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-01

Skapa en begäran

För att skapa PUT-begäran krävs parametern {subscription-id} . Om du har flera prenumerationer kan du läsa Arbeta med flera prenumerationer. Du definierar en {resourceGroupName} och {vaultName} för dina resurser, tillsammans med parametern api-version . Den här artikeln använder api-version=2021-01-01.

Följande rubriker krävs:

Mer information om hur du skapar begäran finns i Komponenter i en REST API-begäran/-svar.

Skapa begärandetexten

Följande vanliga definitioner används för att skapa en begärandetext:

Observera att valvnamn och resursgruppsnamn anges i PUT-URI:n. Begärandetexten definierar platsen.

Exempel på begärandetext

Följande exempeltextblock används för att skapa ett valv i "västra USA". Ange platsen.

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

Om du vill skapa ett säkerhetskopieringsvalv och även generera en systemtilldelad identitet ska följande begärandetext anges.

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

Svar

Att skapa ett säkerhetskopieringsvalv är en asynkron åtgärd. Det innebär att den här åtgärden skapar en annan åtgärd som måste spåras separat. Det finns två lyckade svar för åtgärden för att skapa eller uppdatera ett säkerhetskopieringsvalv:

Mer information om REST API-svar finns i Bearbeta svarsmeddelandet.

Exempelsvar

Ett kondenserat 201 Created-svar från föregående exempelbegäran visar att ett id har tilldelats och provisioningState är Succeeded:

{
    "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ästa steg

Skapa en säkerhetskopieringsprincip för säkerhetskopiering av blobar i det här valvet.

Mer information om Azure REST-API:er finns i följande dokument:

• REST API för Azure Data Protection-provider
• Komma igång med Azure REST API