Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

给您的 Amazon IoT Events 资源加标签

为了帮助您管理和组织检测程序模型和输入，您可以选择将自己的元数据以标签的形式分配给其中每个资源。本部分介绍标签并说明如何创建标签。

有关标签的基本知识

标签可让您按各种标准（例如用途、所有者或环境）对 Amazon IoT Events 资源进行分类。这在您有许多相同类型的资源时会非常有用。您可以根据分配到特定资源的标签来快速识别该资源。

每个标签都包含您定义的一个键和一个可选值。例如，您可为输入定义一系列标签，以帮助您按类型追踪发送这些输入的设备。我们建议您为每类资源创建一组可满足您的需求的标签键。使用一组连续的标签键，管理资源时会更加轻松。

您可以根据您添加或应用的标签搜索和筛选资源，使用标签分类和追踪成本，还可以使用标签控制对资源的访问权限，如Amazon IoT《开发者指南》中的通过 IAM 策略使用标签所述。

为便于使用，Amazon Web Services Management Console中的 Tag Editor 提供了一种用于创建和管理标签的集中而统一的方法。有关更多信息，请参阅使用 Amazon Web Services Management Console中的使用 Tag Editor。

您也可以使用 Amazon CLI 和 Amazon IoT Events API 处理标签。创建标签时，您可使用以下命令中的"Tags"字段，将标签与检测程序模型和输入值关联：

您可以使用以下命令为支持标记的现有资源添加、修改或删除标签：

您可以修改标签的密钥和值，还可以随时删除资源的标签。您可以将标签的值设为空的字符串，但是不能将其设为空值。如果您添加的标签的值与该实例上现有标签的值相同，新的值就会覆盖旧值。如果删除资源，则所有与资源相关的标签都将被删除。

Amazon标签添加策略中提供了其他信息。

标签限制

下面是适用于标签的基本限制：

在 IAM 策略中使用标签

可以在用于 Amazon IoT Events API 操作的 IAM 策略中应用基于标签的资源级权限。这可让您更好地控制用户可创建、修改或使用哪些资源。

在 IAM 策略中将 Condition 元素（也称作 Condition 块）与以下条件上下文键和值结合使用来基于资源标签控制用户访问（权限）：

Amazon Identity and Access Management 用户指南中的使用标签控制访问权限包含有关使用标签的额外信息。该指南的 IAM JSON 策略参考部分包含 IAM 中的 JSON 策略的元素、变量和评估逻辑的详细语法、描述和示例。

以下示例策略应用两个基于标签的限制。受此策略限制的用户：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [
                "iotevents:CreateDetectorModel",
                "iotevents:CreateAlarmModel",
                "iotevents:CreateInput",
                "iotevents:TagResource"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/env": "prod"
                }
            }
        },
        {
            "Effect": "Deny",
            "Action": [
                "iotevents:DescribeDetectorModel",
                "iotevents:DescribeAlarmModel",
                "iotevents:UpdateDetectorModel",
                "iotevents:UpdateAlarmModel",
                "iotevents:DeleteDetectorModel",
                "iotevents:DeleteAlarmModel",
                "iotevents:ListDetectorModelVersions",
                "iotevents:ListAlarmModelVersions",
                "iotevents:UpdateInput",
                "iotevents:DescribeInput",
                "iotevents:DeleteInput",
                "iotevents:ListTagsForResource",
                "iotevents:TagResource",
                "iotevents:UntagResource",
                "iotevents:UpdateInputRouting"
            ],
            "Resource": "*",
            "Condition": {
                "StringLike": {
                    "aws:ResourceTag/env": "prod"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "iotevents:*"
            ],
            "Resource": "*"
        }
    ]
}

您还可以为给定标签键指定多个标签值，方法是将它们括在列表中，如下所述。

            "StringEquals" : {
              "aws:ResourceTag/env" : ["dev", "test"]
            }