支援終止通知：2026 年 10 月 7 日 AWS 將停止 的支援 AWS IoT Greengrass Version 1。2026 年 10 月 7 日之後，您將無法再存取 AWS IoT Greengrass V1 資源。如需詳細資訊，請造訪[從 遷移 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。

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

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

標籤可協助您組織和管理 AWS IoT Greengrass 群組。您可以使用標籤來指派中繼資料至群組、大量部署和核心、裝置，以及加入至群組的其他資源。標籤也可用於 IAM 政策，以定義對 Greengrass 資源的條件式存取。

**注意**  
目前， AWS IoT 帳單群組或成本分配報告不支援 Greengrass 資源標籤。

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

標籤可讓您將 AWS IoT Greengrass 資源分類，例如依用途、擁有者和環境。當您有許多相同類型的資源時，您可以依據先前附加的標籤，快速識別資源。每個標籤皆包含由您定義的一個標籤鍵和選用值。我們建議您為每種資源類型設計一組標籤金鑰。使用一致的標籤金鑰組可讓您更輕鬆管理您的 資源。例如，您可以為您的群組定義一組標籤，幫助您追蹤核心裝置的工廠位置。如需詳細資訊，請參閱 [AWS 標記策略](https://aws.amazon.com/answers/account-management/aws-tagging-strategies)。

### AWS IoT 主控台中的標記支援
<a name="tagging-support-console"></a>

您可以在 AWS IoT 主控台中建立、檢視和管理 Greengrass `Group` 資源的標籤。在建立標籤之前，請注意下列標籤限制。如需詳細資訊，請參閱《》中的[標籤命名和使用慣例](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)*Amazon Web Services 一般參考*。

**在建立群組時指派標籤**  
您可以在建立群組時將標籤指派給群組。選擇**標籤區段下的新增****標籤**，以顯示標記輸入欄位。

**從群組組態頁面檢視和管理標籤**  
您可以選擇檢視**設定，從群組組態頁面檢視**和管理標籤。在群組的**標籤**區段中，選擇**管理標籤**以新增、編輯或移除群組標籤。

### AWS IoT Greengrass API 中的標記支援
<a name="tagging-support-api"></a>

您可以使用 AWS IoT Greengrass API 來建立、列出和管理支援標記之 AWS IoT Greengrass 資源的標籤。在建立標籤之前，請注意下列標籤限制。如需詳細資訊，請參閱《》中的[標籤命名和使用慣例](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)*Amazon Web Services 一般參考*。
+ 若要在資源建立時新增標籤，請在資源的 `tags` 屬性定義這些標籤。
+ 若要在建立資源後新增標籤，或更新標籤值，請使用 `TagResource` 動作。
+ 若要從資源移除標籤，請使用 `UntagResource` 動作。
+ 若要擷取與一項資源相關聯的標籤，請使用 `ListTagsForResource` 動作，或取得資源並檢查其 `tags` 屬性。

下表列出您可以在 AWS IoT Greengrass API 中標記的資源及其對應的 `Create`和 `Get`動作。


| 資源 | 建立 | 取得 | 
| --- | --- | --- | 
| Group | [https://docs.aws.amazon.com/greengrass/v1/apireference/creategroup-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/creategroup-post.html) | [https://docs.aws.amazon.com/greengrass/v1/apireference/getgroup-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/getgroup-get.html) | 
| ConnectorDefinition | [https://docs.aws.amazon.com/greengrass/v1/apireference/createconnectordefinition-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/createconnectordefinition-post.html) | [https://docs.aws.amazon.com/greengrass/v1/apireference/getconnectordefinition-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/getconnectordefinition-get.html) | 
| CoreDefinition | [https://docs.aws.amazon.com/greengrass/v1/apireference/createcoredefinition-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/createcoredefinition-post.html) | [https://docs.aws.amazon.com/greengrass/v1/apireference/getcoredefinition-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/getcoredefinition-get.html) | 
| DeviceDefinition | [https://docs.aws.amazon.com/greengrass/v1/apireference/createdevicedefinition-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/createdevicedefinition-post.html) | [https://docs.aws.amazon.com/greengrass/v1/apireference/getdevicedefinition-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/getdevicedefinition-get.html) | 
| FunctionDefinition | [https://docs.aws.amazon.com/greengrass/v1/apireference/createfunctiondefinition-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/createfunctiondefinition-post.html) | [https://docs.aws.amazon.com/greengrass/v1/apireference/getfunctiondefinition-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/getfunctiondefinition-get.html) | 
| LoggerDefinition | [https://docs.aws.amazon.com/greengrass/v1/apireference/createloggerdefinition-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/createloggerdefinition-post.html) | [https://docs.aws.amazon.com/greengrass/v1/apireference/getloggerdefinition-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/getloggerdefinition-get.html) | 
| ResourceDefinition | [https://docs.aws.amazon.com/greengrass/v1/apireference/createresourcedefinition-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/createresourcedefinition-post.html) | [https://docs.aws.amazon.com/greengrass/v1/apireference/getresourcedefinition-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/getresourcedefinition-get.html) | 
| SubscriptionDefinition | [https://docs.aws.amazon.com/greengrass/v1/apireference/createsubscriptiondefinition-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/createsubscriptiondefinition-post.html) | [https://docs.aws.amazon.com/greengrass/v1/apireference/getsubscriptiondefinition-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/getsubscriptiondefinition-get.html) | 
| BulkDeployment  | [https://docs.aws.amazon.com/greengrass/v1/apireference/startbulkdeployment-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/startbulkdeployment-post.html) | [https://docs.aws.amazon.com/greengrass/v1/apireference/getbulkdeploymentstatus-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/getbulkdeploymentstatus-get.html) | 

使用下列動作列出並管理支援標記之資源的標籤：
+ [https://docs.aws.amazon.com/greengrass/v1/apireference/tagresource-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/tagresource-post.html)。 將標籤新增至資源。也用來改變標籤鍵值對的數值。
+ [https://docs.aws.amazon.com/greengrass/v1/apireference/listtagsforresource-get.html](https://docs.aws.amazon.com/greengrass/v1/apireference/listtagsforresource-get.html)。 列出資源的標籤。
+ [https://docs.aws.amazon.com/greengrass/v1/apireference/untagresource-delete.html](https://docs.aws.amazon.com/greengrass/v1/apireference/untagresource-delete.html)。 從資源移除標籤。

您可以隨時新增或移除資源的標籤。若要變更標籤金鑰的值，請在資源加入定義相同金鑰和新數值的標籤。新的數值會覆寫舊的數值。您可以將數值設為空白字串，但您無法將數值設為 null。

您刪除資源時，也會刪除與該資源相關聯的標籤。

**注意**  
請勿將資源標籤與您可以指派給 AWS IoT 物件的屬性混淆。雖然 Greengrass 核心是 AWS IoT 實物，但本主題中所述的資源標籤會連接到 `CoreDefinition`，而不是核心實物。

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

在您的 IAM 政策中，您可以使用資源標籤來控制使用者存取和許可。例如，政策可讓使用者僅能建立具有特定標籤的資源。政策也可以限制使用者建立或修改具有特定標籤的資源。您可以在建立資源時進行標記 (稱為*建立時套用標籤*)，如此一來，您就不用再執行自訂標記指令碼。使用標籤啟動新環境時，會自動套用對應的 IAM 許可。

下列條件內容鍵和值可用於政策的 `Condition` 元素 (又稱為 `Condition` 區塊)。

`greengrass:ResourceTag/tag-key: tag-value`  
允許或拒絕資源使用者對具有特定標籤之資源的動作。

`aws:RequestTag/tag-key: tag-value`  
要求提出 API 請求，以建立或修改可標記的資源上之標籤時，必須使用 (或未使用) 特定的標籤。

`aws:TagKeys: [tag-key, ...]`  
要求提出 API 請求，以建立或修改可標記的資源上之標籤時，必須使用 (或未使用) 特定的一組標籤鍵。

條件內容索引鍵和值只能用於對可標記資源採取動作 AWS IoT Greengrass 的動作。這些動作將資源視為必要參數。例如，您可以設定對 `GetGroupVersion` 的條件式存取。您不能設定 `AssociateServiceRoleToAccount` 的有條件存取，因為請求中沒有參考可標記的資源 (例如群組、核心定義或裝置定義)。

如需詳細資訊，請參閱《[IAM 使用者指南》中的](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html)[使用標籤和 IAM JSON 政策參考控制存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。 **JSON 政策參考包含 IAM 中 JSON 政策的元素、變數和評估邏輯的詳細語法、描述和範例。

### 範例 IAM 政策
<a name="tagging-iam-policies-examples"></a>

以下範例政策套用標籤式許可，限制試用使用者只能在試用資源上進行動作。
+ 第一個陳述式允許 IAM 使用者僅對具有 *env=beta* 標籤的資源採取行動。
+ 第二個陳述式可防止 IAM 使用者從 資源中移除 *env=beta* 標籤。這樣可防止使用者移除自己的存取。
**注意**  
如果您使用標籤控制資源存取，您也應該管理許可，讓使用者能從同樣的資源新增或移除標籤。否則，有時使用者可能會透過修改標籤來避開您的限制，並取得資源的存取。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "greengrass:*",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/env": "beta"
                }
            }
        },
        {
            "Effect": "Deny",
            "Action": "greengrass:UntagResource",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/env": "beta"
                }
            }
        }
    ]
}
```

------

若要允許使用者建立資源時套用標籤，您必須提供適當的許可。以下範例政策包含 `greengrass:TagResource` 和 `greengrass:CreateGroup` 行動的 `"aws:RequestTag/env": "beta"` 條件，可讓使用者僅建立標記為 *env=beta* 的群組。這可有效強制使用者標記新群組。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "greengrass:TagResource",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/env": "beta"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "greengrass:CreateGroup",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/env": "beta"
                }
            }
        }
    ]
}
```

------

下列指令碼片段說明您可如何將用於標籤鍵的多組標籤值包含在清單中：

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

## 另請參閱
<a name="tagging-see-also"></a>
+ 中的[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) *Amazon Web Services 一般參考*