经过仔细考虑，我们决定停用适用于 SQL 应用程序的 Amazon Kinesis Data Analytics：

1. 从 **2025年9月1日起，**我们将不再为适用于SQL应用程序的Amazon Kinesis Data Analytics Data Analytics提供任何错误修复，因为鉴于即将停产，我们对其的支持将有限。

2. 从 **2025 年 10 月 15 日**起，您将无法为 SQL 应用程序创建新的 Kinesis Data Analytics。

3. 从 **2026 年 1 月 27 日**起，我们将删除您的应用程序。您将无法启动或操作 Amazon Kinesis Data Analytics for SQL 应用程序。从那时起，将不再提供对 Amazon Kinesis Data Analytics for SQL 的支持。有关更多信息，请参阅 [Amazon Kinesis Data Analytics for SQL 应用程序停用](discontinuation.md)。

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

# 使用标记
<a name="how-tagging"></a>

本节介绍如何将密钥值元数据标签添加到 Kinesis Data Analytics 应用程序。这些标签可用于以下目的：
+ 确定单个 Kinesis Data Analytics 应用程序的计费。有关更多信息，请参阅 *AWS 账单和成本管理指南*中的[使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。
+ 根据标签控制对应用程序资源的访问。有关更多信息，请参阅*《 用户指南》*中的[使用标签控制访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。
+ 用户定义的目的。您可以根据用户标签定义应用程序的功能。

请注意与标记相关的以下信息：
+ 应用程序标签的最大数量包括系统标签。用户定义的应用程序标签的最大数量为 50。
+ 如果某项操作包含的标签列表存在重复的 `Key` 值，服务将提示 `InvalidArgumentException`。

**Topics**
+ [创建应用程序时添加标签](#how-tagging-create)
+ [为现有应用程序添加或更新标签](#how-tagging-add)
+ [列出应用程序的标签](#how-tagging-list)
+ [从应用程序删除标签](#how-tagging-remove)

## 创建应用程序时添加标签
<a name="how-tagging-create"></a>

在创建应用程序时，您可以使用[CreateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_CreateApplication.html)操作的`tags`参数添加标签。

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

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

## 为现有应用程序添加或更新标签
<a name="how-tagging-add"></a>

您可以使用[TagResource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_TagResource.html)操作向应用程序添加标签。您无法使用[UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html)操作向应用程序添加标签。

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

针对 `TagResource` 操作的以下示例请求可添加新标签或更新现有标签：

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

## 列出应用程序的标签
<a name="how-tagging-list"></a>

要列出现有标签，请使用[ListTagsForResource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_ListTagsForResource.html)操作。

针对 `ListTagsForResource` 操作的以下示例请求可列出应用程序的标签：

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

## 从应用程序删除标签
<a name="how-tagging-remove"></a>

要从应用程序中移除标签，请使用[UntagResource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UntagResource.html)操作。

针对 `UntagResource` 操作的以下示例请求可从应用程序中删除标签：

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