标记你的 Amazon Kinesis Data Streams 资源 - Amazon Kinesis Data Streams
查看标签基本知识使用标签跟踪成本了解标签限制使用 Kinesis Data Streams 控制台标记流使用标记直播 Amazon CLI使用 Kinesis Data Streams 标记直播 APIs使用标记消费者 Amazon CLI使用 Kinesis Data Streams 标记消费者 APIs
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

标记你的 Amazon Kinesis Data Streams 资源

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

查看标签基本知识

您可以标记的 Kinesis Data Streams 资源包括数据流和增强型扇出使用者。你可以使用 Kinesis Data Streams 控制台 Amazon CLI或 Kinesis Data Streams API 来完成以下任务：

  • 创建带有标签的资源

  • 为资源添加标签

  • 列出您的资源的标签

  • 从资源中移除标签

注意

您无法使用 Kinesis Data Streams 控制台将标签应用于增强型扇出使用者。要将标签应用于使用者，请使用 Amazon CLI 或 Kinesis Data Streams API。

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

  • 项目：项目名称

  • 所有者：名称

  • 用途：负载测试

  • 应用程序：应用程序名称

  • 环境：生产

重要

  • 要在创建直播时添加标签，必须包括该直播的kinesis:CreateStream和kinesis:AddTagsToStream权限。在创建直播时，您不能使用该kinesis:TagResource权限来标记直播。

  • 要在消费者注册期间添加标签，必须包括kinesis:TagResource和kinesis:RegisterStreamConsumer权限。

使用标签跟踪成本

您可以使用标签对 Amazon 费用进行分类和跟踪。当您对 Kinesis Data Streams 资源应用标签时， Amazon 您的成本分配报告包括按标签汇总的使用量和成本。您可以应用代表业务类别（例如成本中心、应用程序名称或所有者）的标签来组织多项服务的成本。有关更多信息，请参阅 Amazon Billing 用户指南中的对自定义账单报告使用成本分配标签。

了解标签限制

以下限制适用于标签：

基本限制

  • 每个资源的最大标签数是 50。

  • 标签键和值区分大小写。

  • 无法更改或编辑已删除的资源的标签。

标签键限制

  • 每个标签键必须是唯一的。如果您添加的标签具有已使用的键，则您的新标签将覆盖现有键值对。

  • 标签密钥不能以开头，aws:因为此前缀已保留供使用 Amazon。 Amazon 代表您创建以此前缀开头的标签，但您无法对其进行编辑或删除。

  • 标签键的长度必须介于 1 和 128 个 Unicode 字符之间。

  • 标签键必须包含以下字符：Unicode 字母、数字、空格和以下特殊字符：_ . / = + - @。

标签值限制

  • 标签值的长度必须介于 0 和 255 个 Unicode 字符之间。

  • 标签值可以为空。另外，它们必须包含以下字符：Unicode 字母、数字、空格和以下任意特殊字符：_ . / = + - @。

使用 Kinesis Data Streams 控制台标记流

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

查看流的标签

  1. 登录 Amazon Web Services Management Console 并在 /kinesis 上打开 Kinesis 控制台。https://console.aws.amazon.com

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

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

  4. 在直播详细信息页面上，选择配置。

  5. 在 “标签” 部分，查看应用于直播的标签。

创建带有标签的数据流

  1. 打开 Kinesis Data Streams 控制台。

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

  3. 选择创建数据流。

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

  5. 对于数据流容量，请选择按需或预配置容量模式。

    有关容量模式的更多信息，请参阅选择数据流容量模式。

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

    1. 选择添加新标签。

    2. 对于 Key，输入标签，也可以在 “值” 字段中指定一个值。

      如果您看到错误，则说明您指定的标签键或值不符合标签限制。有关更多信息，请参阅 了解标签限制。

  7. 选择创建数据流。

在直播中添加或更新标签

  1. 打开 Kinesis Data Streams 控制台。

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

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

  4. 在直播详细信息页面上，选择配置。

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

  6. 在 “标签” 下，执行以下任一操作：

    • 要添加新标签，请选择添加新标签，然后输入标签的键和值数据。将该步骤重复执行所需的次数。

      您可以为每个直播添加的最大标签数为 50。

    • 要更新现有标签，请在该标签的 Ke y 的 V alue 字段中输入新的标签值。

    如果您看到错误，则说明您指定的标签键或值不符合标签限制。有关更多信息，请参阅 了解标签限制。

  7. 选择保存更改。

从流中删除标签

  1. 打开 Kinesis Data Streams 控制台。

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

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

  4. 在直播详细信息页面上，选择配置。

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

  6. 找到要移除的标签键和值对。然后，选择移除。

  7. 选择保存更改。

使用标记直播 Amazon CLI

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

create-stream

创建带有标签的流。

add-tags-to-stream

为指定的流添加或更新标签。

list-tags-for-stream

列出指定流的标签。

remove-tags-from-stream

从指定的流中删除标签。

使用 Kinesis Data Streams 标记直播 APIs

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

CreateStream

创建带有标签的流。

AddTagsToStream

为指定的流添加或更新标签。

ListTagsForStream

列出指定流的标签。

RemoveTagsFromStream

从指定的流中删除标签。

使用标记消费者 Amazon CLI

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

register-stream-consumer

使用标签为 Kinesis 数据流注册使用者。

tag-resource

为指定的 Kinesis 资源添加或更新标签。

list-tags-for-resource

列出指定 Kinesis 资源的标签。

untag-resource

从指定的 Kinesis 资源中移除标签。

使用 Kinesis Data Streams 标记消费者 APIs

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

RegisterStreamConsumer

使用标签为 Kinesis 数据流注册使用者。

TagResource

为指定的 Kinesis 资源添加或更新标签。

ListTagsForResource

列出指定 Kinesis 资源的标签。

UntagResource

从指定的 Kinesis 资源中移除标签。