Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions,
see Getting Started with Amazon Web Services in China
(PDF).
Tag a Recycle Bin retention rule
You can assign custom tags to your retention rules to categorize them in different ways,
for example, by purpose, owner, or environment. This helps you to efficiently find a
specific retention rule based on the custom tags that you assigned.
You can assign a tag to a retention rule using one of the following methods.
- Recycle Bin console
-
To tag a retention rule
-
Open the Recycle Bin console at https://console.amazonaws.cn/rbin/home/
-
In the navigation pane, choose Retention rules.
-
Select the retention rule to tag, choose the Tags tab,
and then choose Manage tags.
-
Choose Add tag. For Key, enter the
tag key. For Value, enter the tag value.
-
Chose Save.
- Amazon CLI
-
To tag a retention rule
Use the tag-resource Amazon CLI command. For --resource-arn,
specify the Amazon Resource Name (ARN) of the retention rule to tag, and for
--tags, specify the tag key and value pair.
aws rbin tag-resource \
--resource-arn retention_rule_arn \
--tags key=tag_key,value=tag_value
Example
The following example command tags retention rule arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3
with tag purpose=production.
aws rbin tag-resource \
--resource-arn arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3 \
--tags key=purpose,value=production
View retention rule tags
You can view the tags assigned to a retention rule using one of the following methods.
- Recycle Bin console
-
To view tags for a retention rule
-
Open the Recycle Bin console at https://console.amazonaws.cn/rbin/home/
-
In the navigation pane, choose Retention rules.
-
Select the retention rule for which to view the tags, and choose the
Tags tab.
- Amazon CLI
-
To view the tags assigned to a retention rule
Use the list-tags-for-resource
Amazon CLI command. For --resource-arn, specify the ARN of the retention rule.
aws rbin list-tags-for-resource \
--resource-arn retention_rule_arn
Example
The following example command lists the tags for retention rule arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3.
aws rbin list-tags-for-resource \
--resource-arn arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3
Remove tags from retention rules
You can remove tags from a retention rule using one of the following methods.
- Recycle Bin console
-
To remove a tag from a retention rule
-
Open the Recycle Bin console at https://console.amazonaws.cn/rbin/home/
-
In the navigation pane, choose Retention rules.
-
Select the retention rule from which to remove the tag, choose the Tags
tab, and then choose Manage tags.
-
Choose Remove next to the tag to remove.
-
Chose Save.
- Amazon CLI
-
To remove a tag from a retention rule
Use the untag-resource
Amazon CLI command. For --resource-arn, specify the ARN of the retention rule. For --tagkeys,
specify the tags keys of the tags to remove.
aws rbin untag-resource \
--resource-arn retention_rule_arn \
--tagkeys tag_key
Example
The following example command removes tags that have a tag key of purpose from
retention rule arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3.
aws rbin untag-resource \
--resource-arn arn:aws:rbin:us-east-1:123456789012:rule/nOoSBBtItF3 \
--tagkeys purpose