在 Amazon Data Firehose 中标记你的 Firehose 直播 - Amazon Data Firehose
有关标签的基本知识使用标签跟踪成本标签限制使用亚马逊数据 Firehose API 为 Firehose 直播添加标签
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

亚马逊 Data Firehose 以前被称为亚马逊 Kinesis Data Firehose

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

在 Amazon Data Firehose 中标记你的 Firehose 直播

您可以将自己的元数据以标签的形式分配给您在亚马逊数据 Firehose 中创建的 Firehose 流。标签是您为流定义的键值对。使用标签是一种管理 Amazon 资源和整理数据（包括账单数据）的简单而强大的方法。

有关标签的基本知识

您可以使用 Amazon Data Firehose API 来完成以下任务：

  • 在 Firehose 直播中添加标签。

  • 列出你的 Firehose 直播的标签。

  • 从 Firehose 直播中移除标签。

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

以下是标签的多个示例：

  • Project: Project name

  • Owner: Name

  • Purpose: Load testing

  • Application: Application name

  • Environment: Production

如果您在CreateDeliveryStream操作中指定标签，Amazon Data Firehose 会对该firehose:TagDeliveryStream操作执行额外的授权，以验证用户是否有权创建标签。如果您不提供此权限，则创建带有 IAM 资源标签的新 Firehose 交付流的请求将失败，AccessDeniedException如下所示。

AccessDeniedException 
User: arn:aws:sts::x:assumed-role/x/x is not authorized to perform: firehose:TagDeliveryStream on resource: arn:aws:firehose:us-east-1:x:deliverystream/x with an explicit deny in an identity-based policy.

以下示例演示了一个允许用户创建传输流和应用标签的策略。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "firehose:CreateDeliveryStream",
            "Resource": "*",
            }
        },
        {
            "Effect": "Allow",
            "Action": "firehose:TagDeliveryStream",
            "Resource": "*",
            }
        }
    ]
}

使用标签跟踪成本

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

标签限制

以下限制适用于亚马逊 Data Firehose 中的标签。

基本限制

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

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

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

标签键限制

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

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

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

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

标签值限制

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

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

使用亚马逊数据 Firehose API 为 Firehose 直播添加标签

您可以在调用创建新的 Fire CreateDeliveryStreamhose 直播时指定标签。对于现有的传输流，您可以使用以下三个操作添加、列出和删除标签：