Sdílet prostřednictvím

Vytvoření trezoru služby Azure Backup pomocí rozhraní REST API

Tento článek popisuje, jak vytvořit trezor služby Backup pomocí rozhraní REST API. Trezor služby Backup můžete vytvořit také pomocí webu Azure Portal.

Nová platforma služby Azure Backup pro ochranu dat poskytuje vylepšené možnosti zálohování a obnovení pro novější úlohy, jako jsou objekty blob v účtech úložiště, spravovaný disk a platforma PaaS serveru PostgreSQL. Cílem je minimalizovat režijní náklady na správu a zároveň usnadňuje uspořádání záloh. Trezor služby Backup je základním kamenem platformy ochrany dat a liší se od trezoru Recovery Services.

Postup vytvoření trezoru Služby Azure Backup pomocí rozhraní REST API najdete v dokumentaci k rozhraní REST API pro vytvoření trezoru. Tento dokument použijme jako referenční při vytváření trezoru nazvaného testBkpVault, který bude umístěn v West US a v rámci skupiny prostředků TestBkpVaultRG.

Pokud chcete vytvořit nebo aktualizovat trezor služby Azure Backup, použijte následující operaci PUT .

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

Vytvořit žádost

K vytvoření PUT požadavku je vyžadován {subscription-id} parametr. Pokud máte více předplatných, přečtěte si téma Práce s více předplatnými. Definujete {resourceGroupName} a {vaultName} pro své prostředky spolu s parametrem api-version . Tento článek používá api-version=2021-01-01.

Jsou vyžadovány následující hlavičky:

Hlavička požadavku Popis
Content-Type (Typ obsahu): Povinné. Nastavte na application/json.
Autorizace: Povinné. Nastavte na platný Bearer.

Další informace o tom, jak vytvořit požadavek, najdete v tématu Komponenty požadavku nebo odpovědi rozhraní REST API.

Vytvoření textu požadavku

K vytvoření textu požadavku se používají následující běžné definice:

Název Požadováno Typ Popis
eTag Řetězec Volitelná eTag
poloha pravda Řetězec Umístění prostředku
vlastnosti pravda BackupVault Vlastnosti trezoru
Identita DPPIdentityDetails Identifikuje jedinečný identifikátor systému pro každý prostředek Azure.
značky Objekt Štítky prostředků

Všimněte si, že název trezoru a název skupiny prostředků jsou uvedené v identifikátoru PUT URI. Text požadavku definuje umístění.

Příklad textu požadavku

Následující příklad obsahu slouží k vytvoření trezoru v regionu „West US“. Zadejte umístění.

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

Pokud chcete vytvořit trezor záloh a také vygenerovat identitu přiřazenou systémem, měli byste zadat následující text požadavku.

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

Odpovědi

Vytvoření trezoru záloh je asynchronní operace. To znamená, že tato operace vytvoří jinou operaci, která se musí sledovat samostatně. Existují dvě úspěšné odpovědi pro operaci vytvoření nebo aktualizace trezoru služby Backup:

Název Typ Popis
200 OK BackupVaultResource OK
201 Vytvořeno BackupVaultResource Vytvořeno
Další stavové kódy CloudError

Další informace o odpovědích rozhraní REST API naleznete v tématu Zpracování zprávy odpovědi.

Příklad odpovědi

Zhuštěná odpověď 201 Vytvořená z předchozího ukázkového textu požadavku ukazuje , že id bylo přiřazeno a stav zřizování je úspěšný:

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

Další kroky

Vytvořte zásadu pro zálohování blobů v tomto úložišti.

Další informace o rozhraních Azure REST API najdete v následujících dokumentech:

  • Last updated on