为亚马逊 MSK 集群添加标记 - Amazon Managed Streaming for Apache Kafka
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

为亚马逊 MSK 集群添加标记

您可以将自己的元数据分配给标签添加到亚马逊 MSK 资源(如 MSK 集群)。标签是您为资源定义的键值对。使用标签是管理 Amazon 资源和组织数据(包括账单数据)的一种简单却强有力的方式。

有关标签的基本知识

您可以使用 Amazon MSK API 完成以下任务:

  • 向 Amazon MSK 资源添加标签。

  • 列出 Amazon MSK 资源的标签。

  • 从 Amazon MSK 资源中删除标签。

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

以下是标签的多个示例:

  • Project: Project name

  • Owner: Name

  • Purpose: Load testing

  • Environment: Production

使用标签跟踪成本

您可以使用标签对 Amazon 成本进行分类和跟踪。当您将标签应用到Amazon资源,包括亚马逊 MSK 集群、Amazon成本分配报告包括按标签汇总的使用率和成本。您可通过应用代表业务类别(如成本中心、应用程序名称或拥有者)的标签来整理多种服务的成本。有关更多信息,请参阅 。使用成本分配标签中的Amazon Billing and Cost Management用户指南

标签限制

以下限制适用于 Amazon MSK 中的标签。

基本限制

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

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

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

标签键限制

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

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

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

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

标签值限制

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

  • 标签值可以为空。否则,它们必须由以下字符组成:Unicode 字母、数字、空格和以下任意特殊字符:_ . / = + - @

使用 Amazon MSK API 标记资源

您可以使用以下操作来标记或取消标记 Amazon MSK 资源,或者列出资源的当前标记集: