Amazon Q Business Q Apps のアクション、リソース、および条件キー
Amazon Q Business Q Apps (サービスプレフィックス: qapps) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のオペレーション、リソース、アクション、および条件キーが用意されています。
リファレンス:
-
このサービスを設定する方法について説明します。
-
このサービスで使用可能な API オペレーションのリストを表示します。
-
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。
-
このサービスのプログラムによるサービス認可リファレンス
を表示します。
トピック
Amazon Q Business Q Apps で定義される API オペレーション
次の表は、API オペレーションを認可する IAM アクションにマッピングします。指定された API とアクションの静的値を持つ条件キーのみが一覧表示されます。各アクションでサポートされている条件キーの完全なセットについては、「アクション」表を参照してください。
| 運用 | IAM アクション | 条件キー | 可能な値 (複数可) | アクセスレベル |
|---|---|---|---|---|
|
AssociateLibraryItemReview |
書き込み |
|||
|
AssociateQAppWithUser |
書き込み |
|||
|
BatchCreateCategory |
書き込み |
|||
|
BatchDeleteCategory |
書き込み |
|||
|
BatchUpdateCategory |
書き込み |
|||
|
CreateLibraryItem |
書き込み |
|||
|
CreatePresignedUrl |
書き込み |
|||
|
CreateQApp |
書き込み |
|||
|
DeleteLibraryItem |
書き込み |
|||
|
DeleteQApp |
書き込み |
|||
|
DescribeQAppPermissions |
読み取り |
|||
|
DisassociateLibraryItemReview |
書き込み |
|||
|
DisassociateQAppFromUser |
書き込み |
|||
|
ExportQAppSessionData |
書き込み |
|||
|
GetLibraryItem |
読み取り |
|||
|
GetQApp |
読み取り |
|||
|
GetQAppSession |
読み取り |
|||
|
GetQAppSessionMetadata |
読み取り |
|||
|
ImportDocument |
書き込み |
|||
|
ListCategories |
リスト |
|||
|
ListLibraryItems |
リスト |
|||
|
ListQAppSessionData |
読み取り |
|||
|
ListQApps |
リスト |
|||
|
ListTagsForResource |
読み取り |
|||
|
StartQAppSession |
書き込み |
|||
|
StopQAppSession |
書き込み |
|||
|
TagResource |
タグ付け、書き込み |
|||
|
UntagResource |
タグ付け、書き込み |
|||
|
UpdateLibraryItem |
書き込み |
|||
|
UpdateLibraryItemMetadata |
書き込み |
|||
|
UpdateQApp |
書き込み |
|||
|
UpdateQAppPermissions |
書き込み |
|||
|
UpdateQAppSession |
書き込み |
|||
|
UpdateQAppSessionMetadata |
書き込み |
Amazon Q Business Q Apps で定義されるアクション
IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、 AWSでオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
| アクション | 説明 | リソースタイプ (* 必須) | 条件キー | アクセスレベル |
|---|---|---|---|---|
Q Business アプリケーション環境でライブラリ項目レビューを関連付ける許可を付与する |
書き込み |
|||
Q Business アプリケーション環境でユーザーと Q App を関連付ける許可を付与する |
書き込み |
|||
Q Business アプリケーション環境でライブラリのカテゴリを作成するアクセス許可を付与 |
書き込み |
|||
Q Business アプリケーション環境でライブラリのカテゴリを削除する許可を付与 |
書き込み |
|||
Q Business アプリケーション環境でライブラリのカテゴリを更新する許可を付与 |
書き込み |
|||
Q Business アプリケーション環境でライブラリ項目を作成する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App を作成する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境でライブラリ項目を削除する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App を削除する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App の共有権限を取得するアクセス許可を付与 |
読み取り |
|||
Q Business アプリケーション環境でライブラリ項目レビューの関連付けを解除する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境でユーザーと Q App の関連付けを解除する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App セッションデータをエクスポートする許可を付与する |
書き込み |
|||
Q Business アプリケーション環境でライブラリ項目を取得する許可を付与する |
読み取り |
|||
Q Business アプリケーション環境で Q App を取得する許可を付与する |
読み取り |
|||
Q Business アプリケーション環境で Q App セッションを取得する許可を付与する |
読み取り |
|||
Q Business アプリケーション環境で Q App セッションメタデータを取得する許可を付与する |
読み取り |
|||
Q Business アプリケーション環境で Q App または Q App セッションにドキュメントをインポートする許可を付与する |
書き込み |
|||
Q Business アプリケーション環境でライブラリを一覧表示する許可を付与 |
リスト |
|||
Q Business アプリケーション環境でライブラリアイテムを一覧表示する許可を付与する |
リスト |
|||
Q Business アプリケーション環境で Q App セッションデータを取得する許可を付与する |
読み取り |
|||
Q Business アプリケーション環境で Q App を一覧表示する許可を付与する |
リスト |
|||
リソースのタグを一覧表示する許可を付与 |
読み取り |
|||
Q Business アプリケーション環境の会話ログまたは問題ステートメントから Q App を予測する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App セッションを開始する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App セッションを停止する許可を付与する |
書き込み |
|||
指定されたキーと値のペアでリソースにタグを付けるアクセス許可を付与 |
タグ付け、書き込み |
|||
所与のキーを持つタグをリソースから削除する許可を付与 |
タグ付け、書き込み |
|||
Q Business アプリケーション環境でライブラリ項目を更新する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境のライブラリ項目のメタデータを更新する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App を更新する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App の共有権限を更新するアクセス許可を付与 |
書き込み |
|||
Q Business アプリケーション環境で Q App セッションを更新する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App セッションメタデータを更新する許可を付与する |
書き込み |
Amazon Q Business Q Apps のアクセス許可のみのアクション
以下のアクションは Amazon Q Business Q Apps によって定義されますが、API オペレーションを通じて直接呼び出すことはできません。アクセス許可を付与または拒否するには、IAM ポリシーステートメントでのみ使用できます。
| アクション | 説明 | リソースタイプ (* 必須) | 条件キー | アクセスレベル |
|---|---|---|---|---|
Q Business アプリケーション環境で Q App をコピーする許可を付与する |
書き込み |
|||
Q Business アプリケーション環境でライブラリ項目レビューを作成する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境で Q App イベントバストピックをサブスクライブする許可を付与する |
書き込み |
|||
Q Business アプリケーション環境の会話ログから問題ステートメントを予測する許可を付与する |
書き込み |
|||
Q Business アプリケーション環境の問題ステートメントから Q App メタデータを予測する許可を付与する |
書き込み |
Amazon Q Business Q Apps で定義されるリソースタイプ
以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。
| リソースタイプ: | ARN | 条件キー |
|---|---|---|
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId} |
||
arn:${Partition}:qapps:${Region}:${Account}:application/${ApplicationId}/qapp/${AppId} |
||
arn:${Partition}:qapps:${Region}:${Account}:application/${ApplicationId}/qapp/${AppId}/session/${SessionId} |
Amazon Q Business Q Apps の条件キー
Amazon Q Business Q Apps は、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。
| 条件キー | 説明 | タイプ |
|---|---|---|
リクエストで渡されたタグでアクセスをフィルタリングします |
String |
|
リソースに関連付けられたタグでアクセスをフィルタリングします |
String |
|
リクエストで渡されたタグキーでアクセスをフィルタリングします |
ArrayOfString |
|
Q App が公開されているかどうかによってアクセスをフィルタリングする |
String |
|
Q App セッションが共有されているかどうかによってアクセスをフィルタリングする |
String |
|
リクエスタが Q App 所有者であるかどうかによってアクセスをフィルタリングする |
String |
|
リクエスタが Q App セッションモデレーターであるかどうかによってアクセスをフィルタリングする |
String |
