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

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

В этой статье описывается создание хранилища резервных копий с помощью REST API. Вы также можете создать хранилище резервных копий с помощью портала Azure.

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

Инструкции по созданию хранилища Azure Backup с помощью REST API описаны в документации Создание хранилища с помощью REST API. Давайте использовать этот документ в качестве ссылки для создания хранилища, названного testBkpVault, в West US и в группе ресурсов 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.
Авторизация. Обязательный. Задайте допустимый Bearerмаркер доступа.

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

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

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

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

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

  • Last updated on