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

Článek
07/18/2024

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žijeme jako referenci k vytvoření trezoru s názvem testBkpVault v oblasti USA – západ a ve skupině 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í 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. 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ý přístupový token `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	Type	Popis
eTag		String	Volitelná eTag
location	true	String	Umístění prostředku
vlastnosti	true	BackupVault	Vlastnosti trezoru
Identita		DPPIdentityDetails	Identifikuje jedinečný identifikátor systému pro každý prostředek Azure.
značky		Objekt	Značky 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 textu slouží 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 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ě. Operace vytvoří nebo aktualizuje trezor služby Backup dvěma úspěšnými odpověďmi:

Name	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 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:

Sdílet prostřednictvím