使用保留规则
要启用和使用回收站,您必须在要保护资源的 AWS 区域中创建保留规则。保留规则指定以下内容:
-
要保护的资源的类型。
-
删除后要保留在回收站中的资源。
-
永久删除之前保留资源在回收站中的保留期。
使用回收站,可创建两种类型的保留规则:
-
标签级保留规则:标签级保留规则使用资源标签来标记要保留在回收站中的资源。对于每个保留规则,您可以指定一个或多个标签键和值对。使用保留规则中至少一个指定标签键值对标记的指定类型的资源,将在删除后自动保留在回收站中。如果要根据标签保护账户中的特定资源,请使用这种类型的保留规则。
-
区域级保留规则:区域级保留规则未指定任何资源标签。其适用于创建规则的区域中指定类型的所有资源,即使这些资源未被标记。如果要保护特定区域内特定类型的所有资源,请使用这种类型的保留规则。
创建保留规则后,符合其条件的资源将在删除后的指定保留期内自动保留在回收站中。
创建保留规则
要创建保留规则,您必须指定以下内容:
-
保留规则的可选名称。名称最多可以有 255 个字符。
-
保留规则的可选描述。描述长度最多为 255 个字符。
-
将受保留规则保护的资源类型。
-
标记要保留在回收站中的资源的资源标签。您最多可以为每个规则指定 50 个标签。但是,您只能将相同的标签密钥和值对添加到最多 5 个保留规则中。
-
资源删除后要保留在回收站中的时间。期限可以长达 1 年(365 天)。
-
可选的保留规则标签,以帮助识别和组织保留规则。您最多可以为每个规则分配 50 个标签。
保留规则仅在创建它们的区域中有效。如果您打算在其它区域中使用回收站,则必须在这些区域中创建其它保留规则。
您可以使用以下方法创建回收站保留规则。
- Recycle Bin console
-
创建保留规则
-
在以下位置打开回收站控制台 https://console.aws.amazon.com/rbin/home/
-
在导航窗格中,选择 Retention rules(保留规则),然后选择 Create retention rule(创建保留规则)。
-
在 Basic details(基本详细信息)部分中,执行以下操作:
-
(可选)在 Retention rule name(保留规则名称)中,输入保留规则的描述性名称。
-
(可选)在 Retention rule description(保留规则描述)中,输入保留规则的简单描述。
-
在 Rule settings(规则设置)部分,执行以下操作:
-
对于 Resource type(资源类型),选择要保护的保留规则的资源类型。保留规则将仅在回收站中保留此类资源。
-
请执行下列操作之一:
-
要创建与区域中所有已删除的指定类型资源匹配的区域级保留规则,请选择 Apply to all resources(应用于所有资源)。保留规则将在删除资源后将所有已删除的指定资源保留在回收站中,即使资源没有任何标签也是如此。
-
要创建标签级保留规则,请在 Resource tags to match(要匹配的资源标签)中输入标签键值对,以便标记要保留在回收站中的指定类型资源。至少具有指定标签键值对之一的指定类型资源才会根据保留规则保留。
-
对于 Retention period(保留期),输入保留规则在回收站中保留资源的天数。
-
(可选)在 Tags(标签)部分,执行以下操作:
-
要使用自定义标签标记规则,请选择 Add tag(添加标签),然后输入标签键值对。
-
选择 Create retention rule(创建保留规则)。
- AWS CLI
-
创建保留规则
使用 create-rule AWS CLI 命令。对于 --retention-period
,请指定在回收站中保留已删除快照的天数。对于 --resource-type
,为快照指定 EBS_SNAPSHOT
,或者为 AMI 指定 EC2_IMAGE
。要创建标签级别保留规则,请在 --resource-tags
中指定用于标记要保留快照的标签。要创建区域级别的保留规则,请省略 --resource-tags
。
C:\>
aws rbin create-rule \
--retention-period RetentionPeriodValue=number_of_days
,RetentionPeriodUnit=DAYS \
--resource-type EBS_SNAPSHOT|EC2_IMAGE
\
--description "rule_description
" \
--resource-tags ResourceTagKey=tag_key
,ResourceTagValue=tag_value
示例 1
以下示例命令创建区域级保留规则,该规则将所有已删除的快照保留 8
天。
C:\>
aws rbin create-rule \
--retention-period RetentionPeriodValue=8,RetentionPeriodUnit=DAYS \
--resource-type EBS_SNAPSHOT \
--description "Match all snapshots"
示例 2
以下示例命令创建标签级保留规则,该规则将被 purpose=production
标记的所有已删除的快照保留 14
天。
C:\>
aws rbin create-rule \
--retention-period RetentionPeriodValue=14,RetentionPeriodUnit=DAYS \
--resource-type EBS_SNAPSHOT \
--description "Match snapshots with a specific tag" \
--resource-tags ResourceTagKey=purpose,ResourceTagValue=production
查看回收站保留规则
您可以使用以下方法之一查看回收站保留规则。
- Recycle Bin console
-
- AWS CLI
-
查看所有保留规则
使用 list-rules AWS CLI 命令;对于 --resource-type
,为快照指定 EBS_SNAPSHOT
,或者为 AMI 指定 EC2_IMAGE
。
C:\>
aws rbin list-rules --resource-type EBS_SNAPSHOT|EC2_IMAGE
示例
以下示例命令列出了所有保留快照的保留规则。
C:\>
aws rbin list-rules --resource-type EBS_SNAPSHOT
查看特定保留规则的信息
使用 get-rule AWS CLI 命令。
C:\>
aws rbin get-rule --identifier rule_ID
示例
以下示例命令提供了有关保留规则 pwxIkFcvge4
的信息。
C:\>
aws rbin get-rule --identifier pwxIkFcvge4
更新保留规则
创建后,您可以随时更新保留规则的说明、资源标签和保留期。创建后,您无法更新规则的资源类型。
更新保留规则后,这些更改仅适用于其保留的新资源。这些更改不会影响之前发送到回收站的资源。例如,如果您更新了保留规则的保留期,则在新的保留期内只会保留更新后删除的快照。在更新之前发送到回收站的快照仍会在上一个(旧)保留期内保留。
您可以使用以下方法之一更新保留规则。
- Recycle Bin console
-
更新保留规则
-
在以下位置打开回收站控制台 https://console.aws.amazon.com/rbin/home/
-
在导航面板中,选择 Retention rules(保留规则)。
-
在网格中,选择要更新的保留规则,然后选择 Actions(操作)、Edit retention rule(编辑保留规则)。
-
在 Rule details(规则详细信息)部分中,根据需要更新 Retention rule name(保留规则名称)和 Retention rule description(保留规则描述)。
-
在 Rule settings(规则设置)部分中,根据需要更新 Resource type(资源类型)、Resource tags to match(要匹配的资源标签)和 Retention period(保留期)。
-
在 Tags(标签)部分,根据需要添加或删除保留规则标签。
-
选择 Save retention rule(保存保留规则)。
- AWS CLI
-
更新保留规则
使用 update-rule AWS CLI 命令。对于 --identifier
,指定要更新的保留规则的 ID。对于 --resource-types
,为快照指定 EBS_SNAPSHOT
,或者为 AMI 指定 EC2_IMAGE
。
C:\>
aws rbin update-rule \
--identifier rule_ID
\
--retention-period RetentionPeriodValue=number_of_days
,RetentionPeriodUnit=DAYS \
--resource-type EBS_SNAPSHOT|EC2_IMAGE
\
--description "rule_description
"
示例
以下示例命令更新了保留规则 6lsJ2Fa9nh9
,以将所有快照保留 21
天,并更新其描述。
C:\>
aws rbin update-rule \
--identifier 6lsJ2Fa9nh9 \
--retention-period RetentionPeriodValue=21,RetentionPeriodUnit=DAYS \
--resource-type EBS_SNAPSHOT \
--description "Retain for three weeks"
标签保留规则
可以给保留规则分配自定义标签,以便按不同的方式将它们分类,例如按用途、拥有者或环境分类。这有助于根据所分配的自定义标签高效查找特定保留规则。
您可以使用以下方法之一为保留规则分配标签。
- Recycle Bin console
-
标记保留规则
-
在以下位置打开回收站控制台 https://console.aws.amazon.com/rbin/home/
-
在导航面板中,选择 Retention rules(保留规则)。
-
选择要标记的保留规则,选择 Tags(标签)选项卡,然后选择 Manage tags(管理标签)。
-
选择 Add tag (添加标签)。对于 Key(键),输入标签建。对于 Value(值),输入键值。
-
选择 Save(保存)。
- AWS CLI
-
标记保留规则
使用 tag-resource AWS CLI 命令。对于 --resource-arn
,请指定要标记的保留规则的 Amazon Resource Name (ARN),并为 --tags
指定标签键值对。
C:\>
aws rbin tag-resource \
--resource-arn retention_rule_arn
\
--tags key=tag_key
,value=tag_value
示例
以下示例命令使用标签 arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3
来标记保留规则 purpose=production
。
C:\>
aws rbin tag-resource \
--resource-arn arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3 \
--tags key=purpose,value=production
查看保留规则标签
您可以使用以下方法之一查看分配给保留规则的标签。
- Recycle Bin console
-
- AWS CLI
-
查看分配给保留规则的标签
使用 list-tags-for-resource AWS CLI 命令。对于 --resource-arn
,请指定保留规则的 ARN。
C:\>
aws rbin list-tags-for-resource \
--resource-arn retention_rule_arn
示例
以下示例命令列举保留规则 arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3
的标签。
C:\>
aws rbin list-tags-for-resource \
--resource-arn arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3
从保留规则中删除标签
您可以使用以下方法之一从保留规则中删除标签。
- Recycle Bin console
-
- AWS CLI
-
从保留规则中删除标签
使用 untag-resource AWS CLI 命令。对于 --resource-arn
,请指定保留规则的 ARN。对于 --tagkeys
,请指定要删除标签的标签键。
C:\>
aws rbin untag-resource \
--resource-arn retention_rule_arn
\
--tagkeys tag_key
示例
以下示例命令删除保留规则 arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3
的 标签键为 purpose
的标签。
C:\>
aws rbin untag-resource \
--resource-arn arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3 \
--tagkeys purpose
查看回收站保留规则
您可以随时删除保留规则。删除保留规则时,回收站内在删除完成后将不再保留删除的新资源。根据保留规则中定义的保留期限,在删除保留规则之前发送到回收站的资源将继续保留在回收站中。期限到期后,资源将从回收站中永久删除。
您可以使用以下方法之一删除保留规则。
- Recycle Bin console
-
删除保留规则
-
在以下位置打开回收站控制台 https://console.aws.amazon.com/rbin/home/
-
在导航面板中,选择 Retention rules(保留规则)。
-
在表格中选择要删除的保留规则,然后选择 Actions(操作)、Delete retention rule(删除保留规则)。
-
在系统提示时,输入确认消息并选择 Delete retention rule(删除保留规则)。
- AWS CLI
-
删除保留规则
使用 delete-rule AWS CLI 命令。对于 --identifier
,请指定要删除的保留规则的 ID。
C:\>
aws rbin delete-rule --identifier rule_ID
示例
以下示例命令删除保留规则 6lsJ2Fa9nh9
。
C:\>
aws rbin delete-rule --identifier 6lsJ2Fa9nh9