Обновление конфигураций хранилища служб восстановления Azure с помощью REST API

  • Статья

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

Состояние мягкого удаления

Удаление резервных копий защищенного элемента — важная операция, которую необходимо контролировать. Для защиты от случайного удаления в хранилище служб восстановления Azure предусмотрена возможность обратимого удаления. Эта возможность позволяет при необходимости восстанавливать удаленные резервные копии в течение периода времени после удаления.

Но есть сценарии, в которых эта возможность не требуется. Хранилище служб восстановления Azure не может быть удалено, если в нем есть элементы резервных копий, даже восстановленные. Это может создать проблему, если хранилище необходимо немедленно удалить. Например, операции развертывания часто очищают созданные ресурсы в одном рабочем процессе. Развертывание может создать хранилище, настроить резервное копирование для элемента, выполнить тестовое восстановление, а затем перейти к удалению элементов резервного копирования и хранилища. Если удалить хранилище не удастся, может произойти сбой всего развертывания. Отключение мягкого удаления — единственный способ гарантировать немедленное удаление.

Поэтому вам нужно тщательно выбирать, следует ли отключать мягкое удаление для конкретного хранилища в зависимости от сценария. Для получения дополнительной информации см. Статью об обратимом удалении.

Получение состояния обратимого удаления с помощью REST API

По умолчанию состояние обратимого удаления будет включено для любого вновь созданного хранилища служб восстановления. Чтобы получить или обновить состояние обратимого удаления для хранилища, используйте документ REST API, связанный с конфигурацией резервного хранилища

Чтобы получить текущее состояние мягкого удаления для хранилища, используйте следующую операцию GET

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

GET URI имеет параметры {subscriptionId}, {vaultName}, {vaultresourceGroupName}. В этом примере {vaultName} — это testVault, а {vaultresourceGroupName} — testVaultRG. Так как все необходимые параметры указаны в универсальном коде ресурса (URI), нет необходимости в отдельном тексте запроса.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Отклики

Успешный ответ на операцию "GET" показан ниже:

Имя. Тип Описание
200 OK BackupResourceVaultConfig ОК
Пример отклика

После отправки запроса GET возвращается ответ 200 (успешный).

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

Обновить состояние мягкого удаления с помощью REST API

Чтобы обновить состояние мягкого удаления хранилища служб восстановления с помощью REST API, используйте следующую операцию PUT

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

PUT URI имеет параметры {subscriptionId}, {vaultName}, {vaultresourceGroupName}. В этом примере {vaultName} — это testVault, а {vaultresourceGroupName} — testVaultRG. Если мы заменим URI значениями выше, то URI будет выглядеть так.

PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

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

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

Дополнительные сведения см. в документации по REST API

имени Обязательно Тип Описание
eTag Строка Необязательный eTag
Расположение true Строка Расположение ресурса
свойства VaultProperties Свойства хранилища
tags Объект Теги ресурсов

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

Следующий пример используется для обновления состояния мягкого удаления до "отключено".

{
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Ответы на операцию PATCH

Успешный ответ на операцию PATCH показан ниже:

Имя. Тип Описание
200 OK BackupResourceVaultConfig ОК
Пример ответа на операцию PATCH

После отправки запроса PATCH возвращается ответ 200 (успешный).

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Следующие шаги

Create Azure Recovery Services backup policies using REST API (Создание политик резервного копирования Служб восстановления Azure с помощью REST API)

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