Backup Policies - Create Or Update

Ссылка

Служба:: Data Protection

Версия API:: 2025-01-01

Создает или обновляет политику резервного копирования, принадлежащую хранилищу резервных копий

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
backupPolicyName	path	True	string	Имя политики
resourceGroupName	path	True	string	Имя группы ресурсов. Имя не учитывает регистр.
subscriptionId	path	True	string uuid	Идентификатор целевой подписки. Значение должно быть UUID.
vaultName	path	True	string	Имя хранилища резервных копий.
api-version	query	True	string	Версия API, используемая для этой операции.

Текст запроса

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

Ответы

Имя	Тип	Описание
200 OK	BaseBackupPolicyResource	ХОРОШО
Other Status Codes	CloudError	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя.

Примеры

CreateOrUpdate BackupPolicy

Образец запроса

HTTP

PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PrivatePreviewVault/backupPolicies/OSSDBPolicy?api-version=2025-01-01

{
  "properties": {
    "policyRules": [
      {
        "backupParameters": {
          "backupType": "Full",
          "objectType": "AzureBackupParams"
        },
        "trigger": {
          "schedule": {
            "repeatingTimeIntervals": [
              "R/2019-11-20T08:00:00-08:00/P1W"
            ]
          },
          "taggingCriteria": [
            {
              "tagInfo": {
                "tagName": "Default"
              },
              "taggingPriority": 99,
              "isDefault": true
            },
            {
              "tagInfo": {
                "tagName": "Weekly"
              },
              "taggingPriority": 20,
              "isDefault": false,
              "criteria": [
                {
                  "scheduleTimes": [
                    "2019-03-01T13:00:00Z"
                  ],
                  "daysOfTheWeek": [
                    "Sunday"
                  ],
                  "objectType": "ScheduleBasedBackupCriteria"
                }
              ]
            }
          ],
          "objectType": "ScheduleBasedTriggerContext"
        },
        "dataStore": {
          "dataStoreType": "VaultStore",
          "objectType": "DataStoreInfoBase"
        },
        "name": "BackupWeekly",
        "objectType": "AzureBackupRule"
      },
      {
        "lifecycles": [
          {
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P1W"
            }
          }
        ],
        "isDefault": true,
        "name": "Default",
        "objectType": "AzureRetentionRule"
      },
      {
        "lifecycles": [
          {
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P12W"
            }
          }
        ],
        "isDefault": false,
        "name": "Weekly",
        "objectType": "AzureRetentionRule"
      }
    ],
    "datasourceTypes": [
      "OssDB"
    ],
    "objectType": "BackupPolicy"
  }
}

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

Код состояния:: 200

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PrivatePreviewVault/backupPolicies/OSSDBPolicy",
  "name": "OSSDBPolicy",
  "type": "Microsoft.DataProtection/backupVaults/backupPolicies",
  "properties": {
    "policyRules": [
      {
        "backupParameters": {
          "backupType": "Full",
          "objectType": "AzureBackupParams"
        },
        "trigger": {
          "schedule": {
            "repeatingTimeIntervals": [
              "R/2019-11-20T08:00:00-08:00/P1W"
            ]
          },
          "taggingCriteria": [
            {
              "tagInfo": {
                "tagName": "Default",
                "id": "Default_"
              },
              "taggingPriority": 99,
              "isDefault": true
            },
            {
              "tagInfo": {
                "tagName": "Weekly",
                "id": "Weekly_"
              },
              "taggingPriority": 20,
              "isDefault": false,
              "criteria": [
                {
                  "scheduleTimes": [
                    "2019-03-01T13:00:00Z"
                  ],
                  "daysOfTheWeek": [
                    "Sunday"
                  ],
                  "objectType": "ScheduleBasedBackupCriteria"
                }
              ]
            }
          ],
          "objectType": "ScheduleBasedTriggerContext"
        },
        "dataStore": {
          "dataStoreType": "VaultStore",
          "objectType": "DataStoreInfoBase"
        },
        "name": "BackupWeekly",
        "objectType": "AzureBackupRule"
      },
      {
        "lifecycles": [
          {
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P1W"
            }
          }
        ],
        "isDefault": true,
        "name": "Default",
        "objectType": "AzureRetentionRule"
      },
      {
        "lifecycles": [
          {
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P12W"
            }
          }
        ],
        "isDefault": false,
        "name": "Weekly",
        "objectType": "AzureRetentionRule"
      }
    ],
    "datasourceTypes": [
      "OssDB"
    ],
    "objectType": "BackupPolicy"
  }
}

Определения

