BackupRule
指定用于备份所选资源的安排任务。
内容
- RuleName
-
备份规则的显示名称。必须包含 1 到 50 个字母数字或“-_.” 字符。
类型:字符串
模式:
^[a-zA-Z0-9\-\_\.]{1,50}$
必需:是
- TargetBackupVaultName
-
用于存储备份的逻辑容器的名称。备份保管库的名称在创建它们的账户和创建它们的 AWS 区域中是唯一的。
类型:字符串
模式:
^[a-zA-Z0-9\-\_]{2,50}$
必需:是
- CompletionWindowMinutes
-
一个时间值(以分钟为单位),用于指定备份作业在成功启动之后必须在多长时间内完成,否则将会被 AWS Backup 取消。该值为可选项。
类型:长整型
必需:否
- CopyActions
-
CopyAction
对象的数组,其中包含复制操作的详细信息。类型:CopyAction 对象数组
必需:否
- EnableContinuousBackup
-
指定 AWS Backup 是否创建连续备份。AWS Backup 创建支持时间点还原 (PITR) 功能的连续备份的真实原因。False(或未指定)会导致 AWS Backup 创建快照备份。
类型:布尔值
必需:否
- Lifecycle
-
生命周期定义受保护的资源何时转换到冷存储以及何时过期。AWS Backup 将根据您定义的生命周期自动转换备份和使备份过期。
转换到冷存储的备份必须在冷存储中存储至少 90 天。因此,“保留期”设置必须比“转换为冷态前经过的天数”设置多 90 天。在备份转换为冷态后,无法更改“转换为冷态前经过的天数”设置。
可以转换为冷存储的资源类型在按资源划分的特征可用性表中列出。对于其他资源类型,AWS Backup 会忽略此表达式。
类型:Lifecycle 对象
必需:否
- RecoveryPointTags
-
从备份还原时分配给与此规则关联的资源的标签。
类型:字符串到字符串映射
必需:否
- RuleId
-
唯一标识用于安排所选资源备份的规则。
类型:字符串
必需:否
- ScheduleExpression
-
CRON 表达式(采用 UTC),指定 AWS Backup 何时启动备份作业。有关 AWS Cron 表达式的更多信息,请参阅《Amazon CloudWatch Events 用户指南》中的安排规则的表达式。AWS Cron 表达式的两个示例是
15 * ? * * *
(每小时过 15 分钟备份一次)和0 12 * * ? *
(UTC 每天中午 12 点进行备份)。要查看示例表,请单击前面的链接并向下滚动页面。类型:字符串
必需:否
- ScheduleExpressionTimezone
-
设置计划表达式所在的时区。默认情况下,ScheduleExpressions 用 UTC 表示。您可以将其修改为指定的时区。
类型:字符串
必需:否
- StartWindowMinutes
-
一个时间值(以分钟为单位),用于指定在安排了备份之后,必须在多长时间内成功启动作业,否则将会被取消。该值为可选项。如果包含此值,则必须至少为 60 分钟才能避免错误。
在启动时段内,备份作业的状态将保持
CREATED
状态,直到成功启动或启动时段结束为止。如果在启动时段内 AWS Backup 收到允许重试作业的错误消息,则 AWS Backup 至少每 10 分钟自动重试一次以启动作业,直到备份成功启动(作业状态更改为RUNNING
)或作业状态更改为EXPIRED
(应该在启动时段结束时发生)。类型:长整型
必需:否
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: