Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

给您的 Amazon Cloud Map 资源加标签

为了帮助您管理 Amazon Cloud Map 资源，您可通过标签 的形式为每个资源分配元数据。本主题介绍标签并演示如何创建标签。

有关标签的基本知识

标签是为 Amazon 资源分配的标记。每个标签都包含您定义的一个键 和一个可选值。

标签可让您按用途、所有者或环境等对 Amazon 资源进行分类。在您具有相同类型的许多资源时，可以根据分配给资源的标签快速识别特定资源。例如，您可以为 Amazon Cloud Map 服务定义一组标签，以帮助您跟踪每个服务的拥有者和堆栈级别。我们建议您为每个资源类型设计一组一致的标签键。

标签不会自动分配至您的资源。添加标签后，您可以编辑标签键和值，还可以随时删除资源的标签。如果删除资源，资源的所有标签也会被删除。

标签对 Amazon Cloud Map 没有任何语义意义，应严格按字符串进行解析。您可以将标签的值设为空的字符串，但是不能将其设为空值。如果您添加的标签的值与该实例上现有标签的值相同，新的值就会覆盖旧值。

可以使用 Amazon Web Services Management Console、Amazon CLI 和 Amazon Cloud Map API 处理标签。

如果您使用的是 Amazon Identity and Access Management (IAM)，则可以控制 Amazon 账户中的哪些用户拥有创建、编辑或删除标签的权限。

标记您的 资源

您可以标记新的或现有的 Amazon Cloud Map 命名空间和服务。

如果您使用的是 Amazon Cloud Map 控制台，则可以在创建新资源时对其应用标签，或随时在相关资源页面上使用 Tags (标签) 选项卡对现有资源应用标签。

如果您使用的是 Amazon Cloud Map API、Amazon CLI 或 Amazon 开发工具包，则可以使用相关 API 操作上的 tags 参数对新资源应用标签，或使用 TagResource API 操作对现有资源应用标签。有关更多信息，请参阅 TagResource。

某些资源创建操作允许您在创建资源时为其指定标签。如果无法在资源创建期间应用标签，资源创建过程失败。这可确保对于您希望在创建时标记的资源，要么使用指定的标签创建，要么完全不创建。如果您在创建时标记资源，则无需在资源创建后运行自定义标记脚本。

下表描述了可以标记的 Amazon Cloud Map 资源以及可在创建时标记的资源。

标签限制

下面是适用于标签的基本限制：

通过 CLI 或 API 使用标签

使用以下 Amazon CLI 命令或 Amazon Cloud Map API 操作来添加、更新、列出和删除资源的标签。

以下示例说明如何使用 Amazon CLI 标记或取消标记资源。

示例 1：标记现有资源

以下命令标记现有资源。

aws servicediscovery tag-resource --resource-arn resource_ARN --tags team=devs

示例 2：取消标记现有资源

以下命令删除现有资源的标签。

aws servicediscovery untag-resource --resource-arn resource_ARN --tag-keys tag_key

示例 3：列出资源的标签

以下命令列出与现有资源关联的标签。

aws servicediscovery list-tags-for-resource --resource-arn resource_ARN

某些资源创建操作允许您在创建资源时指定标签。以下操作支持在创建时进行标记。