# 对AWS WA Tool资源加标签
<a name="tagging"></a>

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

**Topics**
+ [有关标签的基本知识](#tag-basics)
+ [标记您的资源](#tag-resources)
+ [标签限制](#tag-restrictions)
+ [通过控制台使用标签](#tag-resources-console)
+ [通过 API 使用标签](#tag-resources-api-sdk)

## 有关标签的基本知识
<a name="tag-basics"></a>

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

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

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

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

可以使用AWS 管理控制台、AWS CLI和AWS WA Tool API 处理标签。

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

## 标记您的资源
<a name="tag-resources"></a>

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

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

如果使用的是AWS WA Tool API、AWS CLI或AWS开发工具包，则可以使用相关 API 操作上的`tags`参数对新资源应用标签，或使用`TagResource` API 操作对现有资源应用标签。有关更多信息，请参阅 [TagResource](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html)。

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

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


**给AWS WA Tool资源加标签支持**  

| 资源 | 支持标签 | 支持标签传播 | 支持在创建时添加标签（AWS WA ToolAPI、AWS CLI、AWSSDK） | 
| --- | --- | --- | --- | 
| AWS WA Tool 工作负载 | 是 | 否 | 是 | 
| AWS WA Tool 自定义剖析 | 是 | 否 | 是 | 
| AWS WA Tool 配置文件 | 是 | 否 | 是 | 
| AWS WA Tool 审核模板 | 是 | 否 | 是 | 

## 标签限制
<a name="tag-restrictions"></a>

下面是适用于标签的基本限制：
+ 每个资源的标签数上限：50
+ 对于每个资源，每个标签键都必须是唯一的，每个标签键只能有一个值。
+ 最大键长度：128 个 Unicode 字符（采用 UTF-8 格式）
+ 最大值长度：256 个 Unicode 字符 (采用 UTF-8 格式)
+ 如果标签方案针对多个AWS服务和资源使用，请记得其它服务可能对允许使用的字符有限制。通常允许使用的字符包括可用 UTF-8 格式表示的字母、数字和空格，以及以下字符：\+ - = . \_ : / @。
+ 标签键和值区分大小写。
+ 请不要使用`aws:`、`AWS:`或此类拼写的任意大小写组合作为键或值的前缀，因为它将保留以供AWS使用。无法编辑或删除带此前缀的标签键或值。具有此前缀的标签不计入每个资源的标签数限制。

## 通过控制台使用标签
<a name="tag-resources-console"></a>

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

### 在创建时为单个资源添加标签
<a name="adding-tags-creation"></a>

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

### 为单个资源添加和删除标签
<a name="adding-or-deleting-tags"></a>

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

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

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

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

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

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

1. 在**标签**部分中，选择**管理标签**。

1. 根据需要添加或删除标签。
   + 若要添加标签，请选择**添加新标签**，然后填写**键**和**值**字段。
   + 要删除标签，请选择**删除**。

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

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

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

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

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

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

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

1. 根据需要添加或删除标签。
   + 若要添加标签，请选择**添加新标签**，然后填写**键**和**值**字段。
   + 要删除标签，请选择**删除**。

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

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

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

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

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

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

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

1. 根据需要添加或删除标签。
   + 若要添加标签，请选择**添加新标签**，然后填写**键**和**值**字段。
   + 要删除标签，请选择**删除**。

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

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

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

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

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

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

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

1. 根据需要添加或删除标签。
   + 若要添加标签，请选择**添加新标签**，然后填写**键**和**值**字段。
   + 要删除标签，请选择**删除**。

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

## 通过 API 使用标签
<a name="tag-resources-api-sdk"></a>

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


**给AWS WA Tool资源加标签支持**  

| 任务 | API 操作 | 
| --- | --- | 
| 添加或覆盖一个或多个标签。 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html) | 
| 删除一个或多个标签。 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html) | 
| 列出资源的标签。 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html) | 

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


| 任务 | API 操作 | 
| --- | --- | 
| 创建工作负载 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html) | 
| 导入新剖析 | [ImportLens](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ImportLens.html) | 
| 创建配置文件 | [CreateProfile](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateProfile.html) | 
| 创建审核模板 | [CreateReviewTemplate](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateReviewTemplate.html) |