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

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

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

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

リファレンス:

Amazon Q in Connect で定義されるアクション

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

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

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

注記

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

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

アクション 説明 アクセスレベル リソースタイプ (* 必須) 条件キー 依存アクション
ActivateMessageTemplate メッセージテンプレートをアクティブ化する許可を付与する 書き込み

KnowledgeBase*

MessageTemplate*

AllowVendedLogDeliveryForResource[アクセス許可のみ] アシスタント用の vended log 配信を設定する許可を付与する 権限の管理

Assistant

CreateAIAgent AI エージェントを作成する許可を付与する 書き込み

Assistant*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateAIAgentVersion AI エージェントバージョンを作成する許可を付与する 書き込み

AIAgent*

Assistant*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateAIGuardrail AI ガードレールを作成する許可を付与 書き込み

Assistant*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateAIGuardrailVersion AI ガードレールバージョンを作成する許可を付与 書き込み

AIGuardrail*

Assistant*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateAIPrompt AI プロンプトを作成する許可を付与する 書き込み

Assistant*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateAIPromptVersion AI プロンプトのバージョンを作成する許可を付与する 書き込み

AIPrompt*

Assistant*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateAssistant アシスタントを作成するためのアクセス許可を付与 書き込み

aws:TagKeys

aws:RequestTag/${TagKey}

CreateAssistantAssociation アシスタントと他のリソース間の関連付けを作成するためのアクセス許可を付与 書き込み

Assistant*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateContent コンテンツを作成するためのアクセス許可を付与 書き込み

KnowledgeBase*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateContentAssociation コンテンツの関連付けを作成する許可を付与する 書き込み

Content*

KnowledgeBase*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateKnowledgeBase ナレッジベースを作成するためのアクセス許可を付与 書き込み

aws:TagKeys

aws:RequestTag/${TagKey}

CreateMessageTemplate メッセージテンプレートを作成する許可を付与する 書き込み

KnowledgeBase*

aws:TagKeys

aws:RequestTag/${TagKey}

CreateMessageTemplateAttachment メッセージテンプレートに添付ファイルを作成する許可を付与する 書き込み

KnowledgeBase*

MessageTemplate*

CreateMessageTemplateVersion メッセージテンプレートのバージョンを作成する許可を付与する 書き込み

KnowledgeBase*

MessageTemplate*

CreateQuickResponse クイックレスポンスを作成するアクセス許可を付与 書き込み

aws:TagKeys

aws:RequestTag/${TagKey}

CreateSession セッションを作成するためのアクセス許可を付与 書き込み

aws:TagKeys

aws:RequestTag/${TagKey}

DeactivateMessageTemplate メッセージテンプレートを非アクティブ化する許可を付与する 書き込み

KnowledgeBase*

MessageTemplate*

DeleteAIAgent AI エージェントを削除する許可を付与する 書き込み

AIAgent*

Assistant*

DeleteAIAgentVersion AI エージェントのバージョンを削除する許可を付与する 書き込み

AIAgent*

Assistant*

DeleteAIGuardrail AI ガードレールを削除する許可を付与 書き込み

AIGuardrail*

Assistant*

DeleteAIGuardrailVersion AI ガードレールバージョンを削除する許可を付与 書き込み

AIGuardrail*

Assistant*

DeleteAIPrompt AI プロンプトを削除する許可を付与する 書き込み

AIPrompt*

Assistant*

DeleteAIPromptVersion AI プロンプトバージョンを削除する許可を付与する 書き込み

AIPrompt*

Assistant*

DeleteAssistant アシスタントを削除するためのアクセス許可を付与 書き込み

Assistant*

DeleteAssistantAssociation アシスタントの関連付けを削除するためのアクセス許可を付与 書き込み

Assistant*

AssistantAssociation*

DeleteContent コンテンツを削除するためのアクセス許可を付与 書き込み

Content*

KnowledgeBase*

DeleteContentAssociation コンテンツの関連付けを削除する許可を付与する 書き込み

Content*

ContentAssociation*

