本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
您可以将自己的元数据以标签的形式分配给您在 Amazon Kinesis Data Streams 中创建的流。标签是您为流定义的键值对。使用标签是一种管理 AWS 资源和整理数据（包括账单数据）的简单而强大的方法。
内容
查看标签基本知识
你可以使用 Kinesis Data Streams 控制台 AWS CLI或 Kinesis Data Streams API 来完成以下任务：
-
创建带有标签的流
-
向流添加标签
-
列出流的标签
-
从流中删除标签
您可以使用标签对流进行分类。例如，您可以按用途、所有者或环境对流进行分类。由于您定义每个标签的键和值，因此您可以创建一组自定义类别来满足您的特定需求。例如，您可以定义一组标签来帮助您按拥有者和关联应用程序跟踪流。以下几个标签示例：
-
项目：项目名称
-
所有者：名称
-
用途：负载测试
-
应用程序：应用程序名称
-
环境：生产
使用标签跟踪成本
您可以使用标签对 AWS 费用进行分类和跟踪。当您将标签应用于 AWS 资源（包括直播）时，您的 AWS 成本分配报告将包括按标签汇总的使用量和成本。您可以设置代表业务类别（例如成本中心、应用程序名称或所有者）的标签，以便整理多种服务的成本。有关更多信息，请参阅 AWS Billing 用户指南中的对自定义账单报告使用成本分配标签。
了解标签限制
以下限制适用于标签。
基本限制
-
每个资源（流）的最大标签数是 50。
-
标签键和值区分大小写。
-
无法更改或编辑已删除的流的标签。
标签键限制
-
每个标签键必须是唯一的。如果您添加的标签具有已使用的键，则您的新标签将覆盖现有键值对。
-
标签密钥不能以开头，
aws:因为此前缀已保留供使用 AWS。 AWS 代表您创建以此前缀开头的标签，但您无法对其进行编辑或删除。 -
标签键的长度必须介于 1 和 128 个 Unicode 字符之间。
-
标签键必须包含以下字符：Unicode 字母、数字、空格和以下特殊字符：
_ . / = + - @。
标签值限制
-
标签值的长度必须介于 0 和 255 个 Unicode 字符之间。
-
标签值可以为空。另外，它们必须包含以下字符：Unicode 字母、数字、空格和以下任意特殊字符：
_ . / = + - @。
使用 Kinesis Data Streams 控制台标记流
您可以使用 Kinesis Data Streams 控制台添加、列出和删除标签。
查看流的标签
-
打开 Kinesis Data Streams 控制台。在导航栏中，展开区域选择器并选择一个区域。
-
在 Stream List (流列表) 页面上，选择一个流。
-
在流详细信息页面上，单击标签选项卡。
创建带有标签的数据流
-
打开 Kinesis Data Streams 控制台。在导航栏中，展开区域选择器并选择一个区域。
-
选择创建流。
-
在创建数据流页面上，输入数据流的名称，然后选择按需或预置容量模式。默认情况下，系统将选择按需模式。有关更多信息，请参阅 选择数据流容量模式。
-
在标签部分，选择添加新标签。在键字段中指定标签，然后也可以选择在值字段中指定值。
如果出现错误，则您指定的标签键或值不满足标签限制。有关更多信息，请参阅 了解标签限制。
-
选择创建数据流。
-
在数据流页面上，当流处于创建中时，流的状态显示为正在创建。当流可以使用时，其状态会更改为活动。
-
选择流的名称。Stream Details (流详细信息) 页面显示了流配置摘要以及监控信息。
向流添加标签
-
打开 Kinesis Data Streams 控制台。在导航栏中，展开区域选择器并选择一个区域。
-
在 Stream List (流列表) 页面上，选择一个流。
-
在流详细信息页面上，单击标签选项卡。
-
在键字段中指定标签键，然后也可以在值字段中指定标签值，然后选择添加标签。
如果 Add Tag (添加标签) 按钮未启用，即表示您指定的标签键或标签值不满足标签限制。有关更多信息，请参阅 了解标签限制。
-
要在标签选项卡上的列表中查看新标签，请选择刷新图标。
从流中删除标签
-
打开 Kinesis Data Streams 控制台。在导航栏中，展开区域选择器并选择一个区域。
-
在“Stream List (流列表)”页面上，选择一个流。
-
在“流详细信息”页面上，选择标签选项卡，然后选择标签的删除图标。
-
在删除标签对话框中，选择是的，删除。
使用标记直播 AWS CLI
您可以使用 AWS CLI添加、列出和删除标签。有关示例，请参阅以下文档。
- create-stream
-
创建带有标签的流。
- add-tags-to-stream
-
为指定的流添加或更新标签。
- list-tags-for-stream
-
列出指定流的标签。
- remove-tags-from-stream
-
从指定的流中删除标签。
使用 Kinesis Data Streams API 标记流。
您可以使用 Kinesis Data Streams API 添加、列出和删除标签。有关示例，请参阅以下文档：
- CreateStream
-
创建带有标签的流。
- AddTagsToStream
-
为指定的流添加或更新标签。
- ListTagsForStream
-
列出指定流的标签。
- RemoveTagsFromStream
-
从指定的流中删除标签。
