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

如果我们为英文版本指南提供翻译,那么如果存在任何冲突,将以英文版本指南为准。在提供翻译时使用机器翻译。

使用标记

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

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

  • 根据标签控制对应用程序资源的访问。有关详细信息,请参阅 使用标签控制访问AWS身份和访问管理用户指南.

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

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

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