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

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

リファレンス:

このサービスを設定する方法について説明します。
このサービスで使用可能な API オペレーションのリストを表示します。
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。

トピック

Amazon Q in Connect で定義されるアクション
Amazon Q in Connect で定義されるリソースタイプ
Amazon Q in Connect の条件キー

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

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

Actions テーブルのアクセスレベル列は、アクションの分類方法 (List、Read、Permissions Management、Tagging) を示しています。このように分類することで、ポリシーで使用する際にアクションで付与するアクセスレベルを理解しやすくなります。アクセスレベルの詳細については、ポリシー概要の「アクセスレベル」を参照してください。

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

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

Actions テーブルの Dependent actions 列には、アクションを正常に呼び出すために必要な追加のアクセス許可が表示されます。これらのアクセス許可は、アクション自体のアクセス許可に加えて必要になる場合があります。アクションが依存アクションを指定すると、それらの依存関係は、テーブルにリストされている最初のリソースだけでなく、そのアクションに定義された追加のリソースに適用される場合があります。

注記

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

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

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー	依存アクション
ActivateMessageTemplate	メッセージテンプレートをアクティブ化する許可を付与する	書き込み	KnowledgeBase*
ActivateMessageTemplate	メッセージテンプレートをアクティブ化する許可を付与する	書き込み	MessageTemplate*
AllowVendedLogDeliveryForResource [アクセス許可のみ]	アシスタント用の vended log 配信を設定する許可を付与する	権限の管理	Assistant
CreateAIAgent	AI エージェントを作成する許可を付与する	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIAgentVersion	AI エージェントバージョンを作成する許可を付与する	書き込み	AIAgent*
CreateAIAgentVersion	AI エージェントバージョンを作成する許可を付与する	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIGuardrail	ai ガードレールを作成するアクセス許可を付与します	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIGuardrailVersion	ai ガードレールバージョンを作成するアクセス許可を付与します	書き込み	AIGuardrail*
CreateAIGuardrailVersion	ai ガードレールバージョンを作成するアクセス許可を付与します	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIPrompt	AI プロンプトを作成する許可を付与する	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIPromptVersion	AI プロンプトのバージョンを作成する許可を付与する	書き込み	AIPrompt*
CreateAIPromptVersion	AI プロンプトのバージョンを作成する許可を付与する	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateAssistant	アシスタントを作成するためのアクセス許可を付与	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateAssistantAssociation	アシスタントと他のリソース間の関連付けを作成するためのアクセス許可を付与	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateContent	コンテンツを作成するためのアクセス許可を付与	書き込み	KnowledgeBase*
CreateContent	コンテンツを作成するためのアクセス許可を付与	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateContentAssociation	コンテンツの関連付けを作成する許可を付与する	書き込み	Content*
			KnowledgeBase*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateKnowledgeBase	ナレッジベースを作成するためのアクセス許可を付与	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateMessageTemplate	メッセージテンプレートを作成する許可を付与する	書き込み	KnowledgeBase*
