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

# 标记 Amazon Kinesis Data Streams 资源
<a name="tagging"></a>

您可以将自己的元数据以*标签*的形式分配给您在 Amazon Kinesis Data Streams 中创建的流和增强扇出型消费端。标签是您为流定义的键值对。使用标签是一种管理 AWS 资源和整理数据（包括账单数据）的简单而强大的方法。

**Topics**
+ [查看标签基本知识](#tagging-basics)
+ [使用标签跟踪成本](#tagging-billing)
+ [了解标签限制](#tagging-restrictions)
+ [使用 Kinesis Data Streams 控制台标记流](#tagging-console)
+ [使用标记直播 AWS CLI](#tagging-cli)
+ [使用 Kinesis Data Streams 标记直播 APIs](#tagging-api)
+ [使用标记消费者 AWS CLI](#tagging-consumers-cli)
+ [使用 Kinesis Data Streams 标记消费者 APIs](#tagging-consumers-api)

## 查看标签基本知识
<a name="tagging-basics"></a>

可标记的 Kinesis Data Streams 资源包括数据流和增强型扇出消费端。你可以使用 Kinesis Data Streams 控制台 AWS CLI或 Kinesis Data Streams API 来完成以下任务：
+ 使用标签创建资源
+ 向资源添加标签
+ 列出资源的标签
+ 从资源中删除标签

**注意**  
使用 Kinesis Data Streams 控制台无法将标签应用于增强型扇出消费端。要将标签应用于使用者，请使用 AWS CLI 或 Kinesis Data Streams API。

您可以使用标签对 资源进行分类。例如，您可以按用途、所有者或环境对资源进行分类。由于您定义每个标签的键和值，因此您可以创建一组自定义类别来满足您的特定需求。例如，您可以定义一组标签来帮助您按拥有者和关联应用程序跟踪资源。以下几个标签示例：
+ 项目：项目名称
+ 所有者：名称
+ 用途：负载测试 
+ 应用程序：应用程序名称
+ 环境：生产 

**重要**  
要在创建流时添加标签，必须为流添加 `kinesis:CreateStream` 和 `kinesis:AddTagsToStream` 权限。在创建流时，**不能使用** `kinesis:TagResource` 权限来标记流。
要在消费端注册期间添加标签，就必须添加 `kinesis:TagResource` 和 `kinesis:RegisterStreamConsumer` 权限。

## 使用标签跟踪成本
<a name="tagging-billing"></a>

您可以使用标签对 AWS 费用进行分类和跟踪。当您对 Kinesis Data Streams 资源应用标签时， AWS 您的成本分配报告包括按标签汇总的使用量和成本。您可以设置代表业务类别（例如成本中心、应用程序名称或所有者）的标签，以便整理多种服务的成本。有关更多信息，请参阅《AWS Billing 用户指南》**中的[对自定义账单报告使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。

## 了解标签限制
<a name="tagging-restrictions"></a>

以下限制适用于标签：

**基本限制**
+ 每个资源的最大标签数是 50。
+ 标签键和值区分大小写。
+ 无法更改或编辑已删除的资源的标签。

**标签键限制**
+ 每个标签键必须是唯一的。如果您添加的标签具有已使用的键，则您的新标签将覆盖现有键值对。
+ 标签密钥不能以开头，`aws:`因为此前缀已保留供使用 AWS。 AWS 代表您创建以此前缀开头的标签，但您无法对其进行编辑或删除。
+ 标签键的长度必须介于 1 和 128 个 Unicode 字符之间。
+ 标签键必须包含以下字符：Unicode 字母、数字、空格和以下特殊字符：`_ . / = + - @`。

**标签值限制**
+ 标签值的长度必须介于 0 和 255 个 Unicode 字符之间。
+ 标签值可以为空。另外，它们必须包含以下字符：Unicode 字母、数字、空格和以下任意特殊字符：`_ . / = + - @`。

## 使用 Kinesis Data Streams 控制台标记流
<a name="tagging-console"></a>

您可以使用 Kinesis Data Streams 控制台在流上添加、更新、列出和移除标签。

**查看流的标签**

1. [登录 AWS 管理控制台 并在 /kinesis 上打开 Kinesis 控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/kinesis)

1. 在左侧导航窗格中，选择**数据流**。

1. 在**数据流**页面上，选择您要标记的流。

1. 在流详细信息页面上，选择**配置**。

1. 在**标签**部分，查看应用于流的标签。

**创建带有标签的数据流**

1. 打开 Kinesis Data Streams 控制台。

1. 在左侧导航窗格中，选择**数据流**。

1. 选择**创建数据流**。

1. 在**创建数据流**页面上，输入数据流的名称。

1. 对于**数据流容量**，选择**按需**或**预置**容量模式。

   有关容量模式的更多信息，请参阅[选择正确的流式传入的模式](how-do-i-size-a-stream.md)。

1. 请在**标签**部分执行以下操作：

   1. 选择**添加新标签**。

   1. 在**键**中输入标签，然后也可以选择在**值**字段中指定值。

      如果出现错误，则您指定的标签键或值不满足标签限制。有关更多信息，请参阅 [了解标签限制](#tagging-restrictions)。

1. 选择**创建数据流**。

**在流中添加或更新标签**

1. 打开 Kinesis Data Streams 控制台。

1. 在左侧导航窗格中，选择**数据流**。

1. 在**数据流**页面上，选择要向其添加或更新标签的流。

1. 在流详细信息页面上，选择**配置**。

1. 在**标签**部分中，选择**管理标签**。

1. 在**标签**下，执行以下操作之一：
   + 要添加标签，请选择**添加新标签**，然后输入标签的**键**和**值**数据。将该步骤重复执行所需的次数。

     每个流可以添加的最大标签数量为 50 个。
   + 要更新现有标签，请在该标签的**键**的**值**字段中输入新的标签值。

   如果出现错误，则您指定的标签键或值不满足标签限制。有关更多信息，请参阅 [了解标签限制](#tagging-restrictions)。

1. 选择**保存更改**。

**从流中删除标签**

1. 打开 Kinesis Data Streams 控制台。

1. 在左侧导航窗格中，选择**数据流**。

1. 在**数据流**页面上，选择要从中移除标签的流。

1. 在流详细信息页面上，选择**配置**。

1. 在**标签**部分中，选择**管理标签**。

1. 查找要移除的标签**键**和**值**对。然后，选择**移除**。

1. 选择**保存更改**。

## 使用标记直播 AWS CLI
<a name="tagging-cli"></a>

您可以使用 AWS CLI在流上添加、列出和移除标签。有关示例，请参阅以下文档。

 [create-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html)   
创建带有标签的流。

 [add-tags-to-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/add-tags-to-stream.html)   
为指定的流添加或更新标签。

 [list-tags-for-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/list-tags-for-stream.html)  
列出指定流的标签。

 [remove-tags-from-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/remove-tags-from-stream.html)  
从指定的流中删除标签。

## 使用 Kinesis Data Streams 标记直播 APIs
<a name="tagging-api"></a>

你可以使用 Kinesis Dat APIs a Streams 在直播中添加、列出和删除标签。有关示例，请参阅以下文档：

 [CreateStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_CreateStream.html)   
创建带有标签的流。

 [AddTagsToStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_AddTagsToStream.html)   
为指定的流添加或更新标签。

 [ListTagsForStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForStream.html)  
列出指定流的标签。

 [RemoveTagsFromStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RemoveTagsFromStream.html)  
从指定的流中删除标签。

## 使用标记消费者 AWS CLI
<a name="tagging-consumers-cli"></a>

您可以使用 AWS CLI在消费端上添加、列出和移除标签。有关示例，请参阅以下文档：

[register-stream-consumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)  
在带有标签的 Kinesis 数据流中注册消费端。

[tag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/tag-resource.html)  
为指定的 Kinesis 资源添加或更新标签。

[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-resource.html)  
列出指定 Kinesis 资源的标签。

[untag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/untag-resource.html)  
从指定的 Kinesis 资源中移除标签。

## 使用 Kinesis Data Streams 标记消费者 APIs
<a name="tagging-consumers-api"></a>

您可以使用 Kinesis Dat APIs a Streams 在使用者身上添加、列出和删除标签。有关示例，请参阅以下文档：

[RegisterStreamConsumer](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RegisterStreamConsumer.html)  
在带有标签的 Kinesis 数据流中注册消费端。

[TagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_TagResource.html)  
为指定的 Kinesis 资源添加或更新标签。

[ListTagsForResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForResource.html)  
列出指定 Kinesis 资源的标签。

[UntagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UntagResource.html)  
从指定的 Kinesis 资源中移除标签。