支援終止通知：2026 年 5 月 20 日， AWS 將終止對 的支援 AWS IoT Events。2026 年 5 月 20 日之後，您將無法再存取 AWS IoT Events 主控台或 AWS IoT Events 資源。如需詳細資訊，請參閱[AWS IoT Events 終止支援](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 標記您的 AWS IoT Events 資源
<a name="tagging-iotevents"></a>

為了協助您管理和組織偵測器模型和輸入，您可以選擇以標籤形式將自己的中繼資料指派給每個資源。本節說明標籤並示範如何建立它們。

## 標籤基本概念
<a name="tagging-iotevents-basics"></a>

標籤可讓您以不同的方式分類 AWS IoT Events 資源，例如依用途、擁有者或環境。這在您擁有許多相同類型的資源時很有用。您可以根據您指派給資源的標籤快速識別特定資源。

每個標籤皆包含由您定義的一個「索引鍵」與選擇性的「值」。例如，您可以為輸入定義一組標籤，協助您依類型追蹤傳送這些輸入的裝置。我們建議您為每種資源類型建立符合您需求的一組標籤金鑰。使用一致的標籤金鑰組可讓您更輕鬆管理您的 資源。

您可以根據您新增或套用的標籤來搜尋和篩選資源、使用標籤來分類和追蹤成本，以及使用標籤來控制對資源的存取，如《 *AWS IoT 開發人員指南*》中的[使用標籤搭配 IAM 政策](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-iam.html)中所述。

為了方便使用， 中的標籤編輯器 AWS 管理主控台 提供集中、統一的方式來建立和管理標籤。如需詳細資訊，請參閱*《標記 AWS 資源和*[標籤編輯器使用者指南》中的標籤編輯器入門](https://docs.aws.amazon.com/tag-editor/latest/userguide/gettingstarted.html)。

您也可以使用 AWS CLI 和 AWS IoT Events API 處理標籤。使用下列命令中的 `"Tags"` 欄位建立標籤時，您可以將標籤與偵測器模型和輸入建立關聯：
+ [CreateDetectorModel](https://docs.aws.amazon.com/iotevents/latest/apireference/API_CreateDetectorModel.html)
+ [CreateInput](https://docs.aws.amazon.com/iotevents/latest/apireference/API_CreateInput.html)

您可以使用下列命令新增、修改或刪除支援標記功能的現有資源標籤：
+ [TagResource](https://docs.aws.amazon.com/iotevents/latest/apireference/API_TagResource.html)
+ [ListTagsForResource](https://docs.aws.amazon.com/iotevents/latest/apireference/API_ListTagsForResource.html)
+ [UntagResource](https://docs.aws.amazon.com/iotevents/latest/apireference/API_UntagResource.html)

您可以編輯標籤索引鍵和值，也可以隨時從資源中移除標籤。您可以將標籤的值設為空白字串，但您無法將標籤的值設為 Null。如果您新增的標籤具有與該資源上現有標籤相同的索引鍵，則新值會覆寫舊值。如果您刪除資源，也會刪除與該資源相關聯的任何標籤。

如需詳細資訊，請參閱[標記 AWS 資源的最佳實務](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html)

### 標籤的限制與上限
<a name="tagging-iot-restrict"></a>

以下基本限制適用於 標籤：
+ 每一資源最多標籤數：50
+ 金鑰長度上限 – UTF-8 127 個 Unicode 字元
+ 最大值長度 – 255 個 UTF-8 Unicode 字元
+ 標籤鍵與值皆區分大小寫。
+ 請勿在標籤名稱或值中使用 `"aws:"`字首，因為它已保留供 AWS 使用。您不可編輯或刪除具此字首的標籤名稱或值。具此字首的標籤，不算在受資源限制的標籤計數內。
+ 如果您的標記結構描述是跨多項服務和資源使用，請記得其他服務可能會有字元使用限制。通常，允許使用的字元為：可用 UTF-8 表示的英文字母、空格和數字，以及以下特殊字元：\$1 - = . \$1 : / @。

## 搭配 IAM 政策使用標籤
<a name="tagging-iot-iam"></a>

您可以在用於 AWS IoT Events API 動作的 IAM 政策中，套用以標籤為基礎的資源層級許可。這可讓您更有效地控制使用者可以建立、修改或使用哪些資源。

您可以使用 `Condition` 元素 (也稱為 `Condition` 區塊)，以及 IAM 政策中的以下條件內容金鑰和值，來根據資源標籤控制使用者存取 (許可)：
+ 使用 `aws:ResourceTag/<tag-key>: <tag-value>` 以允許或拒絕資源上具有特定標籤的使用者動作。
+ 使用 `aws:RequestTag/<tag-key>: <tag-value>` 以在提出 API 請求時，要求使用 (或不使用) 特定標籤，以建立或修改允許標籤的資源。
+ 使用 `aws:TagKeys: [<tag-key>, ...]` 以在提出 API 請求時，要求使用 (或不使用) 特定標籤金鑰集，以建立或修改允許標籤的資源。

**注意**  
IAM 政策中的條件內容金鑰和值，只會套用到資源識別符可標記為必要參數的那些 AWS IoT Events 動作。

*AWS Identity and Access Management 《 使用者指南*》中的[使用標籤控制存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)，有使用標籤的其他資訊。該指南的 [IAM JSON 政策參考](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html)章節有詳細的語法、說明，還有元素、變數範例，以及在 IAM 中的 JSON 政策評估邏輯。

以下範例政策會套用兩個以標籤為基礎的限制。此政策限制的使用者：
+ 無法給予資源 "env = prod" 標籤 (在範例中，請參閱此行 `"aws:RequestTag/env" : "prod"`
+ 無法修改或存取包含現有標籤 "env = prod" 的資源 (在範例中，請參閱此行 `"aws:ResourceTag/env" : "prod"`)。

------
#### [ 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"]
            }
```

**注意**  
如果您允許或拒絕使用者根據標籤存取資源，請務必考慮明確拒絕使用者將這些標籤新增至相同資源或從中移除的能力。否則，使用者可能透過修改標籤來避開您的限制，並取得資源的存取。