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

# 在 Lex V2 中标记资源
<a name="tagging"></a>

为了帮助您管理 Amazon Lex V2 机器人以及机器人别名，您可以将元数据作为*标签*分配给每个资源。标签是分配给 Amazon Web Services 资源的一种标记。每个标签均包含一个键和一个值。

标签可让您按各种标准（例如用途、所有者或应用程序）对 AWS 资源进行分类。标签帮助您：
+ 识别和整理您的 AWS 资源。许多 AWS 资源都支持标记，因此您可以为不同服务中的资源分配相同的标签，以表明资源相同。例如，您可以使用相同标签标记机器人及其使用的 Lambda 函数。
+ 分配成本。您可以在AWS 账单与成本管理控制面板上激活标签。AWS 使用标签对您的成本进行分类，并向您提供每月成本分配报告。对于 Amazon Lex V2，您可以通过别名特定的标签为每个别名分配成本。有关更多信息，请参阅 *AWS 账单与成本管理 用户指南*中的[使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。
+ 控制对资源的访问。您可以在 Amazon Lex V2 中使用标签创建策略来控制对 Amazon Lex V2 资源的访问权限。这些策略可以附加到 IAM 角色或用户，以启用基于标签的访问控制。

您可以使用 AWS 管理控制台AWS Command Line Interface、或 Amazon Lex V2 API 来处理标签。

## 使用控制台或 API 标记资源
<a name="tagging-resources"></a>

如果您使用的是 Amazon Lex V2 控制台，则可以在创建资源时标记资源，也可以稍后添加标记。您还可以使用控制台来更新或删除现有标签。

如果您使用的是 AWS CLI 或 Amazon Lex V2 API，则可以使用以下操作来管理资源的标签：
+ [CreateBot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBot.html) 和 [CreateBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotAlias.html) — 在创建机器人或机器人别名时应用标签。
+ [ListTagsForResource](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListTagsForResource.html) — 查看与资源关联的标签。
+ [TagResource](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_TagResource.html) — 添加和修改现有资源上的标签。
+ [UntagResource](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UntagResource.html) — 从资源中删除标签。

Amazon Lex V2 中支持贴标签的资源如下：
+ 机器人：使用如下所示的 Amazon 资源名称（ARN）：
  + `arn:aws:lex:${Region}:${account}:bot/${bot-id}`
+ 机器人别名：使用如下所示的 ARN：
  + `arn:aws:lex:${Region}:${account}:bot-alias/${bot-id}/${bot-alias-id}`

`bot-id` 和 `bot-alias-id` 取值均是由 10 个大写字母和数字组成的字符串。

## 使用 Lex V2 时的标签限制
<a name="tagging-restrictions"></a>

以下基本限制适用于 Amazon Lex V2 资源上的标签：
+ 最大密钥数量：50 个使用控制台，200 个使用 API
+ 最大键长度：128 个字符
+ 最大值长度：256 个字符
+ 键和值的有效字符：a-z、A-Z、0-9、空格和以下字符：\$1 . : / = \$1 - @
+ 键和值区分大小写
+ 不要`aws:`用作密钥的前缀，它是保留给 AWS 使用的

# 标记资源（控制台）
<a name="tags-console"></a>

您可以通过控制台管理机器人或机器人别名上的标签。您可以在创建资源时添加标签，也可以从现有资源中添加、修改或删除标签。

**在创建机器人时添加标签**

1. 登录 AWS 管理控制台，然后在以下网址打开 Amazon Lex 控制台[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)。

1. 选择**创建机器人**。

1. 在**配置机器人设置**的**高级设置**部分，选择**添加新标签**。您可以为机器人和 `TestBotAlias` 别名添加标签。

1. 选择**下一步**，继续创建您的机器人。

**在创建机器人别名时添加标签**

1. 登录 AWS 管理控制台，然后在以下网址打开 Amazon Lex 控制台[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)。

1. 选择想要为其添加机器人别名的机器人。

1. 在左侧菜单中，选择**别名** > **创建别名**。

1. 在**一般信息**中，从**标签**中选择**添加新标签**。

1. 选择**创建**。

**添加、删除或修改现有机器人上的标签**

1. 登录 AWS 管理控制台，然后在以下网址打开 Amazon Lex 控制台[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)。

1. 选择想要修改的机器人。

1. 在左侧菜单中，选择**设置** > **编辑**。

1. 在**标签**中，进行更改。

1. 选择**保存**来保存对机器人的更改。

**添加、删除或修改现有别名上的标签**

1. 登录 AWS 管理控制台，然后在以下网址打开 Amazon Lex 控制台[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)。

1. 选择想要修改的机器人。

1. 在左侧菜单中，选择**别名**，然后从别名列表中选择要修改的别名。

1. 在**别名详细信息**上的**标签**中，选择**修改标签**。

1. 在**管理标签**中，进行更改。

1. 选择**保存**，来保存对别名的更改。