KnowledgeBase*

DeleteImportJob ナレッジベースのインポートジョブを削除するアクセス許可を付与 書き込み

KnowledgeBase*

DeleteKnowledgeBase ナレッジベースを削除するためのアクセス許可を付与 書き込み

KnowledgeBase*

DeleteMessageTemplate メッセージテンプレートを削除する許可を付与する 書き込み

KnowledgeBase*

MessageTemplate*

DeleteMessageTemplateAttachment メッセージテンプレートから添付ファイルを削除する許可を付与する 書き込み

KnowledgeBase*

MessageTemplate*

DeleteQuickResponse クイックレスポンスを削除するアクセス許可を付与 書き込み

KnowledgeBase*

QuickResponse*

GetAIAgent AI エージェントに関する情報を取得する許可を付与する 読み取り

AIAgent*

Assistant*

GetAIGuardrail AI ガードレールに関する情報を取得する許可を付与 読み取り

AIGuardrail*

Assistant*

GetAIPrompt プロンプトについての情報を取得する許可を付与する 読み取り

AIPrompt*

Assistant*

GetAssistant アシスタントに関する情報を取得するためのアクセス許可を付与 読み取り

Assistant*

GetAssistantAssociation アシスタントの関連付けに関する情報を取得するためにアクセス許可を付与 読み取り

Assistant*

AssistantAssociation*

GetContent コンテンツをダウンロードURLするための署名を含む、コンテンツを取得する許可を付与 読み取り

Content*

KnowledgeBase*

GetContentAssociation コンテントの関連付けに関する情報を取得する許可を付与する 読み取り

Content*

ContentAssociation*

KnowledgeBase*

GetContentSummary コンテンツの概要に関する情報を取得するためのアクセス許可を付与 読み取り

Content*

KnowledgeBase*

GetImportJob 特定のインポートジョブに関する情報を取得するアクセス許可を付与 読み取り

KnowledgeBase*

GetKnowledgeBase ナレッジベースに関する情報を取得するためのアクセス許可を付与 読み取り

KnowledgeBase*

GetMessageTemplate メッセージテンプレートを取得する許可を付与する 読み取り

KnowledgeBase*

MessageTemplate*

wisdom:MessageTemplate/RoutingProfileArn

GetNextMessage セッション内の次のメッセージを取得するためのアクセス許可を付与 読み取り

Assistant*

Session*

GetQuickResponse コンテンツを取得するアクセス許可を付与 読み取り

KnowledgeBase*

QuickResponse*

GetRecommendations 指定されたセッションについての推奨事項を取得するためのアクセス許可を付与 読み取り

Assistant*

GetSession 指定されたセッションの情報を取得するためのアクセス許可を付与 読み取り

Assistant*

Session*

ListAIAgentVersions AI エージェントのバージョンに関する情報を一覧表示する許可を付与する リスト

AIAgent*

Assistant*

ListAIAgents AI エージェントに関する情報を一覧表示する許可を付与する リスト

Assistant*

ListAIGuardrailVersions AI ガードレールのバージョンに関する情報を一覧表示する許可を付与 リスト

AIGuardrail*

Assistant*

ListAIGuardrails AI ガードレールに関する情報を一覧表示する許可を付与 リスト

Assistant*

ListAIPromptVersions AI プロンプトバージョンに関する情報を一覧表示する許可を付与する リスト

AIPrompt*

Assistant*

ListAIPrompts プロンプトに関する情報を一覧表示する許可を付与する リスト

Assistant*

ListAssistantAssociations アシスタントの関連付けに関する情報を一覧表示するためのアクセス許可を付与 リスト
ListAssistants アシスタントに関する情報を一覧表示するためのアクセス許可を付与 リスト
ListContentAssociations コンテンツの関連付けに関する情報を一覧表示する許可を付与する リスト

Content*

KnowledgeBase*

ListContents ナレッジベースのコンテンツを一覧表示するためのアクセス許可を付与 リスト

KnowledgeBase*

ListImportJobs ナレッジベースに関する情報を一覧表示するためのアクセス許可を付与 リスト

