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

Статья
10/20/2024

В этой статье описывается, как обновить конфигурации, связанные с резервным копированием, в хранилище служб восстановления 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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Отклики

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

Имя.	Тип	Описание
200 OK	BackupResourceVaultConfig	ОК

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

После отправки запроса 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

PUT URI имеет параметры {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

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

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

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

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

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

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

Имя.	Тип	Описание
200 OK	BackupResourceVaultConfig	ОК

Пример ответа на операцию 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"
  }
}

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

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

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

Recovery Services (Службы восстановления)
Начало работы с Azure REST API

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