

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Lex V2 でのリソースのタグ付け
<a name="tagging"></a>

Amazon Lex V2 ボットとボットエイリアスを管理しやすくするために、各リソースにメタデータを *タグ* として割り当てることができます。タグとは、AWS リソースに付けるラベルです。各タグは、キー と 値 から構成されます。

タグを使用すると、AWS リソースを目的、所有者、アプリケーションなどさまざまな方法で分類することができます。タグを使用すると、次のことができます。
+ AWS リソースの特定と整理。多くの AWS リソースはタグ付けをサポートしているため、異なるサービスのリソースに同じタグを割り当てて、リソースが同じであることを示すことができます。例えば、ボットとボットが使用する Lambda 関数に同じタグを付けることができます。
+ コストの割り当て。AWS Billing and Cost Managementダッシュボードでタグをアクティブ化します。AWS はタグを使用してコストを分類し、月単位のコスト配分レポートを提供します。Amazon Lex V2 では、エイリアスに固有のタグを使用して、エイリアスごとにコストを割り当てることができます。詳細については、「*AWS Billing and Cost Management* ユーザーガイド」の「[コスト配分タグを使用する](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、API を使用して 200 です。
+ キーの最大長 - 128 文字
+ 値の最大長 - 256 文字
+ キーと値の有効な文字 – a～z、A～Z、0～9、スペース、および特殊文字 (\$1 . : / = \$1 - @)
+ キーと値は大文字と小文字が区別されます
+ キーのプレフィックス`aws:`として を使用しないでください。AWS 用に予約されています。

# リソースのタグ付け (コンソール)
<a name="tags-console"></a>

コンソールを使用して、ボットまたはボットエイリアスのタグを管理できます。リソースの作成時にタグを追加することも、既存のリソースからタグを追加、変更、または削除することもできます。

**ボットの作成時にタグを追加するには**

1. AWS マネジメントコンソールにサインインし、[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) で Amazon Lex コンソールを開きます。

1. [**ボットの作成**] を選択します。

1. [**詳細設定**] の [**ボットの設定**] セクションで、[**新しいタグを追加**] を選択します。ボットと `TestBotAlias` エイリアスにタグを追加できます。

1. [**次へ**] を選択し、ボットの作成を続行します。

**ボットエイリアスの作成時にタグを追加するには**

1. AWS マネジメントコンソールにサインインし、[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) で Amazon Lex コンソールを開きます。

1. ボットエイリアスを追加するボットを選択します。

1. 左側のメニューから、[**エイリアス**] を選択し、**[エイリアスの作成]** を選択します。

1. [**一般的な情報**] で、[**タグ**] から [**新しいタグを追加**] を選択します。

1. **[作成]** を選択します。

**既存のボットのタグを追加、削除、または変更するには**

1. AWS マネジメントコンソールにサインインし、[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) で Amazon Lex コンソールを開きます。

1. 変更するボットを選択します。

1. 左側のメニューから [**設定**] を選択し、[**編集**] を選択します。

1. [**タグ**] で、変更を実施します。

1. [**保存**] を選択して、ボットに加えた変更を保存します。

**既存のエイリアスのタグを追加、削除、または変更するには、**

1. AWS マネジメントコンソールにサインインし、[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) で Amazon Lex コンソールを開きます。

1. 変更するボットを選択します。

1. 左側のメニューから、[**エイリアス**] を選択します。エイリアスのリストから、変更するエイリアスを選択します。

1. [**エイリアスの詳細**] の [**タグ**] で、[**タグを変更する**] を選択します。

1. [**タグの管理**] で、変更を実施します。

1. [**保存**] を選択して、エイリアスに加えた変更を保存します。