Amazon Lex のアクション、リソース、および条件キー - サービス認証リファレンス

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

Amazon Lex のアクション、リソース、および条件キー

Amazon Lex (サービスプレフィックス: lex) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。

参照:

Amazon Lex で定義されるアクション

IAM ポリシーステートメントの Action 要素では、以下のアクションを指定できます。ポリシーを使用して、AWS でオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

[リソースタイプ] 列は、各アクションがリソースレベルのアクセス許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素ですべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。必須リソースは、アスタリスク (*) でテーブルに示されています。このアクションを使用してステートメントでリソースレベルのアクセス許可 ARN を指定する場合、このタイプである必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、一方を使用することはできますが、他方を使用することはできません。

以下の表の列の詳細については、「アクションテーブル」を参照してください。

アクション 説明 アクセスレベル リソースタイプ (* 必須) 条件キー 依存アクション
CreateBotVersion 指定されたボットの $LATEST バージョンに基づいて新しいバージョンを作成します。 書き込み

bot version*

CreateIntentVersion 指定されたインテントの $LATEST バージョンに基づいて新しいバージョンを作成します。 書き込み

intent version*

CreateSlotTypeVersion 指定されたスロットタイプの $LATEST バージョンに基づいて新しいバージョンを作成します。 書き込み

slottype version*

DeleteBot ボットのすべてのバージョンを削除します。 書き込み

bot version*

DeleteBotAlias 指定されたボットのエイリアスを削除します。 書き込み

bot alias*

DeleteBotChannelAssociation Amazon Lex ボットとメッセージングプラットフォームの間の関連付けを削除します。 書き込み

channel*

DeleteBotVersion 指定されたバージョンのボットを削除します。 書き込み

bot version*

DeleteIntent インテントのすべてのバージョンを削除します。 書き込み

intent version*

DeleteIntentVersion 指定されたバージョンのインテントを削除します。 書き込み

intent version*

DeleteSession 指定されたボット、エイリアス、ユーザー ID のセッション情報を削除します。 書き込み

bot alias

bot version

DeleteSlotType スロットタイプのすべてのバージョンを削除します。 書き込み

slottype version*

DeleteSlotTypeVersion 指定されたバージョンのスロットタイプを削除します。 書き込み

slottype version*

DeleteUtterances Amazon Lex で特定のボットおよび userId における発話のために維持される情報を削除します。 書き込み

bot version*

GetBot 特定のボットの情報を返します。ボット名の他に、ボットバージョンまたはエイリアスが必要です。 Read

bot alias

bot version

GetBotAlias Amazon Lex ボットエイリアスに関する情報を返します。 Read

bot alias*

GetBotAliases 特定の Amazon Lex ボットのエイリアスのリストを返します。 リスト
GetBotChannelAssociation Amazon Lex ボットとメッセージングプラットフォームの間の関連付けに関する情報を返します。 Read

channel*

GetBotChannelAssociations 1 つのボットに関連付けられているすべてのチャネルのリストを返します。 リスト

channel*

GetBotVersions 特定のボットのすべてのバージョンの情報を返します。 リスト

bot version*

GetBots すべてのボットの $LATEST バージョンについて、クライアントから提供されたフィルターに従って情報を返します。 リスト
GetBuiltinIntent 組み込みインテントに関する情報を返します。 Read
GetBuiltinIntents 指定された基準を満たす組み込みインテントのリストを取得します。 Read
GetBuiltinSlotTypes 指定された基準を満たす組み込みスロットタイプのリストを取得します。 Read
GetExport Amazon Lex リソースをリクエストされた形式でエクスポートします。 Read

bot version*

GetImport StartImport で開始されたインポートジョブに関する情報を取得します。 Read
GetIntent 特定のインテントの情報を返します。インテント名に加えて、インテントバージョンも指定する必要があります。 Read

intent version*

GetIntentVersions 特定のインテントのすべてのバージョンの情報を返します。 リスト