KnowledgeBase*

ListKnowledgeBases ナレッジベースに関する情報を一覧表示するためのアクセス許可を付与 リスト
ListMessageTemplateVersions 指定されたメッセージテンプレートのメッセージテンプレートバージョンを一覧表示する許可を付与する リスト

KnowledgeBase*

MessageTemplate*

ListMessageTemplates ナレッジベースのメッセージテンプレートを一覧表示する許可を付与する リスト

KnowledgeBase*

ListMessages セッション内のメッセージを一覧表示する許可を付与 リスト

Assistant*

Session*

ListQuickResponses クイックレスポンスをナレッジベースとともに一覧表示するアクセス許可を付与 リスト

KnowledgeBase*

ListTagsForResource 指定されたリソースのタグを一覧表示するためのアクセス許可を付与 読み取り
NotifyRecommendationsReceived 新しく利用可能になった推奨事項において、指定されたアシスタントのキューから、指定された推奨事項を削除するためのアクセス許可を付与 書き込み
PutFeedback フィードバックを送信する許可を付与 書き込み

Assistant*

QueryAssistant 指定されたアシスタントに対して手動検索を実行するためのアクセス許可を付与 読み取り

Assistant*

RemoveAssistantAIAgent アシスタントから AI エージェントを削除する許可を付与する 書き込み

Assistant*

RemoveKnowledgeBaseTemplateUri ナレッジベースからURIテンプレートを削除する許可を付与 書き込み

KnowledgeBase*

RenderMessageTemplate メッセージテンプレートをレンダリングする許可を付与する 読み取り

KnowledgeBase*

wisdom:GetMessageTemplate

MessageTemplate*

wisdom:MessageTemplate/RoutingProfileArn

SearchContent 指定されたナレッジベースを参照しながらコンテンツを検索するためのアクセス許可を付与 特定のコンテンツリソースを、その名前で取得する際に使用します。 読み取り

KnowledgeBase*

SearchMessageTemplates 指定されたナレッジベースを参照するメッセージテンプレートを検索する許可を付与する 読み取り

KnowledgeBase*

wisdom:SearchFilter/RoutingProfileArn

wisdom:SearchFilter/Qualifier

SearchQuickResponses 指定されたナレッジベースを参照しながらクイックレスポンスを検索するアクセス許可を付与 読み取り

KnowledgeBase*

wisdom:GetQuickResponse

wisdom:SearchFilter/RoutingProfileArn

SearchSessions 指定されたアシスタントを参照しながらセッションを検索するためのアクセス許可を付与 特定のセッションリソースを、その名前で取得する際に使用します。 読み取り
SendMessage メッセージを送信する許可を付与 書き込み

Assistant*

Session*

StartContentUpload ナレッジベースにコンテンツをアップロードURLするための を取得する許可を付与 書き込み

KnowledgeBase*

StartImportJob 複数のクイックレスポンスを作成するアクセス許可を付与 書き込み

KnowledgeBase*

aws:TagKeys

aws:RequestTag/${TagKey}

TagResource 指定されたタグを指定されたリソースに追加するためのアクセス許可を付与 Tagging

Assistant

AssistantAssociation

Content

ContentAssociation

KnowledgeBase

MessageTemplate

QuickResponse

Session

aws:TagKeys

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

UntagResource 指定されたリソースから指定されたタグを削除するためのアクセス許可を付与 Tagging

Assistant

AssistantAssociation

Content

ContentAssociation

KnowledgeBase

MessageTemplate

QuickResponse

Session

aws:TagKeys

aws:ResourceTag/${TagKey}

UpdateAIAgent AI エージェントに関する情報を更新する許可を付与する 書き込み

AIAgent*

Assistant*

UpdateAIGuardrail AI ガードレールに関する情報を更新する許可を付与 書き込み

AIGuardrail*

Assistant*

UpdateAIPrompt AI プロンプトに関する情報を更新する許可を付与する 書き込み

AIPrompt*

Assistant*

UpdateAssistantAIAgent AI エージェントに関するアシスタント情報を更新する許可を付与する 書き込み

Assistant*

UpdateContent コンテンツに関する情報を更新するためのアクセス許可を付与 書き込み

Content*

KnowledgeBase*

UpdateKnowledgeBaseTemplateUri URI ナレッジベースのテンプレートを更新する許可を付与 書き込み

KnowledgeBase*

UpdateMessageTemplate メッセージテンプレートの内容を更新する許可を付与する 書き込み

KnowledgeBase*

MessageTemplate*

UpdateMessageTemplateMetadata メッセージテンプレートのメタデータを更新する許可を付与する 書き込み

KnowledgeBase*

MessageTemplate*

UpdateQuickResponse クイックレスポンスのコンテンツに関する情報を更新するアクセス許可を付与 書き込み

KnowledgeBase*

QuickResponse*

UpdateSession セッションを更新する許可を付与する 書き込み

Assistant*

Session*

UpdateSessionData セッションに保存されたデータを更新する許可を付与する 書き込み

Assistant*

Session*

Amazon Q in Connect で定義されるリソースタイプ

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

リソースタイプ ARN 条件キー
AIAgent arn:${Partition}:wisdom:${Region}:${Account}:ai-agent/${AssistantId}/${AIAgentId}

aws:ResourceTag/${TagKey}

AIPrompt arn:${Partition}:wisdom:${Region}:${Account}:ai-prompt/${AssistantId}/${AIPromptId}

aws:ResourceTag/${TagKey}

AIGuardrail arn:${Partition}:wisdom:${Region}:${Account}:ai-guardrail/${AssistantId}/${AIGuardrailId}

aws:ResourceTag/${TagKey}

Assistant arn:${Partition}:wisdom:${Region}:${Account}:assistant/${AssistantId}

aws:ResourceTag/${TagKey}

AssistantAssociation arn:${Partition}:wisdom:${Region}:${Account}:association/${AssistantId}/${AssistantAssociationId}

aws:ResourceTag/${TagKey}

Content arn:${Partition}:wisdom:${Region}:${Account}:content/${KnowledgeBaseId}/${ContentId}

aws:ResourceTag/${TagKey}

ContentAssociation arn:${Partition}:wisdom:${Region}:${Account}:content-association/${KnowledgeBaseId}/${ContentId}/${ContentAssociationId}

aws:ResourceTag/${TagKey}

KnowledgeBase arn:${Partition}:wisdom:${Region}:${Account}:knowledge-base/${KnowledgeBaseId}

aws:ResourceTag/${TagKey}

MessageTemplate arn:${Partition}:wisdom:${Region}:${Account}:message-template/${KnowledgeBaseId}/${MessageTemplateId}

aws:ResourceTag/${TagKey}

wisdom:MessageTemplate/RoutingProfileArn

Session arn:${Partition}:wisdom:${Region}:${Account}:session/${AssistantId}/${SessionId}

aws:ResourceTag/${TagKey}

QuickResponse arn:${Partition}:wisdom:${Region}:${Account}:quick-response/${KnowledgeBaseId}/${QuickResponseId}

aws:ResourceTag/${TagKey}

Amazon Q in Connect の条件キー

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

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

条件キー 説明 タイプ
aws:RequestTag/${TagKey} リクエストで渡されたタグでアクセスをフィルタリングします 文字列
aws:ResourceTag/${TagKey} リソースに関連付けられたタグでアクセスをフィルタリングします 文字列
aws:TagKeys リクエストで渡されたタグキーでアクセスをフィルタリングします ArrayOfString
wisdom:MessageTemplate/RoutingProfileArn リソースに関連付けられた接続ルーティングプロファイルの ARN によってアクセスをフィルタリングする ArrayOfARN
wisdom:SearchFilter/Qualifier リクエストで渡された修飾子によってアクセスをフィルタリングする ArrayOfString
wisdom:SearchFilter/RoutingProfileArn リクエストで渡された接続ルーティングプロファイルの ARN でアクセスをフィルタリングします ARN