CreateMessageTemplate	メッセージテンプレートを作成する許可を付与する	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateMessageTemplateAttachment	メッセージテンプレートに添付ファイルを作成する許可を付与する	書き込み	KnowledgeBase*
CreateMessageTemplateAttachment	メッセージテンプレートに添付ファイルを作成する許可を付与する	書き込み	MessageTemplate*
CreateMessageTemplateVersion	メッセージテンプレートのバージョンを作成する許可を付与する	書き込み	KnowledgeBase*
CreateMessageTemplateVersion	メッセージテンプレートのバージョンを作成する許可を付与する	書き込み	MessageTemplate*
CreateQuickResponse	クイックレスポンスを作成するアクセス許可を付与	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
CreateSession	セッションを作成するためのアクセス許可を付与	書き込み		aws:TagKeys aws:RequestTag/${TagKey}
DeactivateMessageTemplate	メッセージテンプレートを非アクティブ化する許可を付与する	書き込み	KnowledgeBase*
DeactivateMessageTemplate	メッセージテンプレートを非アクティブ化する許可を付与する	書き込み	MessageTemplate*
DeleteAIAgent	AI エージェントを削除する許可を付与する	書き込み	AIAgent*
DeleteAIAgentVersion	AI エージェントのバージョンを削除する許可を付与する	書き込み	AIAgent*
DeleteAIGuardrail	ai ガードレールを削除するアクセス許可を付与します	書き込み	AIGuardrail*
DeleteAIGuardrailVersion	ai ガードレールバージョンを削除するアクセス許可を付与します	書き込み	AIGuardrail*
DeleteAIPrompt	AI プロンプトを削除する許可を付与する	書き込み	AIPrompt*
DeleteAIPromptVersion	AI プロンプトバージョンを削除する許可を付与する	書き込み	AIPrompt*
DeleteAssistant	アシスタントを削除するためのアクセス許可を付与	書き込み	Assistant*
DeleteAssistantAssociation	アシスタントの関連付けを削除するためのアクセス許可を付与	書き込み	AssistantAssociation*
DeleteContent	コンテンツを削除するためのアクセス許可を付与	書き込み	Content*
DeleteContent	コンテンツを削除するためのアクセス許可を付与	書き込み	KnowledgeBase*
DeleteContentAssociation	コンテンツの関連付けを削除する許可を付与する	書き込み	Content*
			ContentAssociation*
			KnowledgeBase*
DeleteImportJob	ナレッジベースのインポートジョブを削除するアクセス許可を付与	書き込み	KnowledgeBase*
DeleteKnowledgeBase	ナレッジベースを削除するためのアクセス許可を付与	書き込み	KnowledgeBase*
DeleteMessageTemplate	メッセージテンプレートを削除する許可を付与する	書き込み	KnowledgeBase*
DeleteMessageTemplate	メッセージテンプレートを削除する許可を付与する	書き込み	MessageTemplate*
DeleteMessageTemplateAttachment	メッセージテンプレートから添付ファイルを削除する許可を付与する	書き込み	KnowledgeBase*
DeleteMessageTemplateAttachment	メッセージテンプレートから添付ファイルを削除する許可を付与する	書き込み	MessageTemplate*
DeleteQuickResponse	クイックレスポンスを削除するアクセス許可を付与	書き込み	KnowledgeBase*
DeleteQuickResponse	クイックレスポンスを削除するアクセス許可を付与	書き込み	QuickResponse*
GetAIAgent	AI エージェントに関する情報を取得する許可を付与する	読み取り	AIAgent*
GetAIGuardrail	ai ガードレールに関する情報を取得するアクセス許可を付与します	読み取り	AIGuardrail*
GetAIPrompt	プロンプトについての情報を取得する許可を付与する	読み取り	AIPrompt*
GetAssistant	アシスタントに関する情報を取得するためのアクセス許可を付与	読み取り	Assistant*
GetAssistantAssociation	アシスタントの関連付けに関する情報を取得するためにアクセス許可を付与	読み取り	AssistantAssociation*
GetContent	コンテンツ (コンテンツをダウンロードするための署名付き URL を含む) を取得するためのアクセス許可を付与	読み取り	Content*
GetContent	コンテンツ (コンテンツをダウンロードするための署名付き URL を含む) を取得するためのアクセス許可を付与	読み取り	KnowledgeBase*
GetContentAssociation	コンテントの関連付けに関する情報を取得する許可を付与する	読み取り	Content*
			ContentAssociation*
			KnowledgeBase*
