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

В этой статье описывается создание политик резервного копирования Azure Data Protection для блобов Azure с использованием REST API.

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

Внимание

Прежде чем приступить к созданию политики и настройке резервных копий для объектов BLOB Azure, см. этот раздел.

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

Примечание.

Восстановление в течение длительных периодов может привести к тому, что операции восстановления занимают больше времени. Кроме того, время, необходимое для восстановления набора данных, основано на количестве операций записи и удаления, выполненных в течение периода восстановления. Например, для учетной записи с 1 миллионом объектов, 3000 объектов, добавляемых в день и 1000 объектов, удаляемых в день, потребуется примерно два часа для восстановления до состояния на 30 дней назад. Срок хранения и восстановление более 90 дней в прошлом не рекомендуется для учетной записи с этой скоростью изменений.

В этой статье описано следующее:

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

Создание политики для резервного копирования BLOB-объектов Azure

Для создания политики 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). Дополнительные сведения можно найти в тексте запроса.

Внимание

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

Создать тело запроса для политики резервного копирования BLOB-объектов Azure

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

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

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

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

Следующий текст запроса определяет политику резервного копирования BLOB-объектов.

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

  • Срок хранения составляет 30 дней.
  • Хранилище данных — это "рабочее хранилище".
{
  "properties": {
    "datasourceTypes": [
      "Microsoft.Storage/storageAccounts/blobServices"
    ],
    "objectType": "BackupPolicy",
    "policyRules": [
      {
        "name": "Default",
        "objectType": "AzureRetentionRule",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P30D",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "OperationalStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ]
      }
    ]
  }
}

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

{
  "id": "/subscriptions/495944b2-66b7-4173-8824-77043bb269be/resourceGroups/Blob-Backup/providers/Microsoft.DataProtection/BackupVaults/yavovaultecy01/backupPolicies/TestPolicy",
  "name": "TestPolicy",
  "type": "Microsoft.DataProtection/BackupVaults/backupPolicies",
  "properties": {
    "policyRules": [
      {
        "name": "Default",
        "objectType": "AzureRetentionRule",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P30D",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "OperationalStore",
              "objectType": "DataStoreInfoBase"
            },
            "targetDataStoreCopySettings": []
          }
        ]
      },
      {
        "name": "Default",
        "objectType": "AzureRetentionRule",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P7D",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "targetDataStoreCopySettings": []
          }
        ]
      },
      {
        "name": "BackupDaily",
        "objectType": "AzureBackupRule",
        "backupParameters": {
          "backupType": "Discrete",
          "objectType": "AzureBackupParams"
        },
        "dataStore": {
          "dataStoreType": "VaultStore",
          "objectType": "DataStoreInfoBase"
        },
        "trigger": {
          "schedule": {
            "timeZone": "UTC",
            "repeatingTimeIntervals": [
              "R/2024-05-08T14:00:00+00:00/P1D"
            ]
          },
          "taggingCriteria": [
            {
              "isDefault": true,
              "taggingPriority": 99,
              "tagInfo": {
                "id": "Default_",
                "tagName": "Default"
              }
            }
          ],
          "objectType": "ScheduleBasedTriggerContext"
        }
      }
    ],
    "datasourceTypes": [
      "Microsoft.Storage/storageAccounts/blobServices"
    ],
    "objectType": "BackupPolicy",
    "name": "TestPolicy"
  }
} 

Внимание

Поддерживаемые форматы времени — только DateTime . Они не поддерживают формат времени отдельно.

Ответы на создание или обновление политики резервного копирования BLOB Azure

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

Имя Тип Описание
200 OK (Запрос выполнен успешно) BaseBackupPolicyResource ОК

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

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

{
  "id": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups//TestBkpVaultRG/providers/Microsoft.RecoveryServices/vaults/testBkpVault/backupPolicies/TestBlobPolicy",
  "name": "TestBlobPolicy",
  "type": "Microsoft.DataProtection/backupVaults/backupPolicies",
  "properties": {
    "policyRules": [
      {
        "lifecycles": [
          {
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P30D"
            },
            "sourceDataStore": {
              "dataStoreType": "OperationalStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ],
        "isDefault": true,
        "name": "Default",
        "objectType": "AzureRetentionRule"
      }
    ],
    "datasourceTypes": [
      "Microsoft.Storage/storageAccounts/blobServices"
    ],
    "objectType": "BackupPolicy"
  }
}

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

Включите защиту BLOB-объектов в учетной записи хранилища.

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