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

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

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

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

リファレンス:

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

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

[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれている場合は、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource要素を使用してリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN または パターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。

[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。

注記

リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。

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

アクション 説明 アクセスレベル リソースタイプ (* 必須) 条件キー 依存アクション
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 特定のボットの情報を返します。ボット名の他に、ボットバージョンまたはエイリアスが必要です 読み込み

bot alias

bot version

GetBotAlias Amazon Lex ボットエイリアスの情報を返します 読み込み

bot alias*

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

channel*

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

channel*

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

bot version*

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

bot version*

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

intent version*

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

intent version*

GetIntents クライアントが提供するフィルターに従って、すべてのインテントの $LATEST バージョンの情報を返します。 リスト
GetMigration 進行中または完了した移行を表示する許可を付与 読み込み
GetMigrations Amazon Lex v1 から Amazon Lex v2 への移行のリストを表示する許可を付与 リスト
GetSession 指定されたボット、エイリアス、ユーザー ID のセッション情報を返します 読み込み

bot alias

bot version

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

slottype version*

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

slottype version*

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

bot version*

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

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 にインポートするジョブを開始します 書き込み
StartMigration Amazon レックス v1 から Amazon Lex v2 にボットを移行する許可を付与 書き込み

bot version*

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 リクエスト内のタグキーのセットに基づいてアクセスをフィルタリングします ArrayOfString
lex:associatedIntents ユーザーに対し、リクエストに含まれるインテントに基づいたアクセスの制御を可能にします ArrayOfString
lex:associatedSlotTypes ユーザーに対し、リクエストに含まれるスロットタイプに基づいたアクセスの制御を可能にします ArrayOfString
lex:channelType ユーザーに対し、リクエストに含まれるチャネルタイプに基づいたアクセスの制御を可能にします 文字列