使用标记 - Amazon Kinesis Data Analytics
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

使用标记

本节介绍如何将密钥值元数据标签添加到 Kinesis Data Analytics 应用程序。这些标签可用于以下目的:

  • 确定各 Kinesis Data Analytics 应用程序的账单。有关更多信息,请参阅 AWS 账单和成本管理指南中的使用成本分配标签

  • 根据标签控制对应用程序资源的访问。有关更多信息,请参阅 AWS Identity and Access Management 用户指南中的使用标签控制访问

  • 用户定义的目的。您可以根据用户标签定义应用程序的功能。

请注意与标记相关的以下信息:

  • 应用程序标签的最大数量包括系统标签。用户定义的应用程序标签的最大数量为 50。

  • 如果某项操作包含的标签列表存在重复的 Key 值,服务将提示 InvalidArgumentException

创建应用程序时添加标签

您可以在使用 CreateApplication 操作的 tags 参数创建应用程序时添加标签。

以下示例请求显示了 CreateApplication 请求的 Tags 节点:

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

为现有应用程序添加或更新标签

您可以使用 TagResource 操作将标签添加到应用程序中。您无法使用 UpdateApplication 操作将标签添加到应用程序中。

要更新现有标签,可添加一个与现有标签的键相同的标签。

TagResource 操作的以下示例请求添加新标签或更新现有标签:

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

列出应用程序的标签

要列出现有的标签,您可以使用 ListTagsForResource 操作。

ListTagsForResource 操作的以下示例请求列出应用程序的标签:

{ "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication" }

从应用程序删除标签

要从应用程序中删除标签,您可以使用 UntagResource 操作。

UntagResource 操作的以下示例请求从应用程序中删除标签:

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