Обновление конфигураций хранилища служб восстановления 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

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

GET https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Ответы

Ниже показан успешный ответ для операции GET:

Пример отклика

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

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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

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

PUT https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

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

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

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

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

Используйте следующий пример, чтобы изменить состояние мягкого удаления на «отключено».

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

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

Ниже показан успешный ответ для операции PATCH:

Пример ответа для операции PATCH

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

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

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

Создайте политику резервного копирования для резервирования виртуальной машины Azure в этом хранилище.

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

• Провайдер REST API для служб восстановления Azure
• Начало работы с Azure REST API