

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

# 在 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 使用的