Vytvoření trezoru Azure Backup pomocí rozhraní REST API

Článek
06/01/2023

Nová platforma ochrany dat Azure Backup 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. Jeho cílem je minimalizovat režijní náklady na správu a zároveň ho usnadňuje uspořádání záloh. Trezor služby Backup je základním kamenem platformy ochrany dat a liší se od trezoru služby Recovery Services.

Postup vytvoření trezoru Azure Backup pomocí rozhraní REST API najdete v dokumentaci k rozhraní REST API pro vytvoření trezoru. Použijeme tento dokument jako referenci k vytvoření trezoru s názvem "testBkpVault" v oblasti Západní USA a ve skupině prostředků TestBkpVaultRG.

K vytvoření nebo aktualizaci trezoru 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ření požadavku

K vytvoření požadavku {subscription-id}PUT se vyžaduje parametr . Pokud máte více předplatných, přečtěte si téma Práce s více předplatnými. Pro prostředky definujete {resourceGroupName} a {vaultName} 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:	Povinná hodnota. Nastavte na `application/json`.
Authorization:	Povinná hodnota. Nastavte na platný `Bearer`přístupový token.

Další informace o tom, jak vytvořit požadavek, najdete v tématu Komponenty požadavku a 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:

Name	Požaduje se	Typ	Popis
Etag		Řetězec	Volitelná značka eTag
location	true	Řetězec	Umístění prostředku
properties	true	BackupVault	Vlastnosti trezoru
Identita		DPPIdentityDetails	Identifikuje jedinečný identifikátor systému pro každý prostředek Azure.
tags		Objekt	Značky prostředků

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

Příklad textu požadavku

Následující příklad textu se používá k vytvoření trezoru v oblasti USA – západ. 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 dostat 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ří další operaci, kterou je potřeba sledovat samostatně. Operace vytvoření nebo aktualizace trezoru služby Backup má dvě úspěšné odpovědi:

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

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

Příklad odpovědi

Zhuštěná 201 Vytvořená odpověď z předchozího příkladu textu požadavku ukazuje , že id bylo přiřazeno a provisioningState je 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"
  }

Další kroky

Vytvořte zásadu zálohování pro zálohování objektů blob v tomto trezoru.

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