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

Статья
07/18/2024

Новая платформа защиты данных 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.

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

Заголовок запроса	Description
Content-Type (Тип контента).	Обязательный. Задайте значение `application/json`.
Авторизация.	Обязательный. Задайте допустимый маркер доступа `Bearer`.

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

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

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

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

Обратите внимание, что имена хранилища и группы ресурсов указаны в универсальном коде ресурса (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 OK	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 см. в следующих документах:

Поделиться через