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

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

使用标记

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

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

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

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

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

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

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

创建应用程序时添加标签

您可以使用在创建应用程序时添加标签tags参数CreateApplicationaction.

以下示例请求显示了 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" ] }