使用标记 - 适用于 SQL 应用程序的 Amazon Kinesis Data Analytics 开发人员指南
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

对于新项目,建议您使用新的适用于 Apache Flink Studio 的托管服务,而不是使用适用于 SQL 应用程序的 Kinesis Data Analytics。Managed Service for Apache Flink Studio 不仅操作简单,还具有高级分析功能,使您能够在几分钟内构建复杂的流处理应用程序。

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

使用标记

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

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

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

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

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

  • 应用程序标签的最大数量包括系统标签。用户定义的应用程序标签的最大数量为 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" ] }