给您的 AWS WA Tool 资源加标签 - AWS Well-Architected Tool
有关标签的基本知识标记您的 资源标签限制通过控制台使用标签通过 API 使用标签

我们已经发布了 Well-Architected Framework 的新版本。我们还在镜头目录中添加了新的和更新的镜头。了解有关变更的更多信息。

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

给您的 AWS WA Tool 资源加标签

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

有关标签的基本知识

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

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

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

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

可以使用 AWS Management Console、AWS CLI 和 AWS WA Tool API 处理标签。

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

标记您的 资源

您可以标记新的或现有的 AWS WA Tool 资源。

如果您使用的是 AWS WA Tool 控制台，则可以在创建新资源时对其应用标签，或随时对现有资源应用标签。对于现有工作负载，您可以通过属性选项卡应用标签。对于现有的自定义剖析、配置文件和审核模板，您可以通过概述选项卡应用标签。

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

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

下表描述了可以标记的 AWS WA Tool 资源以及可在创建时标记的资源。

AWS WA Tool 资源标记支持
资源 支持标签 支持标签传播 支持在创建时添加标签 (AWS WA Tool API、AWS CLI、AWS 开发工具包)

AWS WA Tool 工作负载

是

 否

是
AWS WA Tool 自定义剖析 是 否 是
AWS WA Tool 配置文件 是 否 是
AWS WA Tool 审核模板 是 否 是

标签限制

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

  • 每个资源的标签数上限 – 50

  • 对于每个资源，每个标签键都必须是唯一的，每个标签键只能有一个值。

  • 最大键长度 – 128 个 Unicode 字符（采用 UTF-8 格式）

  • 最大值长度 – 256 个 Unicode 字符 (采用 UTF-8 格式)

  • 如果您的标记方案针对多个 AWS 服务和资源使用，请记得其它服务可能对允许使用的字符有限制。通常允许使用的字符包括可用 UTF-8 格式表示的字母、数字和空格，以及以下字符：+ - = . _ : / @。

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

  • 请不要使用 aws:、AWS: 或此类拼写的任意大小写组合作为键或值的前缀，因为它将保留以供 AWS 使用。您无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入每个资源的标签数限制。

通过控制台使用标签

通过使用 AWS WA Tool 控制台，您可以管理与新的或现有的资源关联的标签。

在创建时为单个资源添加标签

您可以在创建 AWS WA Tool 资源时为它们添加标签。

为单个资源添加和删除标签

您可以通过 AWS WA Tool 直接从工作负载的属性选项卡，以及自定义剖析、配置文件和审核模板的概述选项卡中添加或删除与资源关联的标签。

在工作负载上添加或删除标签

  1. 登录 AWS Management Console，并通过以下网址打开 AWS Well-Architected Tool 控制台：https://console.aws.amazon.com/wellarchitected/。

  2. 从导航栏中，选择要使用的区域。

  3. 在导航窗格中，选择工作负载。

  4. 选择要修改的工作负载，然后选择属性。

  5. 在 Tags (标签) 部分中，选择 Manage tags (管理标签)。

  6. 根据需要添加或删除标签。

    • 若要添加标签，请选择添加新标签，然后填写键和值字段。

    • 要删除标签，请选择删除。

  7. 对要添加、修改或删除的每个标签重复此过程。选择 Save (保存) 以保存您的更改。

在自定义剖析上添加或删除标签

  1. 登录 AWS Management Console，并通过以下网址打开 AWS Well-Architected Tool 控制台：https://console.aws.amazon.com/wellarchitected/。

  2. 从导航栏中，选择要使用的区域。

  3. 在导航窗格中，选择自定义剖析。

  4. 选择要修改的自定义剖析的名称。

  5. 在概述选项卡的标签部分，选择管理标签。

  6. 根据需要添加或删除标签。

    • 若要添加标签，请选择添加新标签，然后填写键和值字段。

    • 要删除标签，请选择删除。

  7. 对要添加、修改或删除的每个标签重复此过程。选择 Save (保存) 以保存您的更改。

在配置文件上添加或删除标签

  1. 登录 AWS Management Console，并通过以下网址打开 AWS Well-Architected Tool 控制台：https://console.aws.amazon.com/wellarchitected/。

  2. 从导航栏中，选择要使用的区域。

  3. 在导航窗格中，选择配置文件。

  4. 选择要修改的配置文件的名称。

  5. 在概述选项卡的标签部分，选择管理标签。

  6. 根据需要添加或删除标签。

    • 若要添加标签，请选择添加新标签，然后填写键和值字段。

    • 要删除标签，请选择删除。

  7. 对要添加、修改或删除的每个标签重复此过程。选择 Save (保存) 以保存您的更改。

在审核模板上添加或删除标签

  1. 登录 AWS Management Console，并通过以下网址打开 AWS Well-Architected Tool 控制台：https://console.aws.amazon.com/wellarchitected/。

  2. 从导航栏中，选择要使用的区域。

  3. 在导航窗格中，选择审核模板。

  4. 选择要修改的审核模板的名称。

  5. 在概述选项卡的标签部分，选择管理标签。

  6. 根据需要添加或删除标签。

    • 若要添加标签，请选择添加新标签，然后填写键和值字段。

    • 要删除标签，请选择删除。

  7. 对要添加、修改或删除的每个标签重复此过程。选择 Save (保存) 以保存您的更改。

通过 API 使用标签

使用以下 AWS WA Tool API 操作来添加、更新、列出和删除资源的标签。

AWS WA Tool 资源标记支持
任务 API 操作

添加或覆盖一个或多个标签。

TagResource

删除一个或多个标签。

UntagResource
列出资源的标签。

ListTagsForResource

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

任务 API 操作
创建工作负载 CreateWorkload
导入新剖析

ImportLens
创建 配置文件

CreateProfile
创建审核模板

CreateReviewTemplate