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

# 为 Amazon Connect 中的资源添加标签
<a name="tagging"></a>

标签是一种自定义元数据标签，您可以将其添加到资源中，以便更轻松地在搜索中识别、整理和查找。标签由两个独立部分组成：标签键和标签值。这被称为*键值*对。

*标签键*通常表示较大的类别，而标签值则表示该类别的子集。例如，您可能拥有*标签键=颜色*和*标签值=蓝色*，这样将生成键值对 `Color:Blue`。请注意，您可以将标签的值设为空的字符串，但是不能将其设为空值。省略标签值与使用空字符串效果相同。



标签键的长度最大可以为 128 个字符，标签值的长度最大可以为 256 个字符；两者均区分大小写。有关更多信息，请参阅:
+  [Amazon Connect TagResource](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagResource.html)
+  [Amazon Connect Customer Profiles TagResource](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_TagResource.html) 
+  [Amazon Connect 语音 ID TagResource](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_TagResource.html)：您可以向语音识别域添加标签。
+  [Amazon AppIntegrationsTagResource](https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_TagResource.html) 

Amazon Connect 服务每个资源最多支持 50 个标签。对于给定资源，每个标签键必须是唯一的，只有一个值。

**注意**  
您的标签不能以开头，`aws:`因为系统生成的标签 AWS 保留了此前缀。您无法添加、修改或删除`aws:*`标签，它们也不会计入您的 tags-per-resource限制。

下表描述了可以使用 AWS CLI 或 AWS 软件开发工具包标记的 Amazon Connect 资源。


**Amazon Connect 资源的标记支持**  

| 资源 | 支持使用 Amazon Connect 管理员网站进行标记 | 支持使用 CLI/开发工具包进行标记 | 支持在创建时标记 | 
| --- | --- | --- | --- | 
|  座席  |  支持  |  是  |  是  | 
|  座席组  |  否  | 是 |  是  | 
|  座席组级别  |  否  | 否 |  是  | 
|  座席状态  |  否  |  是  |  是  | 
|  案例  |  支持  |  是  |  是  | 
|  联系人  |  否  |  否  |  否  | 
|  联系人评估  |  否  |  是  |  是  | 
|  电子邮件地址  |  支持  |  是  |  是  | 
|  评估表  |  支持  |  是  |  是  | 
|  流  |  支持  |  是  |  是  | 
|  流模块  |  支持  | 是 |  是  | 
|  营业时间  |  支持  | 是 |  是  | 
|  实例  | 是 | 是 |  是  | 
|  集成关联  |  否  | 是 |  是  | 
|  出站活动  |  否  | 是 |  是  | 
| Phone number（电话号码） | 否 | 是 |  是  | 
|  提示  |  支持  | 是 |  是  | 
|  队列座席  |  否  |  否  |  是  | 
|  队列  |  支持  | 是 |  是  | 
|  快速连接  |  否  | 是 |  是  | 
|  路由配置文件  |  支持  |  是  |  是  | 
|  安全配置文件  |  支持  |  是  |  是  | 
| 任务模板 | 否 | 否 |  是  | 
| 流量分配组 | 否 | 是 |  是  | 
|  转接目标  |  否  |  是  |  是  | 
|  应用场景  |  否  |  是  |  是  | 
|  词汇  |  否  | 是 |  是  | 

要了解有关标签的更多信息，包括最佳实践，请参阅*AWS 一般*参考中的[标记 AWS 资源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。

## 仅当删除 Amazon Connect 实例后，才会移除标签元数据
<a name="tag-retention"></a>

即使删除了资源，Amazon Connect 也会保留资源的标签元数据。只要 Amazon Connect 实例处于活动状态，就会保留元数据。

此设计支持历史报告和访问控制（TBAC）使用案例。具体而言，Amazon Connect 对历史指标使用基于标签的访问控制。如果在删除资源时立即移除了标签，则以前无法访问这些资源的用户可能会无意中获得对涉及这些资源的历史指标的访问权限。保留标签可确保访问边界随着时间的推移保持一致。

只有在删除整个 Amazon Connect 实例之后，才会移除标签，此时历史数据访问权限不再适用。

## 基于标签的访问控制
<a name="tagging-access-control"></a>

要使用标签控制对 AWS 账户内资源的访问权限，您需要在 IAM 策略的条件元素中提供标签信息。例如，要根据您分配给 Voice ID 域的标签来控制对 Voice ID 域的访问权限，请使用 `aws:ResourceTag/key-name` 条件键指定必须将哪个标签键值对附加到该域，以便允许对其执行给定操作。

有关 Amazon Connect 控制台中基于标签的访问控制的更多详细信息，请参阅[在 Amazon Connect 中应用基于标签的访问控制](tag-based-access-control.md)。

有关 IAM 中基于标签的访问控制的更多详细信息，请参阅 IA *M 用户*指南中的[使用标签控制对 AWS 资源的访问权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)