GetContentSummary	コンテンツの概要に関する情報を取得するためのアクセス許可を付与	読み取り	Content*
GetContentSummary	コンテンツの概要に関する情報を取得するためのアクセス許可を付与	読み取り	KnowledgeBase*
GetImportJob	特定のインポートジョブに関する情報を取得するアクセス許可を付与	読み取り	KnowledgeBase*
GetKnowledgeBase	ナレッジベースに関する情報を取得するためのアクセス許可を付与	読み取り	KnowledgeBase*
GetMessageTemplate	メッセージテンプレートを取得する許可を付与する	読み取り	KnowledgeBase*
			MessageTemplate*
				wisdom:MessageTemplate/RoutingProfileArn
GetNextMessage	セッション内の次のメッセージを取得するためのアクセス許可を付与します	読み取り	Session*
GetQuickResponse	コンテンツを取得するアクセス許可を付与	読み取り	KnowledgeBase*
GetQuickResponse	コンテンツを取得するアクセス許可を付与	読み取り	QuickResponse*
GetRecommendations	指定されたセッションについての推奨事項を取得するためのアクセス許可を付与	読み取り	Session*
GetSession	指定されたセッションの情報を取得するためのアクセス許可を付与	読み取り	Session*
ListAIAgentVersions	AI エージェントのバージョンに関する情報を一覧表示する許可を付与する	リスト	AIAgent*
ListAIAgents	AI エージェントに関する情報を一覧表示する許可を付与する	リスト
ListAIGuardrailVersions	ai ガードレールバージョンに関する情報を一覧表示するアクセス許可を付与します	リスト	AIGuardrail*
ListAIGuardrails	ai ガードレールに関する情報を一覧表示するアクセス許可を付与します	リスト
ListAIPromptVersions	AI プロンプトバージョンに関する情報を一覧表示する許可を付与する	リスト	AIPrompt*
ListAIPrompts	プロンプトに関する情報を一覧表示する許可を付与する	リスト
ListAssistantAssociations	アシスタントの関連付けに関する情報を一覧表示するためのアクセス許可を付与	リスト
ListAssistants	アシスタントに関する情報を一覧表示するためのアクセス許可を付与	リスト
ListContentAssociations	コンテンツの関連付けに関する情報を一覧表示する許可を付与する	リスト	Content*
ListContentAssociations	コンテンツの関連付けに関する情報を一覧表示する許可を付与する	リスト	KnowledgeBase*
ListContents	ナレッジベースのコンテンツを一覧表示するためのアクセス許可を付与	リスト	KnowledgeBase*
ListImportJobs	ナレッジベースに関する情報を一覧表示するためのアクセス許可を付与	リスト	KnowledgeBase*
ListKnowledgeBases	ナレッジベースに関する情報を一覧表示するためのアクセス許可を付与	リスト
ListMessageTemplateVersions	指定されたメッセージテンプレートのメッセージテンプレートバージョンを一覧表示する許可を付与する	リスト	KnowledgeBase*
ListMessageTemplateVersions	指定されたメッセージテンプレートのメッセージテンプレートバージョンを一覧表示する許可を付与する	リスト	MessageTemplate*
ListMessageTemplates	ナレッジベースのメッセージテンプレートを一覧表示する許可を付与する	リスト	KnowledgeBase*
ListMessages	セッション内のメッセージを一覧表示するアクセス許可を付与します	リスト	Session*
ListQuickResponses	クイックレスポンスをナレッジベースとともに一覧表示するアクセス許可を付与	リスト	KnowledgeBase*
ListTagsForResource	指定されたリソースのタグを一覧表示するためのアクセス許可を付与	読み取り
NotifyRecommendationsReceived	新しく利用可能になった推奨事項において、指定されたアシスタントのキューから、指定された推奨事項を削除するためのアクセス許可を付与	書き込み	Session*
PutFeedback	フィードバックを送信する許可を付与	書き込み	Assistant*
QueryAssistant	指定されたアシスタントに対して手動検索を実行するためのアクセス許可を付与	読み取り	Assistant*
RemoveAssistantAIAgent	アシスタントから AI エージェントを削除する許可を付与する	書き込み	Assistant*
RemoveKnowledgeBaseTemplateUri	ナレッジベースから URI テンプレートを削除するためのアクセス許可を付与	書き込み	KnowledgeBase*
RenderMessageTemplate	メッセージテンプレートをレンダリングする許可を付与する	読み取り	KnowledgeBase*		wisdom:GetMessageTemplate
			MessageTemplate*
				wisdom:MessageTemplate/RoutingProfileArn
