

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# BackupRule
<a name="API_BackupRule"></a>

指定用于备份所选资源的安排任务。

## 内容
<a name="API_BackupRule_Contents"></a>

 ** RuleName **   <a name="Backup-Type-BackupRule-RuleName"></a>
备份规则的显示名称。必须包含 1 到 50 个字母数字或“-\$1.” 字符。  
类型：字符串  
模式：`^[a-zA-Z0-9\-\_\.]{1,50}$`  
是否必需：是

 ** TargetBackupVaultName **   <a name="Backup-Type-BackupRule-TargetBackupVaultName"></a>
用于存储备份的逻辑容器的名称。备份保管库的名称在创建它们的账户和创建它们的 AWS 区域中是唯一的。  
类型：字符串  
模式：`^[a-zA-Z0-9\-\_]{2,50}$`  
是否必需：是

 ** CompletionWindowMinutes **   <a name="Backup-Type-BackupRule-CompletionWindowMinutes"></a>
一个时间值（以分钟为单位），用于指定备份作业在成功启动之后必须在多长时间内完成，否则将会被 AWS Backup取消。该值为可选项。  
类型：长整型  
必需：否

 ** CopyActions **   <a name="Backup-Type-BackupRule-CopyActions"></a>
`CopyAction` 对象的数组，其中包含复制操作的详细信息。  
类型：[CopyAction](API_CopyAction.md) 对象数组  
必需：否

 ** EnableContinuousBackup **   <a name="Backup-Type-BackupRule-EnableContinuousBackup"></a>
指定是否 AWS Backup 创建连续备份。创建 AWS Backup 能够 point-in-time恢复的连续备份 (PITR) 的真实原因。False（或未指定）会 AWS Backup 导致创建快照备份。  
类型：布尔值  
必需：否

 ** IndexActions **   <a name="Backup-Type-BackupRule-IndexActions"></a>
IndexActions 是一个数组，用于指定应如何为备份数据编制索引。  
每个备份 BackupRule 可以有 0 或 1 IndexAction，因为每个备份最多可以有一个与之关联的索引。  
数组中是 ResourceType。每种只能接受一个 BackupRule。  
类型：[IndexAction](API_IndexAction.md) 对象数组  
必需：否

 ** Lifecycle **   <a name="Backup-Type-BackupRule-Lifecycle"></a>
生命周期定义了受保护的资源何时过渡到冷存储以及何时过期。 AWS Backup 根据您定义的生命周期自动过渡和过期备份。  
过渡到冷存储的备份必须在冷库中存储至少 90 天。因此，“保留期”设置必须比“转换为冷态前经过的天数”设置多 90 天。在备份转换为冷态后，无法更改“转换为冷态前经过的天数”设置。  
按资源划分的[功能可用性表中列出了可以过渡到冷存储的资源](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource)类型。 AWS Backup 对于其他资源类型，将忽略此表达式。  
类型：[Lifecycle](API_Lifecycle.md) 对象  
必需：否

 ** RecoveryPointTags **   <a name="Backup-Type-BackupRule-RecoveryPointTags"></a>
从备份还原时分配给与此规则关联的资源的标签。  
类型：字符串到字符串映射  
必需：否

 ** RuleId **   <a name="Backup-Type-BackupRule-RuleId"></a>
唯一标识用于安排所选资源备份的规则。  
类型：字符串  
必需：否

 ** ScanActions **   <a name="Backup-Type-BackupRule-ScanActions"></a>
包含备份规则的扫描配置，包括恶意软件扫描程序以及完整或增量扫描模式。  
类型：[ScanAction](API_ScanAction.md) 对象数组  
必需：否

 ** ScheduleExpression **   <a name="Backup-Type-BackupRule-ScheduleExpression"></a>
UTC 格式的 cron 表达式，用于指定何时 AWS Backup 启动备份作业。当未提供 CRON 表达式时， AWS Backup 将使用默认表达式`cron(0 5 ? * * *)`。  
有关 AWS cron 表达式的更多信息，请参阅 *Amazon Ev CloudWatch ents 用户指南*[中的规则计划表达式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html)。  
 AWS cron 表达式的两个示例是` 15 * ? * * *`（每小时在过去 15 分钟时进行一次备份）和`0 12 * * ? *`（UTC 每天中午 12 点进行备份）。  
要查看示例表，请单击前面的链接并向下滚动页面。  
类型：字符串  
必需：否

 ** ScheduleExpressionTimezone **   <a name="Backup-Type-BackupRule-ScheduleExpressionTimezone"></a>
设置计划表达式所在的时区。默认情况下，以 UTC ScheduleExpressions 为单位。您可以将其修改为指定的时区。  
类型：字符串  
必需：否

 ** StartWindowMinutes **   <a name="Backup-Type-BackupRule-StartWindowMinutes"></a>
一个时间值（以分钟为单位），用于指定在安排了备份之后，必须在多长时间内成功启动作业，否则将会被取消。该值为可选项。如果包含此值，则必须至少为 60 分钟才能避免错误。  
在启动时段内，备份作业的状态将保持 `CREATED` 状态，直到成功启动或启动时段结束为止。如果在启动窗口内 AWS Backup 收到允许重试作业的错误消息， AWS Backup 则至少每 10 分钟自动重试一次以开始作业，直到备份成功开始（任务状态更改为`RUNNING`）或任务状态更改为`EXPIRED`（预计在启动窗口时间结束时发生）。  
类型：长整型  
必需：否

 ** TargetLogicallyAirGappedBackupVaultArn **   <a name="Backup-Type-BackupRule-TargetLogicallyAirGappedBackupVaultArn"></a>
逻辑上存在气隙的保管库的 ARN。ARN 必须位于同一个账户和区域中。如果提供，则支持的完全托管资源将直接备份到逻辑上空隙的保管库，而其他支持的资源则在备份保管库中创建临时（可计费）快照，然后将其复制到逻辑上空隙的保管库中。不支持的资源只能备份到指定的备份存储库。  
类型：字符串  
必需：否

## 另请参阅
<a name="API_BackupRule_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupRule) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupRule) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupRule) 