翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Q in Connect のアクション、リソース、および条件キー
Amazon Q in Connect (サービスプレフィックス: wisdom
) では、 アクセスIAM許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。
リファレンス:
-
このサービスを設定する方法について説明します。
-
API このサービスで使用可能なオペレーションのリストを表示します。
-
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。
Amazon Q in Connect で定義されるアクション
IAM ポリシーステートメントの Action
要素では、以下のアクションを指定できます。ポリシーを使用して、 AWSでオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合、通常、同じ名前のAPIオペレーションまたはCLIコマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource
要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれている場合は、ARNそのアクションを含むステートメントでそのタイプの を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource
要素を使用してリソースアクセスを制限する場合は、必要なリソースタイプごとに ARNまたは パターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。
[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition
要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。
注記
リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。
以下の表の列の詳細については、「アクションテーブル」を参照してください。
アクション | 説明 | アクセスレベル | リソースタイプ (* 必須) | 条件キー | 依存アクション |
---|---|---|---|---|---|
ActivateMessageTemplate | メッセージテンプレートをアクティブ化する許可を付与する | 書き込み | |||
AllowVendedLogDeliveryForResource[アクセス許可のみ] | アシスタント用の vended log 配信を設定する許可を付与する | 権限の管理 | |||
CreateAIAgent | AI エージェントを作成する許可を付与する | 書き込み | |||
CreateAIAgentVersion | AI エージェントバージョンを作成する許可を付与する | 書き込み | |||
CreateAIGuardrail | AI ガードレールを作成する許可を付与 | 書き込み | |||
CreateAIGuardrailVersion | AI ガードレールバージョンを作成する許可を付与 | 書き込み | |||
CreateAIPrompt | AI プロンプトを作成する許可を付与する | 書き込み | |||
CreateAIPromptVersion | AI プロンプトのバージョンを作成する許可を付与する | 書き込み | |||
CreateAssistant | アシスタントを作成するためのアクセス許可を付与 | 書き込み | |||
CreateAssistantAssociation | アシスタントと他のリソース間の関連付けを作成するためのアクセス許可を付与 | 書き込み | |||
CreateContent | コンテンツを作成するためのアクセス許可を付与 | 書き込み | |||
CreateContentAssociation | コンテンツの関連付けを作成する許可を付与する | 書き込み | |||
CreateKnowledgeBase | ナレッジベースを作成するためのアクセス許可を付与 | 書き込み | |||
CreateMessageTemplate | メッセージテンプレートを作成する許可を付与する | 書き込み | |||
CreateMessageTemplateAttachment | メッセージテンプレートに添付ファイルを作成する許可を付与する | 書き込み | |||
CreateMessageTemplateVersion | メッセージテンプレートのバージョンを作成する許可を付与する | 書き込み | |||
CreateQuickResponse | クイックレスポンスを作成するアクセス許可を付与 | 書き込み | |||
CreateSession | セッションを作成するためのアクセス許可を付与 | 書き込み | |||
DeactivateMessageTemplate | メッセージテンプレートを非アクティブ化する許可を付与する | 書き込み | |||
DeleteAIAgent | AI エージェントを削除する許可を付与する | 書き込み | |||
DeleteAIAgentVersion | AI エージェントのバージョンを削除する許可を付与する | 書き込み | |||
DeleteAIGuardrail | AI ガードレールを削除する許可を付与 | 書き込み | |||
DeleteAIGuardrailVersion | AI ガードレールバージョンを削除する許可を付与 | 書き込み | |||
DeleteAIPrompt | AI プロンプトを削除する許可を付与する | 書き込み | |||
DeleteAIPromptVersion | AI プロンプトバージョンを削除する許可を付与する | 書き込み | |||
DeleteAssistant | アシスタントを削除するためのアクセス許可を付与 | 書き込み | |||
DeleteAssistantAssociation | アシスタントの関連付けを削除するためのアクセス許可を付与 | 書き込み | |||
DeleteContent | コンテンツを削除するためのアクセス許可を付与 | 書き込み | |||
DeleteContentAssociation | コンテンツの関連付けを削除する許可を付与する | 書き込み | |||
DeleteImportJob | ナレッジベースのインポートジョブを削除するアクセス許可を付与 | 書き込み | |||
DeleteKnowledgeBase | ナレッジベースを削除するためのアクセス許可を付与 | 書き込み | |||
DeleteMessageTemplate | メッセージテンプレートを削除する許可を付与する | 書き込み | |||
DeleteMessageTemplateAttachment | メッセージテンプレートから添付ファイルを削除する許可を付与する | 書き込み | |||
DeleteQuickResponse | クイックレスポンスを削除するアクセス許可を付与 | 書き込み | |||
GetAIAgent | AI エージェントに関する情報を取得する許可を付与する | 読み取り | |||
GetAIGuardrail | AI ガードレールに関する情報を取得する許可を付与 | 読み取り | |||
GetAIPrompt | プロンプトについての情報を取得する許可を付与する | 読み取り | |||
GetAssistant | アシスタントに関する情報を取得するためのアクセス許可を付与 | 読み取り | |||
GetAssistantAssociation | アシスタントの関連付けに関する情報を取得するためにアクセス許可を付与 | 読み取り | |||
GetContent | コンテンツをダウンロードURLするための署名を含む、コンテンツを取得する許可を付与 | 読み取り | |||
GetContentAssociation | コンテントの関連付けに関する情報を取得する許可を付与する | 読み取り | |||
GetContentSummary | コンテンツの概要に関する情報を取得するためのアクセス許可を付与 | 読み取り | |||
GetImportJob | 特定のインポートジョブに関する情報を取得するアクセス許可を付与 | 読み取り | |||
GetKnowledgeBase | ナレッジベースに関する情報を取得するためのアクセス許可を付与 | 読み取り | |||
GetMessageTemplate | メッセージテンプレートを取得する許可を付与する | 読み取り | |||
GetNextMessage | セッション内の次のメッセージを取得するためのアクセス許可を付与 | 読み取り | |||
GetQuickResponse | コンテンツを取得するアクセス許可を付与 | 読み取り | |||
GetRecommendations | 指定されたセッションについての推奨事項を取得するためのアクセス許可を付与 | 読み取り | |||
GetSession | 指定されたセッションの情報を取得するためのアクセス許可を付与 | 読み取り | |||
ListAIAgentVersions | AI エージェントのバージョンに関する情報を一覧表示する許可を付与する | リスト | |||
ListAIAgents | AI エージェントに関する情報を一覧表示する許可を付与する | リスト | |||
ListAIGuardrailVersions | AI ガードレールのバージョンに関する情報を一覧表示する許可を付与 | リスト | |||
ListAIGuardrails | AI ガードレールに関する情報を一覧表示する許可を付与 | リスト | |||
ListAIPromptVersions | AI プロンプトバージョンに関する情報を一覧表示する許可を付与する | リスト | |||
ListAIPrompts | プロンプトに関する情報を一覧表示する許可を付与する | リスト | |||
ListAssistantAssociations | アシスタントの関連付けに関する情報を一覧表示するためのアクセス許可を付与 | リスト | |||
ListAssistants | アシスタントに関する情報を一覧表示するためのアクセス許可を付与 | リスト | |||
ListContentAssociations | コンテンツの関連付けに関する情報を一覧表示する許可を付与する | リスト | |||
ListContents | ナレッジベースのコンテンツを一覧表示するためのアクセス許可を付与 | リスト | |||
ListImportJobs | ナレッジベースに関する情報を一覧表示するためのアクセス許可を付与 | リスト | |||
ListKnowledgeBases | ナレッジベースに関する情報を一覧表示するためのアクセス許可を付与 | リスト | |||
ListMessageTemplateVersions | 指定されたメッセージテンプレートのメッセージテンプレートバージョンを一覧表示する許可を付与する | リスト | |||
ListMessageTemplates | ナレッジベースのメッセージテンプレートを一覧表示する許可を付与する | リスト | |||
ListMessages | セッション内のメッセージを一覧表示する許可を付与 | リスト | |||
ListQuickResponses | クイックレスポンスをナレッジベースとともに一覧表示するアクセス許可を付与 | リスト | |||
ListTagsForResource | 指定されたリソースのタグを一覧表示するためのアクセス許可を付与 | 読み取り | |||
NotifyRecommendationsReceived | 新しく利用可能になった推奨事項において、指定されたアシスタントのキューから、指定された推奨事項を削除するためのアクセス許可を付与 | 書き込み | |||
PutFeedback | フィードバックを送信する許可を付与 | 書き込み | |||
QueryAssistant | 指定されたアシスタントに対して手動検索を実行するためのアクセス許可を付与 | 読み取り | |||
RemoveAssistantAIAgent | アシスタントから AI エージェントを削除する許可を付与する | 書き込み | |||
RemoveKnowledgeBaseTemplateUri | ナレッジベースからURIテンプレートを削除する許可を付与 | 書き込み | |||
RenderMessageTemplate | メッセージテンプレートをレンダリングする許可を付与する | 読み取り |
wisdom:GetMessageTemplate |
||
SearchContent | 指定されたナレッジベースを参照しながらコンテンツを検索するためのアクセス許可を付与 特定のコンテンツリソースを、その名前で取得する際に使用します。 | 読み取り | |||
SearchMessageTemplates | 指定されたナレッジベースを参照するメッセージテンプレートを検索する許可を付与する | 読み取り | |||
SearchQuickResponses | 指定されたナレッジベースを参照しながらクイックレスポンスを検索するアクセス許可を付与 | 読み取り |
wisdom:GetQuickResponse |
||
SearchSessions | 指定されたアシスタントを参照しながらセッションを検索するためのアクセス許可を付与 特定のセッションリソースを、その名前で取得する際に使用します。 | 読み取り | |||
SendMessage | メッセージを送信する許可を付与 | 書き込み | |||
StartContentUpload | ナレッジベースにコンテンツをアップロードURLするための を取得する許可を付与 | 書き込み | |||
StartImportJob | 複数のクイックレスポンスを作成するアクセス許可を付与 | 書き込み | |||
TagResource | 指定されたタグを指定されたリソースに追加するためのアクセス許可を付与 | Tagging | |||
UntagResource | 指定されたリソースから指定されたタグを削除するためのアクセス許可を付与 | Tagging | |||
UpdateAIAgent | AI エージェントに関する情報を更新する許可を付与する | 書き込み | |||
UpdateAIGuardrail | AI ガードレールに関する情報を更新する許可を付与 | 書き込み | |||
UpdateAIPrompt | AI プロンプトに関する情報を更新する許可を付与する | 書き込み | |||
UpdateAssistantAIAgent | AI エージェントに関するアシスタント情報を更新する許可を付与する | 書き込み | |||
UpdateContent | コンテンツに関する情報を更新するためのアクセス許可を付与 | 書き込み | |||
UpdateKnowledgeBaseTemplateUri | URI ナレッジベースのテンプレートを更新する許可を付与 | 書き込み | |||
UpdateMessageTemplate | メッセージテンプレートの内容を更新する許可を付与する | 書き込み | |||
UpdateMessageTemplateMetadata | メッセージテンプレートのメタデータを更新する許可を付与する | 書き込み | |||
UpdateQuickResponse | クイックレスポンスのコンテンツに関する情報を更新するアクセス許可を付与 | 書き込み | |||
UpdateSession | セッションを更新する許可を付与する | 書き込み | |||
UpdateSessionData | セッションに保存されたデータを更新する許可を付与する | 書き込み | |||
Amazon Q in Connect で定義されるリソースタイプ
以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource
要素で使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。
リソースタイプ | ARN | 条件キー |
---|---|---|
AIAgent |
arn:${Partition}:wisdom:${Region}:${Account}:ai-agent/${AssistantId}/${AIAgentId}
|
|
AIPrompt |
arn:${Partition}:wisdom:${Region}:${Account}:ai-prompt/${AssistantId}/${AIPromptId}
|
|
AIGuardrail |
arn:${Partition}:wisdom:${Region}:${Account}:ai-guardrail/${AssistantId}/${AIGuardrailId}
|
|
Assistant |
arn:${Partition}:wisdom:${Region}:${Account}:assistant/${AssistantId}
|
|
AssistantAssociation |
arn:${Partition}:wisdom:${Region}:${Account}:association/${AssistantId}/${AssistantAssociationId}
|
|
Content |
arn:${Partition}:wisdom:${Region}:${Account}:content/${KnowledgeBaseId}/${ContentId}
|
|
ContentAssociation |
arn:${Partition}:wisdom:${Region}:${Account}:content-association/${KnowledgeBaseId}/${ContentId}/${ContentAssociationId}
|
|
KnowledgeBase |
arn:${Partition}:wisdom:${Region}:${Account}:knowledge-base/${KnowledgeBaseId}
|
|
MessageTemplate |
arn:${Partition}:wisdom:${Region}:${Account}:message-template/${KnowledgeBaseId}/${MessageTemplateId}
|
|
Session |
arn:${Partition}:wisdom:${Region}:${Account}:session/${AssistantId}/${SessionId}
|
|
QuickResponse |
arn:${Partition}:wisdom:${Region}:${Account}:quick-response/${KnowledgeBaseId}/${QuickResponseId}
|
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 |