Amazon Kinesis Data Firehose
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

在 Amazon Kinesis Data Firehose 中标记您的传输流

您可以使用标签 的形式将自己的元数据分配给您在 Amazon Kinesis Data Firehose 中创建的传输流。标签是您为流定义的键值对。使用标签是管理 AWS 资源和组织数据(包括账单数据)的一种简单却强有力的方式。

有关标签的基本知识

可使用 Amazon Kinesis Data Firehose API 完成以下任务:

  • 向传输流添加标签。

  • 列出传输流的标签。

  • 删除传输流的标签。

您可以使用标签对 Kinesis Data Firehose 传输流进行分类。例如,您可以按用途、拥有者或环境对传输流进行分类。由于您定义每个标签的键和值,因此您可以创建一组自定义类别来满足您的特定需求。例如,您可以定义一组标签来帮助您按拥有者和关联应用程序跟踪传输流。

以下是标签的多个示例:

  • Project: Project name

  • Owner: Name

  • Purpose: Load testing

  • Application: Application name

  • Environment: Production

使用标签跟踪成本

您可以使用标签对 AWS 成本进行分类和跟踪。当您将标签应用于 AWS 资源(包括 Kinesis Data Firehose 传输流)时,您的 AWS 成本分配报告将包括按标签聚合的使用率和成本。您可通过应用代表业务类别(如成本中心、应用程序名称或拥有者)的标签来整理多种服务的成本。有关更多信息,请参阅 AWS Billing and Cost Management 用户指南 中的为自定义账单报告使用成本分配标签

标签限制

以下限制适用于 Kinesis Data Firehose 中的标签。

基本限制

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

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

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

标签键限制

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

  • 标签键不能以 aws: 开头,因为此前缀将预留以供 AWS 使用。AWS 将代表您创建以此前缀开头的标签,但您不能编辑或删除这些标签。

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

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

标签值限制

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

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

使用 Amazon Kinesis Data Firehose API 为传输流添加标签

要添加、列出和删除标签,请使用以下三个操作: