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

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

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

在亚马逊数据 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.

以下示例演示了允许用户创建 Firehose 直播并应用标签的策略。

{
    "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 直播时指定标签。对于现有的 Firehose 直播，您可以使用以下三个操作添加、列出和移除标签：