在 Amazon Kinesis Data Streams 中标记流 - Amazon Kinesis Data Streams
查看标签基本知识使用标签跟踪成本了解标签限制使用 Kinesis Data Streams 控制台标记流使用 AWS CLI 标记流使用 Kinesis Data Streams API 标记流。

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

在 Amazon Kinesis Data Streams 中标记流

您可以将自己的元数据以标签的形式分配给您在 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 控制台添加、列出和删除标签。

查看流的标签

  1. 打开 Kinesis Data Streams 控制台。在导航栏中，展开区域选择器并选择一个区域。

  2. 在 Stream List (流列表) 页面上，选择一个流。

  3. 在流详细信息页面上，单击标签选项卡。

创建带有标签的数据流

  1. 打开 Kinesis Data Streams 控制台。在导航栏中，展开区域选择器并选择一个区域。

  2. 选择创建流。

  3. 在创建数据流页面上，输入数据流的名称，然后选择按需或预置容量模式。默认情况下，系统将选择按需模式。有关更多信息，请参阅 选择数据流容量模式。

  4. 在标签部分，选择添加新标签。在键字段中指定标签，然后也可以选择在值字段中指定值。

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

  5. 选择创建数据流。

  6. 在数据流页面上，当流处于创建中时，流的状态显示为正在创建。当流可以使用时，其状态会更改为活动。

  7. 选择流的名称。Stream Details (流详细信息) 页面显示了流配置摘要以及监控信息。

向流添加标签

  1. 打开 Kinesis Data Streams 控制台。在导航栏中，展开区域选择器并选择一个区域。

  2. 在 Stream List (流列表) 页面上，选择一个流。

  3. 在流详细信息页面上，单击标签选项卡。

  4. 在键字段中指定标签键，然后也可以在值字段中指定标签值，然后选择添加标签。

    如果 Add Tag (添加标签) 按钮未启用，即表示您指定的标签键或标签值不满足标签限制。有关更多信息，请参阅 了解标签限制。

  5. 要在标签选项卡上的列表中查看新标签，请选择刷新图标。

从流中删除标签

  1. 打开 Kinesis Data Streams 控制台。在导航栏中，展开区域选择器并选择一个区域。

  2. 在“Stream List (流列表)”页面上，选择一个流。

  3. 在“流详细信息”页面上，选择标签选项卡，然后选择标签的删除图标。

  4. 在删除标签对话框中，选择是的，删除。

使用 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

从指定的流中删除标签。