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

# 將標籤新增至 Managed Service for Apache Flink 應用程式
<a name="how-tagging"></a>



本節說明如何將索引鍵-值中繼資料標籤新增至 Managed Service for Apache Flink 應用程式。這些標籤可用於下列目的：
+ 決定個別 Managed Service for Apache Flink 應用程式的帳單。如需詳細資訊，請參閱《帳單和成本管理使用者指南》中的[使用成本分配標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)**。
+ 根據標籤控制對應用程式資源的存取。如需詳細資訊，請參閱《AWS Identity and Access Management 使用者指南》**中的[使用標籤控制存取權](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。
+ 使用者定義的目的。您可以根據使用者標籤的存在來定義應用程式的功能。

注意有關標記的以下資訊：
+ 應用程式標籤的數目上限包括系統標籤。使用者定義的應用程式的標籤數目上限為 50。
+ 如果動作包含具有重複 `Key` 值的標籤清單，則服務會擲出 `InvalidArgumentException`。

**Topics**
+ [建立應用程式時新增標籤](how-tagging-create.md)
+ [新增或更新現有應用程式的標籤](how-tagging-add.md)
+ [列出應用程式的標籤](how-tagging-list.md)
+ [從應用程式移除標籤](how-tagging-remove.md)

# 建立應用程式時新增標籤
<a name="how-tagging-create"></a>

您可以在使用 [CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html) 動作的 `tags` 參數建立應用程式時新增標籤。

以下範例請求顯示 `CreateApplication` 請求的 `Tags` 節點：

```
"Tags": [ 
    { 
        "Key": "Key1",
        "Value": "Value1"
    },
    { 
        "Key": "Key2",
        "Value": "Value2"
    }
]
```

# 新增或更新現有應用程式的標籤
<a name="how-tagging-add"></a>

您可以使用 [TagResource](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_TagResource.html) 動作將標籤新增至應用程式。您無法使用 [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html) 動作為應用程式新增標籤。

若要更新現有的標籤，請使用與現有標籤相同的索引鍵新增標籤。

`TagResource` 動作的下列請求範例會新增標籤或更新現有標籤：

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "NewTagKey",
         "Value": "NewTagValue"
      },
      { 
         "Key": "ExistingKeyOfTagToUpdate",
         "Value": "NewValueForExistingTag"
      }
   ]
}
```

# 列出應用程式的標籤
<a name="how-tagging-list"></a>

若要列出現有標籤，請使用 [ListTagsForResource](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_ListTagsForResource.html) 動作。

`ListTagsForResource` 動作的下列請求範例可列出應用程式的標籤：

```
{
   "ResourceARN": "arn:aws:kinesisanalyticsus-west-2:012345678901:application/MyApplication"
}
```

# 從應用程式移除標籤
<a name="how-tagging-remove"></a>

若要從應用程式移除標籤，請使用 [UntagResource](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UntagResource.html) 動作。

`UntagResource` 動作的下列請求範例可移除應用程式的標籤：

```
{
   "ResourceARN": "arn:aws:kinesisanalyticsus-west-2:012345678901:application/MyApplication",
   "TagKeys": [ "KeyOfFirstTagToRemove", "KeyOfSecondTagToRemove" ]
}
```