intent version*

GetIntents すべてのインテントの $LATEST バージョンについて、クライアントから提供されたフィルターに従って情報を返します。 リスト
GetSession 指定されたボット、エイリアス、ユーザー ID のセッション情報を返します。 Read

bot alias

bot version

GetSlotType スロットタイプの特定のバージョンに関する情報を返します。スロットタイプ名に加えて、スロットタイプバージョンも指定する必要があります。 Read

slottype version*

GetSlotTypeVersions 特定のスロットタイプのすべてのバージョンの情報を返します。 リスト

slottype version*

GetSlotTypes すべてのスロットタイプの $LATEST バージョンについて、クライアントから提供されたフィルターに従って情報を返します。 リスト
GetUtterancesView ボットのバージョンについて、最近の期間における発話の集計データを表示します。 リスト

bot version*

ListTagsForResource Lex リソースのタグを一覧表示します。 Read

bot

bot alias

channel

PostContent ユーザー入力 (テキストまたは音声) を Amazon Lex に送信します。 書き込み

bot alias

bot version

PostText ユーザー入力 (テキストのみ) を Amazon Lex に送信します。 書き込み

bot alias

bot version

PutBot Amazon Lex 会話ボットの $LATEST バージョンを作成または更新します。 書き込み

bot version*

aws:TagKeys

aws:RequestTag/${TagKey}

PutBotAlias 特定のボットのエイリアスを作成または更新します。 書き込み

bot alias*

aws:TagKeys

aws:RequestTag/${TagKey}

PutIntent インテントの $LATEST バージョンを作成または更新します。 書き込み

intent version*

PutSession Amazon Lex ボットで新しいセッションを作成するか、既存のセッションを変更します。 書き込み

bot alias

bot version

PutSlotType スロットタイプの $LATEST バージョンを作成または更新します。 書き込み

slottype version*

StartImport リソースを Amazon Lex にインポートするジョブを開始します。 書き込み
TagResource Lex リソースにタグを追加または上書きします。 タグ付け

bot

bot alias

channel

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource Lex リソースからタグを削除します。 タグ付け

bot

bot alias

channel

aws:TagKeys

aws:RequestTag/${TagKey}

Amazon Lex で定義されるリソースタイプ

以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource 要素で使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。

リソースタイプ ARN 条件キー
bot arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}

aws:ResourceTag/${TagKey}

bot version arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotVersion}

aws:ResourceTag/${TagKey}

bot alias arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotAlias}

aws:ResourceTag/${TagKey}

channel arn:${Partition}:lex:${Region}:${Account}:bot-channel:${BotName}:${BotAlias}:${ChannelName}

aws:ResourceTag/${TagKey}

intent version arn:${Partition}:lex:${Region}:${Account}:intent:${IntentName}:${IntentVersion}
slottype version arn:${Partition}:lex:${Region}:${Account}:slottype:${SlotName}:${SlotVersion}

Amazon Lex の条件キー

Amazon Lex では、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。

すべてのサービスで使用できるグローバル条件キーを確認するには、使用できるグローバル条件キーを参照してください。

条件キー 説明 タイプ
aws:RequestTag/${TagKey} リクエスト内のタグに基づいてアクセスをフィルタリングします。 文字列
aws:ResourceTag/${TagKey} Lex リソースにアタッチされたタグでアクセスをフィルタリングします。 文字列
aws:TagKeys リクエスト内のタグキーのセットに基づいてアクセスをフィルタリングします。 文字列
lex:associatedIntents ユーザーに対し、リクエストに含まれるインテントに基づいたアクセスの制御を可能にします。 文字列
lex:associatedSlotTypes ユーザーに対し、リクエストに含まれるスロットタイプに基づいたアクセスの制御を可能にします。 文字列
lex:channelType ユーザーに対し、リクエストに含まれるチャネルタイプに基づいたアクセスの制御を可能にします。 文字列