Udostępnij za pomocą

Tworzenie magazynu usługi Azure Backup przy użyciu interfejsu API REST

W tym artykule opisano sposób tworzenia magazynu kopii zapasowych przy użyciu interfejsu API REST. Można również utworzyć magazyn usługi Backup przy użyciu portalu Azure.

Nowa platforma ochrony danych usługi Azure Backup oferuje rozszerzone możliwości tworzenia kopii zapasowych i przywracania dla nowszych obciążeń, takich jak obiekty blob na kontach magazynu, dyski zarządzane i platforma PaaS dla serwera PostgreSQL. Ma na celu zminimalizowanie nakładu pracy związanego z zarządzaniem, co ułatwia organizowanie kopii zapasowych. "Magazyn kopii zapasowych" jest podstawą platformy ochrony danych i różni się to od magazynu "Recovery Services".

Kroki tworzenia sejfu usługi Azure Backup przy użyciu API REST zostały opisane w dokumentacji tworzenia sejfu API REST. Użyjemy tego dokumentu jako odniesienia, aby utworzyć skarbiec o nazwie testBkpVault w West US oraz w grupie zasobów TestBkpVaultRG.

Aby utworzyć lub zaktualizować magazyn usługi Azure Backup, użyj następującej operacji PUT .

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

Utwórz żądanie

Aby utworzyć żądanie PUT, wymagany jest ten {subscription-id} parametr. Jeśli masz wiele subskrypcji, zobacz Praca z wieloma subskrypcjami. Definiujesz {resourceGroupName} i {vaultName} dla swoich zasobów, wraz z parametrem api-version. W tym artykule użyto api-version=2021-01-01.

Wymagane są następujące nagłówki:

Nagłówek żądania opis
Typ zawartości: Wymagany. Ustaw wartość application/json.
Autoryzacja: Wymagany. Ustaw na prawidłowy Bearertoken dostępu.

Aby uzyskać więcej informacji na temat tworzenia żądania, zobacz Składniki żądania/odpowiedzi interfejsu API REST.

Tworzenie treści żądania

Następujące typowe definicje służą do tworzenia treści żądania:

Nazwisko Wymagane Typ opis
Znacznik elektroniczny (eTag) Sznurek Opcjonalny element eTag
lokalizacja prawda Sznurek Lokalizacja zasobu
właściwości prawda BackupVault Właściwości skarbca
Tożsamość DPPIdentityDetails Identyfikuje unikatowy identyfikator systemu dla każdego zasobu platformy Azure
etykiety Objekt Tagi zasobów

Pamiętaj, że nazwa magazynu i nazwa grupy zasobów są podane w URI żądania PUT. Treść żądania definiuje lokalizację.

Przykładowa treść żądania

Poniższa przykładowa treść służy do tworzenia skarbca w regionie "Zachodnie USA". Określ lokalizację.

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

Jeśli chcesz utworzyć magazyn kopii zapasowych, a także wygenerować tożsamość przypisaną przez system, należy podać następującą treść żądania.

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

Odpowiedzi

Tworzenie magazynu kopii zapasowych jest operacją asynchroniczną. Oznacza to, że ta operacja tworzy inną operację, która musi być śledzona oddzielnie. Istnieją dwie pomyślne odpowiedzi dla operacji tworzenia lub aktualizowania magazynu kopii zapasowych:

Nazwisko Typ opis
200 OK BackupVaultResource OK
201 Utworzono BackupVaultResource Utworzone
Inne kody stanu CloudError

Aby uzyskać więcej informacji na temat odpowiedzi interfejsu API REST, zobacz Przetwarzanie komunikatu odpowiedzi.

Przykładowa odpowiedź

Skrócona 201 Utworzona odpowiedź z poprzedniej przykładowej treści żądania pokazuje , że przypisano identyfikator , a stan provisioningState to Powodzenie:

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

Następne kroki

Utwórz zasady tworzenia kopii zapasowych na potrzeby tworzenia kopii zapasowych obiektów blob w tym magazynie.

Aby uzyskać więcej informacji na temat interfejsów API REST platformy Azure, zobacz następujące dokumenty:

  • Last updated on