Retrieve	指定されたアシスタントの関連付けからナレッジコンテンツを取得する許可を付与	読み取り	Assistant*
SearchContent	指定されたナレッジベースを参照しながらコンテンツを検索するためのアクセス許可を付与特定のコンテンツリソースを、その名前で取得する際に使用します。	読み取り	KnowledgeBase*
SearchMessageTemplates	指定されたナレッジベースを参照するメッセージテンプレートを検索する許可を付与する	読み取り	KnowledgeBase*
SearchMessageTemplates	指定されたナレッジベースを参照するメッセージテンプレートを検索する許可を付与する	読み取り		wisdom:SearchFilter/RoutingProfileArn wisdom:SearchFilter/Qualifier
SearchQuickResponses	指定されたナレッジベースを参照しながらクイックレスポンスを検索するアクセス許可を付与	読み取り	KnowledgeBase*		wisdom:GetQuickResponse
SearchQuickResponses	指定されたナレッジベースを参照しながらクイックレスポンスを検索するアクセス許可を付与	読み取り		wisdom:SearchFilter/RoutingProfileArn
SearchSessions	指定されたアシスタントを参照しながらセッションを検索するためのアクセス許可を付与特定のセッションリソースを、その名前で取得する際に使用します。	読み取り
SendMessage	メッセージを送信するアクセス許可を付与します	書き込み	Session*
StartContentUpload	ナレッジベースにコンテンツをアップロードする際の URL を取得するためのアクセス許可を付与	書き込み	KnowledgeBase*
StartImportJob	複数のクイックレスポンスを作成するアクセス許可を付与	書き込み	KnowledgeBase*
StartImportJob	複数のクイックレスポンスを作成するアクセス許可を付与	書き込み		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*
UpdateAIGuardrail	ai ガードレールに関する情報を更新するアクセス許可を付与します	書き込み	AIGuardrail*
UpdateAIPrompt	AI プロンプトに関する情報を更新する許可を付与する	書き込み	AIPrompt*
UpdateAssistantAIAgent	AI エージェントに関するアシスタント情報を更新する許可を付与する	書き込み	Assistant*
UpdateContent	コンテンツに関する情報を更新するためのアクセス許可を付与	書き込み	Content*
UpdateContent	コンテンツに関する情報を更新するためのアクセス許可を付与	書き込み	KnowledgeBase*
UpdateKnowledgeBaseTemplateUri	ナレッジベースのテンプレート URI を更新するためのアクセス許可を付与	書き込み	KnowledgeBase*
UpdateMessageTemplate	メッセージテンプレートの内容を更新する許可を付与する	書き込み	KnowledgeBase*
UpdateMessageTemplate	メッセージテンプレートの内容を更新する許可を付与する	書き込み	MessageTemplate*
UpdateMessageTemplateMetadata	メッセージテンプレートのメタデータを更新する許可を付与する	書き込み	KnowledgeBase*
UpdateMessageTemplateMetadata	メッセージテンプレートのメタデータを更新する許可を付与する	書き込み	MessageTemplate*
UpdateQuickResponse	クイックレスポンスのコンテンツに関する情報を更新するアクセス許可を付与	書き込み	KnowledgeBase*
UpdateQuickResponse	クイックレスポンスのコンテンツに関する情報を更新するアクセス許可を付与	書き込み	QuickResponse*
UpdateSession	セッションを更新する許可を付与する	書き込み	Session*
UpdateSessionData	セッションに保存されたデータを更新する許可を付与する	書き込み	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 「グローバル条件コンテキストキー」を参照してください。

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

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Amazon Q Developer

Amazon QLDB