Имя	Описание
AbsoluteDeleteOption	AbsoluteDeleteOption
AbsoluteMarker	он содержит абсолютные значения, такие как AllBackup / FirstOfDay/ FirstOfWeek / FirstOfMonth, и должен быть частью перечисления AbsoluteMarker
AdhocBasedTaggingCriteria	AdhocBasedTaggingCriteria
AdhocBasedTriggerContext	AdhocBasedTriggerContext
AzureBackupParams	AzureBackupParams
AzureBackupRule	AzureBackupRule
AzureRetentionRule	AzureRetentionRule
BackupPolicy	BackupPolicy
BackupSchedule	BackupSchedule
BaseBackupPolicyResource	BaseBackupPolicyResource
CloudError	CloudError
CopyOnExpiryOption	CopyOnExpiryOption
createdByType	Тип удостоверения, создавшего ресурс.
CustomCopyOption	CustomCopyOption
DataStoreInfoBase	DataStoreInfoBase
DataStoreTypes	тип хранилища данных; Operations/Vault/Archive
Day	День
DayOfWeek	Это должно быть воскресенье/понедельник/T..../суббота
Error	Ответ об ошибке управления ресурсами.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ImmediateCopyOption	ИнтерпретацияCopyOption
Month	Это должно быть январь/февраль/....../декабрь
RetentionTag	Метка хранения
ScheduleBasedBackupCriteria	ScheduleBasedBackupCriteria
ScheduleBasedTriggerContext	ScheduleBasedTriggerContext
SourceLifeCycle	SourceLifeCycle
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
TaggingCriteria	ТегCriteria
TargetCopySetting	TargetCopySetting
WeekNumber	Он должен быть первым, второй, третий, четвертый/ Последний

AbsoluteDeleteOption

Object

AbsoluteDeleteOption

Имя	Тип	Описание
duration	string	Длительность удаления после заданного интервала времени
objectType	string: AbsoluteDeleteOption	Тип конкретного объекта, используемого для десериализации

AbsoluteMarker

Enumeration

он содержит абсолютные значения, такие как AllBackup / FirstOfDay/ FirstOfWeek / FirstOfMonth, и должен быть частью перечисления AbsoluteMarker

Значение	Описание
AllBackup
FirstOfDay
FirstOfMonth
FirstOfWeek
FirstOfYear

AdhocBasedTaggingCriteria

Object

AdhocBasedTaggingCriteria

Имя	Тип	Описание
tagInfo	RetentionTag	Метка хранения Сведения о теге хранения

AdhocBasedTriggerContext

Object

AdhocBasedTriggerContext

Имя	Тип	Описание
objectType	string: AdhocBasedTriggerContext	Тип конкретного объекта, используемого для десериализации
taggingCriteria	AdhocBasedTaggingCriteria	AdhocBasedTaggingCriteria Критерии тегов, содержащие тег хранения для резервного копирования adhoc.

AzureBackupParams

Object

AzureBackupParams

Имя	Тип	Описание
backupType	string	BackupType; Full/Incremental etc
objectType	string: AzureBackupParams	Тип конкретного объекта, используемого для десериализации

AzureBackupRule

Object

AzureBackupRule

Имя	Тип	Описание
backupParameters	BackupParameters: AzureBackupParams	BackupParameters База BackupParameters
dataStore	DataStoreInfoBase	DataStoreInfoBase База DataStoreInfo
name	string
objectType	string: AzureBackupRule
trigger	TriggerContext: AdhocBasedTriggerContext ScheduleBasedTriggerContext	TriggerContext Контекст триггера

AzureRetentionRule

Object

AzureRetentionRule

Имя	Тип	Описание
isDefault	boolean
lifecycles	SourceLifeCycle[]	SourceLifeCycle Источник LifeCycle
name	string
objectType	string: AzureRetentionRule

BackupPolicy

Object

BackupPolicy

Имя	Тип	Описание
datasourceTypes	string[]	Тип источника данных для управления резервными копиями
objectType	string: BackupPolicy
policyRules	BasePolicyRule[]: AzureBackupRule[] AzureRetentionRule[]	Словарь правил политики, содержащий правила для каждого типа резервного копирования, например Full/Incremental/Logs и т. д.

BackupSchedule

Object

BackupSchedule

Имя	Тип	Описание
repeatingTimeIntervals	string[]	Формат интервала времени iso 8601
timeZone	string	Часовой пояс для расписания. Пример: тихоокеанское стандартное время

BaseBackupPolicyResource

Object

BaseBackupPolicyResource

Имя	Тип	Описание
id	string	Идентификатор ресурса представляет полный путь к ресурсу.
name	string	Имя ресурса, связанное с ресурсом.
properties	BaseBackupPolicy: BackupPolicy	BaseBackupPolicy Свойства BaseBackupPolicyResource
systemData	systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
type	string	Тип ресурса представляет полный путь к пространству имен формы/ResourceType/ResourceType/...

CloudError

Object

CloudError

Имя	Тип	Описание
error	Error	Ответ об ошибке управления ресурсами.

CopyOnExpiryOption

Object

CopyOnExpiryOption

Имя	Тип	Описание
objectType	string: CopyOnExpiryOption	Тип конкретного объекта, используемого для десериализации

createdByType

Enumeration

Тип удостоверения, создавшего ресурс.

Значение	Описание
Application
Key
ManagedIdentity
User

CustomCopyOption

Object

CustomCopyOption

