使用标记 - Amazon Kinesis Data Analytics 开发者指南
创建应用程序时添加标签为现有应用程序添加或更新标签列出应用程序的标签从应用程序删除标签
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

对于新项目，我们建议您使用新的 Kinesis Data Analytics 工作室，而不是 SQL 应用程序的 Kinesis Data Analytics。Kinesis Data Analytics Studio 将易用性与高级分析功能相结合，使您能够在几分钟内构建复杂的流处理应用程序。

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

使用标记

本节介绍如何向 Kinesis Data Analytics 应用程序添加键值元数据标签。这些标签可用于以下目的：

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

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