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

az dataprotection backup-policy retention-rule

注意

此参考是 Azure CLI（版本 2.57.0 或更高版本）的数据保护扩展的一部分。 该扩展将在首次运行 az dataprotection backup-policy retention-rule 命令时自动安装。 详细了解扩展。

在备份策略中创建生命周期并添加或删除保留规则。

命令

名称	说明	类型	状态
az dataprotection backup-policy retention-rule create-lifecycle	为 Azure 保留规则创建生命周期。	扩展	GA
az dataprotection backup-policy retention-rule remove	删除备份策略中的现有保留规则。	扩展	GA
az dataprotection backup-policy retention-rule set	添加新的保留规则或更新现有保留规则。	扩展	GA

az dataprotection backup-policy retention-rule create-lifecycle

为 Azure 保留规则创建生命周期。

az dataprotection backup-policy retention-rule create-lifecycle --count
                                                                --retention-duration-type {Days, Months, Weeks, Years}
                                                                --source-datastore {ArchiveStore, OperationalStore, VaultStore}
                                                                [--copy-option {CopyOnExpiryOption, CustomCopyOption, ImmediateCopyOption}]
                                                                [--target-datastore {ArchiveStore, OperationalStore, VaultStore}]

示例

创建每日生命周期

az dataprotection backup-policy retention-rule create-lifecycle --retention-duration-count 12 --retention-duration-type Days --source-datastore OperationalStore

必需参数

--count --retention-duration-count

保留持续时间计数。

--retention-duration-type --type

保留持续时间类型。

接受的值: Days, Months, Weeks, Years

--source-datastore

指定源数据存储。

接受的值: ArchiveStore, OperationalStore, VaultStore

可选参数

--copy-option

指定从源数据存储到目标数据存储的复制选项。

接受的值: CopyOnExpiryOption, CustomCopyOption, ImmediateCopyOption

--target-datastore

指定目标数据存储。

接受的值: ArchiveStore, OperationalStore, VaultStore

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az dataprotection backup-policy retention-rule remove

删除备份策略中的现有保留规则。

az dataprotection backup-policy retention-rule remove --name {Daily, Default, Monthly, Weekly, Yearly}
                                                      --policy

示例

删除保留规则

az dataprotection backup-policy retention-rule remove --name Daily --policy policy.json

必需参数

--name

指定要在策略中删除的保留规则名称。

接受的值: Daily, Default, Monthly, Weekly, Yearly

--policy

现有策略 Json 字符串或文件。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az dataprotection backup-policy retention-rule set

添加新的保留规则或更新现有保留规则。

az dataprotection backup-policy retention-rule set --lifecycles
                                                   --name {Daily, Default, Monthly, Weekly, Yearly}
                                                   --policy

示例

添加每日保留规则

az dataprotection backup-policy retention-rule set --lifecycles dailylifecycle.json --name Daily --policy policy.json

必需参数

--lifecycles

要与保留规则关联的生命周期。 指定空格分隔的 json 文件名。

--name

指定要在策略中编辑的保留规则名称。

接受的值: Daily, Default, Monthly, Weekly, Yearly

--policy

策略 Json 字符串或文件。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。