标记 Amazon Kinesis Data Streams 资源
您可以将自己的元数据以标签的形式分配给您在 Amazon Kinesis Data Streams 中创建的流和增强扇出型消费端。标签是您为流定义的键值对。使用标签是管理 AWS 资源和组织数据（包括账单数据）的一种简单却强有力的方式。
目录
查看标签基本知识
可标记的 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权限。
使用标签跟踪成本
您可以使用标签对 AWS 成本进行分类和跟踪。当您将标签应用于 Kinesis Data Streams 资源时，您的 AWS 成本分配报告将包括按标签聚合的使用率和成本。您可以设置代表业务类别（例如成本中心、应用程序名称或所有者）的标签，以便整理多种服务的成本。有关更多信息，请参阅 AWS Billing 用户指南中的对自定义账单报告使用成本分配标签。
了解标签限制
以下限制适用于标签：
基本限制
-
每个资源的最大标签数是 50。
-
标签键和值区分大小写。
-
无法更改或编辑已删除的资源的标签。
标签键限制
-
每个标签键必须是唯一的。如果您添加的标签具有已使用的键，则您的新标签将覆盖现有键值对。
-
标签键不能以
aws:开头，因为此前缀将预留以供 AWS 使用。AWS 将代表您创建以此前缀开头的标签，但您不能编辑或删除这些标签。 -
标签键的长度必须介于 1 和 128 个 Unicode 字符之间。
-
标签键必须包含以下字符：Unicode 字母、数字、空格和以下特殊字符：
_ . / = + - @。
标签值限制
-
标签值的长度必须介于 0 和 255 个 Unicode 字符之间。
-
标签值可以为空。另外，它们必须包含以下字符：Unicode 字母、数字、空格和以下任意特殊字符：
_ . / = + - @。
使用 Kinesis Data Streams 控制台标记流
您可以使用 Kinesis Data Streams 控制台在流上添加、更新、列出和移除标签。
查看流的标签
-
登录到 AWS 管理控制台，然后通过以下网址打开 Kinesis 控制台：https://console.aws.amazon.com/kinesisvideo/home
。 -
在左侧导航窗格中，选择数据流。
-
在数据流页面上，选择您要标记的流。
-
在流详细信息页面上，选择配置。
-
在标签部分，查看应用于流的标签。
创建带有标签的数据流
-
打开 Kinesis Data Streams 控制台。
-
在左侧导航窗格中，选择数据流。
-
选择创建数据流。
-
在创建数据流页面上，输入数据流的名称。
-
对于数据流容量，选择按需或预置容量模式。
有关容量模式的更多信息，请参阅选择正确的流式传入的模式。
-
请在标签部分执行以下操作：
-
选择添加新标签。
-
在键中输入标签，然后也可以选择在值字段中指定值。
如果出现错误，则您指定的标签键或值不满足标签限制。有关更多信息，请参阅 了解标签限制。
-
-
选择创建数据流。
在流中添加或更新标签
-
打开 Kinesis Data Streams 控制台。
-
在左侧导航窗格中，选择数据流。
-
在数据流页面上，选择要向其添加或更新标签的流。
-
在流详细信息页面上，选择配置。
-
在标签部分中，选择管理标签。
-
在标签下，执行以下操作之一：
-
要添加标签，请选择添加新标签，然后输入标签的键和值数据。将该步骤重复执行所需的次数。
每个流可以添加的最大标签数量为 50 个。
-
要更新现有标签，请在该标签的键的值字段中输入新的标签值。
如果出现错误，则您指定的标签键或值不满足标签限制。有关更多信息，请参阅 了解标签限制。
-
-
选择保存更改。
从流中删除标签
-
打开 Kinesis Data Streams 控制台。
-
在左侧导航窗格中，选择数据流。
-
在数据流页面上，选择要从中移除标签的流。
-
在流详细信息页面上，选择配置。
-
在标签部分中，选择管理标签。
-
查找要移除的标签键和值对。然后，选择移除。
-
选择保存更改。
使用 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
-
从指定的流中删除标签。
使用 AWS CLI 标记消费端
您可以使用 AWS CLI 在消费端上添加、列出和移除标签。有关示例，请参阅以下文档：
- register-stream-consumer
-
在带有标签的 Kinesis 数据流中注册消费端。
- - tag-resource
-
为指定的 Kinesis 资源添加或更新标签。
- list-tags-for-resource
-
列出指定 Kinesis 资源的标签。
- - untag-resource
-
从指定的 Kinesis 资源中移除标签。
使用 Kinesis Data Streams API 标记消费端
您可以使用 Kinesis Data Streams API 在消费端上添加、列出和移除标签。有关示例，请参阅以下文档：
- RegisterStreamConsumer
-
在带有标签的 Kinesis 数据流中注册消费端。
- TagResource
-
为指定的 Kinesis 资源添加或更新标签。
- ListTagsForResource
-
列出指定 Kinesis 资源的标签。
- UntagResource
-
从指定的 Kinesis 资源中移除标签。
