为 Amazon MSK 集群添加标签

您可以将自己的元数据以标签的形式分配给 Amazon MSK 资源，例如 MSK 集群。标签是您为资源定义的键值对。使用标签是一种管理 AWS 资源和整理数据（包括账单数据）的简单而强大的方法。

标签基本知识

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

• 将标签添加到 Amazon MSK 资源。

• 列出 Amazon MSK 资源的标签。

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

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

以下是标签的多个示例：

• Project: Project name

• Owner: Name

• Purpose: Load testing

• Environment: Production

使用标签跟踪成本

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

标签限制

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

基本限制

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

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

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

标签键限制

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

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

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

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

标签值限制

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

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

使用 Amazon MSK API 为资源添加标签

您可以使用以下操作来为 Amazon MSK 资源添加标签或取消添加标签，或者列出资源的当前标签集：

• ListTagsForResource

• TagResource

• UntagResource