你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Backup Policies - Create Or Update

服务:: Data Protection

API 版本:: 2025-09-01

创建或更新属于备份保管库的备份策略

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

URI 参数

名称	在	必需	类型	说明
backupPolicyName	path	True	string
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。此名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。该值必须是 UUID。
vaultName	path	True	string	备份保管库的名称。
api-version	query	True	string minLength: 1	要用于此操作的 API 版本。

请求正文

名称	类型	说明
properties	BaseBackupPolicy: BackupPolicy	BaseBackupPolicyResource 属性

响应

名称	类型	说明
200 OK	BaseBackupPolicyResource	资源“BaseBackupPolicyResource”更新作成功
Other Status Codes	CloudError	意外的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: 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-09-01

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

示例响应

状态代码:: 200

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

定义

名称	说明
AbsoluteDeleteOption	持续时间为“删除”选项
AbsoluteMarker
AdhocBasedTaggingCriteria	临时备份标记条件
AdhocBasedTriggerContext	Adhoc 触发器上下文
AzureBackupParams	Azure 备份参数
AzureBackupRule	Azure 备份规则
AzureRetentionRule	Azure 保留规则
BackupPolicy	基于规则的备份策略
BackupSchedule	备份计划
BaseBackupPolicyResource	BaseBackupPolicy 资源
CloudError	Azure 备份的错误响应。
CopyOnExpiryOption	“过期时复制”选项
createdByType	创建资源的标识的类型。
CustomCopyOption	要复制的基于持续时间的自定义选项
DataStoreInfoBase	DataStoreInfo 基础
DataStoreTypes	数据存储的类型;作/保管库/存档
Day	星期几
DayOfWeek
Error	资源管理错误响应。
ErrorAdditionalInfo	资源管理错误附加信息。
ImmediateCopyOption	即时复制选项
Month
RetentionTag	保留标记
ScheduleBasedBackupCriteria	基于计划的备份条件
ScheduleBasedTriggerContext	基于计划的触发器上下文
SourceLifeCycle	源 LifeCycle
systemData	与创建和上次修改资源相关的元数据。
TaggingCriteria	标记条件
TargetCopySetting	目标复制设置
WeekNumber

AbsoluteDeleteOption

Object

持续时间为“删除”选项

名称	类型	说明
duration	string	给定时间跨度后删除的持续时间
objectType	string: AbsoluteDeleteOption	特定对象的类型 - 用于反序列化

AbsoluteMarker

枚举

值	说明
AllBackup
FirstOfDay
FirstOfMonth
FirstOfWeek
FirstOfYear

AdhocBasedTaggingCriteria

Object

临时备份标记条件

名称	类型	说明
tagInfo	RetentionTag	保留标记信息

AdhocBasedTriggerContext

Object

Adhoc 触发器上下文

名称	类型	说明
objectType	string: AdhocBasedTriggerContext	特定对象的类型 - 用于反序列化
taggingCriteria	AdhocBasedTaggingCriteria	标记条件，其中包含临时备份的保留标记。

AzureBackupParams

Object

Azure 备份参数

名称	类型	说明
backupType	string	BackupType ;完整/增量等
objectType	string: AzureBackupParams	特定对象的类型 - 用于反序列化

AzureBackupRule

Object

Azure 备份规则

名称	类型	说明
backupParameters	BackupParameters: AzureBackupParams	BackupParameters 基础
dataStore	DataStoreInfoBase	DataStoreInfo 基础
name	string
objectType	string: AzureBackupRule
trigger	TriggerContext: AdhocBasedTriggerContext ScheduleBasedTriggerContext	触发器上下文

AzureRetentionRule

Object

Azure 保留规则

名称	类型	说明
isDefault	boolean
lifecycles	SourceLifeCycle[]	源 LifeCycle
name	string
objectType	string: AzureRetentionRule

BackupPolicy

Object

基于规则的备份策略

名称	类型	说明
datasourceTypes	string[]	备份管理的数据源类型
objectType	string: BackupPolicy
policyRules	BasePolicyRule[]: AzureBackupRule[] AzureRetentionRule[]	策略规则字典，其中包含每个备份类型的规则，即完整/增量/日志等

BackupSchedule

Object

备份计划

名称	类型	说明
repeatingTimeIntervals	string[]	重复时间间隔，仅支持以下 ISO 8601 格式 [R/startDateTime/Duration]。示例：R/2007-03-01T13：00：00Z/P1Y2M10DT2H30M
timeZone	string	计划的时区。示例：太平洋标准时间

BaseBackupPolicyResource

Object

BaseBackupPolicy 资源

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 ID。例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	资源的名称
properties	BaseBackupPolicy: BackupPolicy	BaseBackupPolicyResource 属性
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。例如，“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

CloudError

Object

Azure 备份的错误响应。

名称	类型	说明
error	Error	资源管理错误响应。

CopyOnExpiryOption

Object

“过期时复制”选项

名称	类型	说明
objectType	string: CopyOnExpiryOption	特定对象的类型 - 用于反序列化

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

CustomCopyOption

Object

要复制的基于持续时间的自定义选项

名称	类型	说明
duration	string	给定时间跨度后复制的数据
objectType	string: CustomCopyOption	特定对象的类型 - 用于反序列化

DataStoreInfoBase

Object

DataStoreInfo 基础

名称	类型	说明
dataStoreType	DataStoreTypes	数据存储的类型;作/保管库/存档
objectType	string	Datasource 对象的类型，用于初始化正确的继承类型

DataStoreTypes

枚举

数据存储的类型;作/保管库/存档

值	说明
OperationalStore
VaultStore
ArchiveStore

Day

Object

星期几

名称	类型	说明
date	integer (int32)	月份的日期
isLast	boolean	日期是否为月份的最后一个日期

DayOfWeek

枚举

值	说明
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

即时复制选项

名称	类型	说明
objectType	string: ImmediateCopyOption	特定对象的类型 - 用于反序列化

Month

枚举

值	说明
April
August
December
February
January
July
June
March
May
November
October
September

RetentionTag

Object

保留标记

名称	类型	说明
eTag	string	保留标记版本。
id	string	保留标记版本。
tagName	string	保留标记名称将其与保留规则相关联。

ScheduleBasedBackupCriteria

Object

基于计划的备份条件

名称	类型	说明
absoluteCriteria	AbsoluteMarker[]	它包含绝对值，如“AllBackup”/“FirstOfDay”/“FirstOfWeek”/“FirstOfMonth”，应是 AbsoluteMarker 枚举的一部分
daysOfMonth	Day[]	这是一个月中的一天，从 1 到 28，否则为上个月
daysOfTheWeek	DayOfWeek[]	它应该是星期日/星期一/T..../星期六
monthsOfYear	Month[]	它应为 1 月/2 月/....../12 月
objectType	string: ScheduleBasedBackupCriteria	特定对象的类型 - 用于反序列化
scheduleTimes	string[] (date-time)	备份计划时间列表
weeksOfTheMonth	WeekNumber[]	它应为 First/Second/Third/Fourth/Last

ScheduleBasedTriggerContext

Object

基于计划的触发器上下文

名称	类型	说明
objectType	string: ScheduleBasedTriggerContext	特定对象的类型 - 用于反序列化
schedule	BackupSchedule	计划此备份
taggingCriteria	TaggingCriteria[]	可用于给定计划的标记列表。

SourceLifeCycle

Object

源 LifeCycle

名称	类型	说明
deleteAfter	DeleteOption: AbsoluteDeleteOption	删除选项
sourceDataStore	DataStoreInfoBase	DataStoreInfo 基础
targetDataStoreCopySettings	TargetCopySetting[]	目标复制设置

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

TaggingCriteria

Object

标记条件

名称	类型	说明
criteria	BackupCriteria[]: ScheduleBasedBackupCriteria[]	决定是否可以将标记应用于触发的备份的条件。
isDefault	boolean	指定标记是否为默认值。
tagInfo	RetentionTag	保留标记信息
taggingPriority	integer (int64)	保留标记优先级。

TargetCopySetting

Object

目标复制设置

名称	类型	说明
copyAfter	CopyOption: CopyOnExpiryOption CustomCopyOption ImmediateCopyOption	可以是 CustomCopyOption 或 ImmediateCopyOption。
dataStore	DataStoreInfoBase	目标数据存储的信息

WeekNumber

枚举

值	说明
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