本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon Q 的動作、資源和條件索引鍵
Amazon Q (服務字首:q
) 提供下列服務特定的資源、動作和條件內容索引鍵,可用於 IAM 許可政策。
參考資料:
-
了解如何設定此服務。
-
檢視API此服務可用的操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
Amazon Q 定義的動作
您可在 IAM 政策陳述式的 Action
元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時,通常會允許或拒絕存取具有相同名稱API的操作或CLI命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource
元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作ARN的陳述式中指定該類型的 。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中限制使用 Resource
元素存取資源,您必須為每個必要的資源類型包含 ARN或 模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition
元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
---|---|---|---|---|---|
CreateAssignment [僅限許可] | 准許為 Amazon Q 開發人員設定檔建立使用者或群組指派 | 寫入 | |||
CreatePlugin [僅限許可] | 准許在 Amazon Q 中建立和設定第三方外掛程式 | 寫入 | |||
DeleteAssignment [僅限許可] | 准許刪除 Amazon Q 開發人員設定檔的使用者或群組指派 | 寫入 | |||
DeletePlugin [僅限許可] | 准許刪除 Amazon Q 中設定的外掛程式 | 寫入 | |||
GenerateCodeFromCommands [僅限許可] | 准許從 Amazon Q 中的CLI命令產生程式碼 | 讀取 | |||
GetConversation [僅限許可] | 准許取得與 Amazon Q 的特定對話相關聯的個別訊息 | 讀取 | |||
GetIdentityMetadata [僅限許可] | 准許 Amazon Q 取得身分中繼資料 | 讀取 | |||
GetPlugin [僅限許可] | 准許檢視特定設定 Amazon Q 外掛程式的相關資訊 | 讀取 | |||
GetTroubleshootingResults [僅限許可] | 准許取得 Amazon Q 的疑難排解結果 | 讀取 | |||
ListConversations [僅限許可] | 准許列出與特定 Amazon Q 使用者相關聯的個別對話 | 讀取 | |||
ListDashboardMetrics [僅限許可] | 准許讀取指標以填入 Amazon Q 儀表板 | 清單 | |||
ListPluginProviders [僅限許可] | 准許列出 Amazon Q 中的可用外掛程式 | 清單 | |||
ListPlugins [僅限許可] | 准許列出 Amazon Q 中設定的外掛程式 | 清單 | |||
ListTagsForResource [僅限許可] | 准許列出與 Amazon Q 資源相關聯的所有標籤 | 清單 | |||
PassRequest [僅限許可] | 准許 Amazon Q 代表您執行動作 | 寫入 | |||
SendMessage [僅限許可] | 准許傳送訊息給 Amazon Q | 寫入 | |||
StartConversation [僅限許可] | 准許開始與 Amazon Q 對話 | 寫入 | |||
StartTroubleshootingAnalysis [僅限許可] | 准許啟動 Amazon Q 進行疑難排解分析 | 寫入 | |||
StartTroubleshootingResolutionExplanation [僅限許可] | 准許啟動 Amazon Q 進行疑難排解解決方案說明 | 寫入 | |||
TagResource [僅限許可] | 准許將標籤與 Amazon Q 資源建立關聯 | 標記 | |||
UntagResource [僅限許可] | 准許移除與 Amazon Q 資源相關聯的標籤 | 標記 | |||
UpdateTroubleshootingCommandResult [僅限許可] | 准許使用 Amazon Q 更新故障診斷命令結果 | 寫入 | |||
UsePlugin [僅限許可] | 准許使用 Amazon Q 外掛程式 | 寫入 |
Amazon Q 定義的資源類型
此服務會定義下列資源類型,並可用在 IAM 許可政策陳述式的 Resource
元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
Amazon Q 的條件索引鍵
Amazon Q 定義下列條件索引鍵,可用於 IAM政策的 Condition
元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵,請參閱可用全域條件鍵。
條件索引鍵 | 描述 | 類型 |
---|---|---|
aws:RequestTag/${TagKey} | 依要求中傳遞的標籤來篩選存取權 | 字串 |
aws:ResourceTag/${TagKey} | 依與 Amazon Q 資源相關聯的標籤篩選存取權 | 字串 |
aws:TagKeys | 依要求中傳遞的標籤索引鍵來篩選存取權 | ArrayOfString |
identitystore:GroupId | 依IAM身分中心群組 ID 篩選存取權 | ArrayOfString |
identitystore:UserId | 依 IAM Identity Center 使用者 ID 篩選存取權 | ArrayOfString |