Создание политик резервного копирования Azure Data Protection для дисков с помощью REST API

Политика резервного копирования управляет хранением резервных копий и расписанием резервного копирования. Резервное копирование дисков Azure предлагает создавать резервные копии несколько раз в день.

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

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

Создание политики

Важно!

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

Для создания политики Azure Backup используйте следующую операцию PUT:

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{policyName}?api-version=2021-01-01

{policyName} и {vaultName} предоставляются в URI. Дополнительные сведения предоставляются в тексте запроса.

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

Например, чтобы создать политику резервного копирования Диска, в тексте запроса должны быть следующие компоненты:

Имя Обязательно Тип Описание
properties True BaseBackupPolicy:BackupPolicy Свойства BaseBackupPolicyResource

Полный список определений в тексте запроса см. в документе REST API о политике резервного копирования.

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

Политика включает:

  • Триггер по расписанию через каждые 4 часа (PT4H). Резервные копии будут создаваться с промежутками приблизительно в 4 часа, так что моменты резервного копирования будут равномерно распределены по временам суток.
  • Вы можете выбрать интервал триггера 4, 6, 8 или 12 часов. Чтобы выполнять резервное копирование один раз в день, укажите P1D. Резервное копирование запускается один раз в день в назначенное время.
  • Хранилище данных представляет собой операционное хранилище, так как резервные копии являются локальными и не передаются в хранилище Azure Backup. В операционном хранилище каждый экземпляр резервной копии хранится в течение семи дней (P7D).
{
"properties": {
    "datasourceTypes": [
        "Microsoft.Compute/disks"
      ],
      "name": "DiskPolicy",
      "objectType": "BackupPolicy",
      "policyRules": [
        {
          "backupParameters": {
            "backupType": "Incremental",
            "objectType": "AzureBackupParams"
          },
          "dataStore": {
            "dataStoreType": "OperationalStore",
            "objectType": "DataStoreInfoBase"
          },
          "name": "BackupHourly",
          "objectType": "AzureBackupRule",
          "trigger": {
            "objectType": "ScheduleBasedTriggerContext",
            "schedule": {
              "repeatingTimeIntervals": [
                "R/2020-04-05T13:00:00+00:00/PT4H"
              ]
            },
            "taggingCriteria": [
              {
                "isDefault": true,
                "tagInfo": {
                  "id": "Default_",
                  "tagName": "Default"
                },
                "taggingPriority": 99
              }
            ]
          }
        },
        {
          "isDefault": true,
          "lifecycles": [
            {
              "deleteAfter": {
                "duration": "P7D",
                "objectType": "AbsoluteDeleteOption"
              },
              "sourceDataStore": {
                "dataStoreType": "OperationalStore",
                "objectType": "DataStoreInfoBase"
              }
            }
          ],
          "name": "Default",
          "objectType": "AzureRetentionRule"
        }
      ]
    }
}

Важно!

Поддерживается только формат времени DateTime. Нельзя указать только Time. Указываемое время суток обозначает время запуска резервного копирования, а не время, когда создание резервной копии будет завершено.

Время, требуемое для завершения операции резервного копирования, зависит от различных факторов, включая размер диска и частоту обновлений между последовательными резервными копиями. Но резервное копирование дисков Azure выполняется без агента и использует добавочные моментальные снимки, которые не влияют на производительность приложения в рабочей среде.

Дополнительные сведения о создании политик см. в документе Политика резервного копирования дисков Azure.

Ответы

Создание или обновление политики резервного копирования является синхронной операцией, которая возвращает значение "ОК" после успешного выполнения операции.

Имя Тип Описание
200 ОК BaseBackupPolicyResource ОК

Примеры ответов

После завершения операции он возвращает код 200 (ОК) с содержимым политики в тексте ответа.

{
    "id": "/subscriptions/73307177-bb00-4801-bd11-894b2f2d5162/resourceGroups/RG-BV/providers/Microsoft.DataProtection/backupVaults/BV-JPE-GRS/backupPolicies/DiskBackupPolicy-03",
    "name": "DiskBackupPolicy-03",
    "type": "Microsoft.DataProtection/backupVaults/backupPolicies",
    "properties": {
        "policyRules": [
            {
                "backupParameters": {
                    "backupType": "Incremental",
                    "objectType": "AzureBackupParams"
                },
                "trigger": {
                    "schedule": {
                        "repeatingTimeIntervals": [
                            "R/2021-07-01T19:00:00+00:00/P1D"
                        ],
                      },
                    "taggingCriteria": [
                        {
                            "tagInfo": {
                                "tagName": "Default",
                                "id": "Default_"
                            },
                            "taggingPriority": 99,
                            "isDefault": true
                        }
                    ],
                    "objectType": "ScheduleBasedTriggerContext"
                },
                "dataStore": {
                    "dataStoreType": "OperationalStore",
                    "objectType": "DataStoreInfoBase"
                },
                "name": "BackupDaily",
                "objectType": "AzureBackupRule"
            },
            {
                "lifecycles": [
                    {
                        "deleteAfter": {
                            "objectType": "AbsoluteDeleteOption",
                            "duration": "P7D"
                        },
                        "targetDataStoreCopySettings": [],
                        "sourceDataStore": {
                            "dataStoreType": "OperationalStore",
                            "objectType": "DataStoreInfoBase"
                        }
                    }
                ],
                "isDefault": true,
                "name": "Default",
                "objectType": "AzureRetentionRule"
            }
        ],
        "datasourceTypes": [
            "Microsoft.Compute/disks"
        ],
        "objectType": "BackupPolicy"
    }
}

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

Включение защиты дисков Azure

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