Создание хранилища Azure Backup с помощью REST API

Статья
06/01/2023

Новая платформа защиты данных Azure Backup предоставляет расширенные возможности для резервного копирования и восстановления для более новых рабочих нагрузок, таких как большие двоичные объекты в учетных записях хранения, управляемый диск и платформа PaaS сервера PostgreSQL. Она нацелена на сокращение расходов на управление и упрощает упорядочивание резервных копий. Резервное хранилище является основой платформы защиты данных и отличается от хранилища Служб восстановления.

Инструкции по созданию хранилища Azure Backup с помощью REST API описаны в документации Создание хранилища с помощью REST API. В этом документе содержатся справочные сведения по созданию хранилища с именем testVault в регионе "Западная часть США" в группе ресурсов TestBkpVaultRG.

Для создания или обновления хранилища Azure Backup используйте следующую операцию PUT.

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

Создание запроса

Для создания запроса PUT требуется параметр {subscription-id}. Если у вас несколько подписок, см. раздел Использование нескольких подписок. Для ваших ресурсов параметры {resourceGroupName} и {vaultName} определяются вместе с параметром api-version. Для этой статьи используется api-version=2021-01-01.

Ниже приведены обязательные заголовки.

Заголовок запроса	Описание
Content-Type:	Обязательный элемент. Задайте значение `application/json`.
Authorization:	Обязательный элемент. Задайте в качестве значения допустимый токен доступа`Bearer`.

Дополнительные сведения по созданию запросов см. в разделе Components of a REST API request/response (Компоненты запроса или ответа REST API).

Создание текста запроса

Для создания текста запроса используются следующие общие определения.

Имя	Обязательно	Тип	Описание
eTag		Строка	Необязательный eTag
location	Да	Строка	Расположение ресурса
properties	true	BackupVault	Свойства хранилища
Идентификация		DPPIdentityDetails	В этом столбце указан уникальный системный идентификатор для каждого ресурса Azure.
tags		Объект	Теги ресурсов

Обратите внимание, что имена хранилища и группы ресурсов указаны в универсальном коде ресурса (URI) PUT. Текст запроса определяет расположение.

Примеры текста запроса

Следующий пример текста используется для создания хранилища в регионе "Западная часть США". Укажите расположение.

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

Если вы хотите создать резервное хранилище и удостоверение, назначаемое системой, необходимо указать следующий текст запроса.

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

Ответы

Создание резервного хранилища — это асинхронная операция. Это означает, что такая операция создает другую операцию, которая должна отслеживаться отдельно. Существует два успешных ответа для операции по созданию или обновлению резервного хранилища:

Имя	Тип	Описание
200 ОК	BackupVaultResource	ОК
201 Создано	BackupVaultResource	Создание
Другие коды состояния	CloudError

Дополнительные сведения об ответах REST API можно узнать в разделе Process the response message (Обработка ответного сообщения).

Пример ответа

Сокращенный ответ 201 Created (201 Создано), полученный из предыдущего примера текста запроса, показывает, что был назначен идентификатор и что для состояния provisioningState указано значение 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"
  }

Дальнейшие действия

Создание политик резервного копирования для резервного копирования BLOB-объектов в это хранилище.

Дополнительные сведения о REST API Azure см. в следующих документах: