本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon Q Business Q 應用程式的動作、資源和條件索引鍵
Amazon Q Business Q Apps （服務字首：qapps) 提供下列服務特定的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視此服務可用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
Amazon Q Business Q 應用程式定義的動作
您可以在 IAM 政策陳述式的 Action元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時，通常會允許或拒絕存取具有相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中使用 Resource元素限制資源存取，則必須為每個必要的資源類型包含 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| AssociateLibraryItemReview | 准許在 Q Business 應用程式環境中關聯程式庫項目檢閱 | 寫入 | |||
| AssociateQAppWithUser | 准許在 Q Business 應用程式環境中將 Q 應用程式與使用者建立關聯 | 寫入 | |||
| BatchCreateCategory | 准許在 Q Business 應用程式環境中建立程式庫的類別 | 寫入 | |||
| BatchDeleteCategory | 准許在 Q Business 應用程式環境中刪除程式庫的類別 | 寫入 | |||
| BatchUpdateCategory | 准許在 Q Business 應用程式環境中更新程式庫的類別 | 寫入 | |||
| CopyQApp [僅限許可] | 准許在 Q Business 應用程式環境中複製 Q 應用程式 | 寫入 | |||
| CreateLibraryItem | 准許在 Q Business 應用程式環境中建立程式庫項目 | 寫入 | |||
| CreateLibraryItemReview [僅限許可] | 准許在 Q Business 應用程式環境中建立程式庫項目檢閱 | 寫入 | |||
| CreatePresignedUrl | 准許在 Q Business 應用程式環境中建立預先簽章的 URL，以將檔案上傳至 Q App 或 Q App Session | 寫入 | |||
| CreateQApp | 准許在 Q Business 應用程式環境中建立 Q 應用程式 | 寫入 | |||
| CreateSubscriptionToken [僅限許可] | 准許訂閱 Q Business 應用程式環境中的 Q App 事件匯流排主題 | 寫入 | |||
| DeleteLibraryItem | 准許在 Q Business 應用程式環境中刪除程式庫項目 | 寫入 | |||
| DeleteQApp | 准許在 Q Business 應用程式環境中刪除 Q 應用程式 | 寫入 | |||
| DescribeQAppPermissions | 准許在 Q Business 應用程式環境中取得 Q App 共用許可 | 讀取 | |||
| DisassociateLibraryItemReview | 准許在 Q Business 應用程式環境中取消程式庫項目檢閱的關聯 | 寫入 | |||
| DisassociateQAppFromUser | 准許在 Q Business 應用程式環境中取消 Q 應用程式與使用者的關聯 | 寫入 | |||
| ExportQAppSessionData [僅限許可] | 准許在 Q Business 應用程式環境中匯出 Q App 工作階段資料 | 寫入 | |||
| GetLibraryItem | 准許在 Q Business 應用程式環境中取得程式庫項目 | 讀取 | |||
| GetQApp | 准許在 Q Business 應用程式環境中取得 Q 應用程式 | 讀取 | |||
| GetQAppSession | 准許在 Q Business 應用程式環境中取得 Q App 工作階段 | 讀取 | |||
| GetQAppSessionMetadata [僅限許可] | 准許在 Q Business 應用程式環境中取得 Q App 工作階段中繼資料 | 讀取 | |||
| ImportDocument | 准許將文件匯入 Q Business 應用程式環境中的 Q App 或 Q App Session | 寫入 | |||
| ImportDocumentToQApp [僅限許可] | 准許在 Q Business 應用程式環境中將文件匯入 Q 應用程式 | 寫入 | |||
| ImportDocumentToQAppSession [僅限許可] | 准許將文件匯入 Q Business 應用程式環境中的 Q 應用程式工作階段 | 寫入 | |||
| ListCategories | 准許在 Q Business 應用程式環境中列出類別 | 清單 | |||
| ListLibraryItems | 准許列出 Q Business 應用程式環境中的程式庫項目 | 清單 | |||
| ListQAppSessionData [僅限許可] | 准許在 Q Business 應用程式環境中取得 Q App 工作階段資料 | 讀取 | |||
| ListQApps | 准許在 Q Business 應用程式環境中列出 Q 應用程式 | 清單 | |||
| ListTagsForResource | 准許列出資源的標籤 | 讀取 | |||
| PredictProblemStatementFromConversation [僅限許可] | 准許在 Q Business 應用程式環境中預測對話日誌中的問題陳述式 | 寫入 | |||
| PredictQApp | 准許在 Q Business 應用程式環境中從對話日誌或問題陳述式預測 Q 應用程式 | 寫入 | |||
| PredictQAppFromProblemStatement [僅限許可] | 准許預測 Q Business 應用程式環境中的問題陳述式中的 Q 應用程式中繼資料 | 寫入 | |||
| StartQAppSession | 准許在 Q Business 應用程式環境中啟動 Q App 工作階段 | 寫入 | |||
| StopQAppSession | 准許在 Q Business 應用程式環境中停止 Q App 工作階段 | 寫入 | |||
| TagResource | 准許使用指定金鑰值配對來標記資源 | 標記 | |||
| UntagResource | 准許從資源中刪除具有給定索引鍵的標籤 | 標記 | |||
| UpdateLibraryItem | 准許在 Q Business 應用程式環境中更新程式庫項目 | 寫入 | |||
| UpdateLibraryItemMetadata | 准許更新 Q Business 應用程式環境中程式庫項目的中繼資料 | 寫入 | |||
| UpdateQApp | 准許在 Q Business 應用程式環境中更新 Q 應用程式 | 寫入 | |||
| UpdateQAppPermissions | 准許在 Q Business 應用程式環境中更新 Q 應用程式共用許可 | 寫入 | |||
| UpdateQAppSession | 准許在 Q Business 應用程式環境中更新 Q App 工作階段 | 寫入 | |||
| UpdateQAppSessionMetadata [僅限許可] | 准許在 Q Business 應用程式環境中更新 Q App 工作階段中繼資料 | 寫入 |
Amazon Q Business Q 應用程式定義的資源類型
下列資源類型由此服務定義，可用於 IAM 許可政策陳述式的 Resource元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| application |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}
|
|
| qapp |
arn:${Partition}:qapps:${Region}:${Account}:application/${ApplicationId}/qapp/${AppId}
|
|
| qapp-session |
arn:${Partition}:qapps:${Region}:${Account}:application/${ApplicationId}/qapp/${AppId}/session/${SessionId}
|
Amazon Q Business Q 應用程式的條件金鑰
Amazon Q Business Q Apps 定義下列條件索引鍵，可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵，請參閱可用全域條件鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 依要求中傳遞的標籤來篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依與資源關聯的標籤來篩選存取權 | 字串 |
| aws:TagKeys | 依要求中傳遞的標籤索引鍵來篩選存取權 | ArrayOfString |
| qapps:AppIsPublished | 依 Q App 是否發佈來篩選存取權 | 字串 |
| qapps:SessionIsShared | 依是否共用 Q App Session 篩選存取權 | 字串 |
| qapps:UserIsAppOwner | 依請求者是否為 Q 應用程式擁有者來篩選存取權 | 字串 |
| qapps:UserIsSessionModerator | 依請求者是否為 Q App Session 主持人來篩選存取權 | 字串 |