Имя	Тип	Описание
duration	string	Данные, скопированные после заданного интервала времени
objectType	string: CustomCopyOption	Тип конкретного объекта, используемого для десериализации

DataStoreInfoBase

Object

DataStoreInfoBase

Имя	Тип	Описание
dataStoreType	DataStoreTypes	тип хранилища данных; Operations/Vault/Archive
objectType	string	Тип объекта Datasource, используемый для инициализации право наследуемого типа

DataStoreTypes

Enumeration

тип хранилища данных; Operations/Vault/Archive

Значение	Описание
ArchiveStore
OperationalStore
VaultStore

Day

Object

День

Имя	Тип	Описание
date	integer	Дата месяца
isLast	boolean	Указывает, является ли дата последней даты месяца

DayOfWeek

Enumeration

Это должно быть воскресенье/понедельник/T..../суббота

Значение	Описание
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

Error

Object

Ответ об ошибке управления ресурсами.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	Error[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ImmediateCopyOption

Object

ИнтерпретацияCopyOption

Имя	Тип	Описание
objectType	string: ImmediateCopyOption	Тип конкретного объекта, используемого для десериализации

Month

Enumeration

Это должно быть январь/февраль/....../декабрь

Значение	Описание
April
August
December
February
January
July
June
March
May
November
October
September

RetentionTag

Object

Метка хранения

Имя	Тип	Описание
eTag	string	Версия тега хранения.
id	string	Версия тега хранения.
tagName	string	Имя тега хранения, связанное с правилом хранения.

ScheduleBasedBackupCriteria

Object

ScheduleBasedBackupCriteria

Имя	Тип	Описание
absoluteCriteria	AbsoluteMarker[]	он содержит абсолютные значения, такие как AllBackup / FirstOfDay/ FirstOfWeek / FirstOfMonth, и должен быть частью перечисления AbsoluteMarker
daysOfMonth	Day[]	Это день месяца от 1 до 28 других мудрых последних месяцев
daysOfTheWeek	DayOfWeek[]	Это должно быть воскресенье/понедельник/T..../суббота
monthsOfYear	Month[]	Это должно быть январь/февраль/....../декабрь
objectType	string: ScheduleBasedBackupCriteria	Тип конкретного объекта, используемого для десериализации
scheduleTimes	string[]	Список времени расписания резервного копирования
weeksOfTheMonth	WeekNumber[]	Он должен быть первым, второй, третий, четвертый/ Последний

ScheduleBasedTriggerContext

Object

ScheduleBasedTriggerContext

Имя	Тип	Описание
objectType	string: ScheduleBasedTriggerContext	Тип конкретного объекта, используемого для десериализации
schedule	BackupSchedule	BackupSchedule Планирование резервного копирования
taggingCriteria	TaggingCriteria[]	Список тегов, которые могут применяться для заданного расписания.

SourceLifeCycle

Object

SourceLifeCycle

Имя	Тип	Описание
deleteAfter	DeleteOption: AbsoluteDeleteOption	DeleteOption Параметр удаления
sourceDataStore	DataStoreInfoBase	DataStoreInfoBase База DataStoreInfo
targetDataStoreCopySettings	TargetCopySetting[]	TargetCopySetting Параметры целевого копирования

systemData

Object

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

TaggingCriteria

Object

ТегCriteria

Имя	Тип	Описание
criteria	BackupCriteria[]: ScheduleBasedBackupCriteria[]	Критерии, определяющие, можно ли применять тег к активированной резервной копии.
isDefault	boolean	Указывает, является ли тег по умолчанию.
tagInfo	RetentionTag	Метка хранения Сведения о теге хранения
taggingPriority	integer	Приоритет тега хранения.

TargetCopySetting

Object

TargetCopySetting

Имя	Тип	Описание
copyAfter	CopyOption: CopyOnExpiryOption CustomCopyOption ImmediateCopyOption	CopyOption Это может быть CustomCopyOption или ИнтерпретацияCopyOption.
dataStore	DataStoreInfoBase	DataStoreInfoBase Сведения о целевом хранилище данных

WeekNumber

Enumeration

Он должен быть первым, второй, третий, четвертый/ Последний

Значение	Описание
First
Fourth
Last
Second
Third

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

Backup Policies - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

CreateOrUpdate BackupPolicy

Образец запроса

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

Определения

AbsoluteDeleteOption

AbsoluteMarker

AdhocBasedTaggingCriteria

AdhocBasedTriggerContext

AzureBackupParams

AzureBackupRule

AzureRetentionRule

BackupPolicy

BackupSchedule

BaseBackupPolicyResource

CloudError

CopyOnExpiryOption

createdByType

CustomCopyOption

DataStoreInfoBase

DataStoreTypes

Day

DayOfWeek

Error

ErrorAdditionalInfo

ImmediateCopyOption

Month

RetentionTag

ScheduleBasedBackupCriteria

ScheduleBasedTriggerContext

SourceLifeCycle

systemData

TaggingCriteria

TargetCopySetting

WeekNumber

Дополнительные ресурсы