本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon Q Business 的動作、資源和條件索引鍵
Amazon Q Business (服務字首:qbusiness
) 提供下列服務特定的資源、動作和條件內容索引鍵,可用於IAM許可政策。
參考資料:
-
了解如何設定此服務。
-
檢視API此服務可用的操作清單 。
-
了解如何使用IAM許可政策來保護此服務及其資源。
Amazon Q Business 定義的動作
您可以在IAM政策陳述式的 Action
元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時,通常會允許或拒絕存取具有相同名稱API的操作或CLI命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource
元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作ARN的陳述式中指定該類型的 。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在IAM政策中使用 Resource
元素限制資源存取,則必須為每個所需資源類型包含 ARN或 模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition
元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
---|---|---|---|---|---|
AddUserLicenses | 准許新增一個或多個使用者以取得授權 | 寫入 | |||
BatchDeleteDocument | 准許批次刪除文件 | 寫入 | |||
BatchPutDocument | 准許批次放置文件 | 寫入 | |||
CancelSubscription | 准許取消訂閱 | 寫入 | |||
Chat | 准許使用應用程式聊天 | 讀取 | |||
ChatSync | 准許使用應用程式同步聊天 | 讀取 | |||
CreateApplication | 准許建立應用程式 | 寫入 | |||
CreateDataSource | 准許建立指定應用程式和索引的資料來源 | 寫入 | |||
CreateIndex | 准許建立指定應用程式的索引 | 寫入 | |||
CreateLicense | 准許建立授權 | 寫入 | |||
CreatePlugin | 准許建立指定應用程式的外掛程式 | 寫入 | |||
CreateRetriever | 准許建立指定應用程式的擷取器 | 寫入 | |||
CreateSubscription | 准許建立訂閱 | 寫入 | |||
CreateUser | 准許建立使用者 | 寫入 | |||
CreateWebExperience | 准許建立指定應用程式的 Web 體驗 | 寫入 | |||
DeleteApplication | 准許刪除應用程式 | 寫入 | |||
DeleteChatControlsConfiguration | 准許刪除應用程式的聊天控制組態 | 寫入 | |||
DeleteConversation | 准許刪除對話 | 寫入 | |||
DeleteDataSource | 准許刪除 DataSource | 寫入 | |||
DeleteGroup | 准許刪除群組 | 寫入 | |||
DeleteIndex | 准許刪除索引 | 寫入 | |||
DeletePlugin | 准許刪除外掛程式 | 寫入 | |||
DeleteRetriever | 准許刪除擷取器 | 寫入 | |||
DeleteUser | 准許刪除使用者 | 寫入 | |||
DeleteWebExperience | 准許刪除 Web 體驗 | 寫入 | |||
DisableAclOnDataSource [僅限許可] | 准許在建立 Amazon Q Business 資料來源資源時停用ACL爬蟲 | 寫入 | |||
GetApplication | 准許取得應用程式 | 讀取 | |||
GetChatControlsConfiguration | 准許取得應用程式的聊天控制項組態 | 清單 | |||
GetDataSource | 准許取得資料來源 | 讀取 | |||
GetGroup | 准許取得群組 | 讀取 | |||
GetIndex | 准許取得索引 | 讀取 | |||
GetLicense | 准許取得授權 | 讀取 | |||
GetPlugin | 准許取得外掛程式 | 讀取 | |||
GetRetriever | 准許取得擷取器 | 讀取 | |||
GetUser | 准許取得使用者 | 讀取 | |||
GetWebExperience | 准許取得 Web 體驗 | 讀取 | |||
ListApplications | 准許列出應用程式 | 清單 | |||
ListConversations | 准許列出應用程式的所有對話 | 清單 | |||
ListDataSourceSyncJobs | 准許取得資料來源同步任務歷史記錄 | 清單 | |||
ListDataSources | 准許列出應用程式和索引的資料來源 | 清單 | |||
ListDocuments | 准許列出所有文件 | 清單 | |||
ListGroups | 准許列出群組 | 清單 | |||
ListIndices | 准許列出應用程式的授權 | 清單 | |||
ListMessages | 准許列出所有訊息 | 清單 | |||
ListPlugins | 准許列出應用程式的外掛程式 | 清單 | |||
ListRetrievers | 准許列出應用程式的擷取器 | 清單 | |||
ListSubscriptions | 准許列出訂閱 | 清單 | |||
ListTagsForResource | 准許列出資源的標籤 | 讀取 | |||
ListUserLicenses | 准許列出授權 | 清單 | |||
ListWebExperiences | 准許列出應用程式的 Web 體驗 | 清單 | |||
PutFeedback | 准許放置有關交談訊息的意見回饋 | 寫入 | |||
PutGroup | 准許放置使用者群組 | 寫入 | |||
RemoveUserLicenses | 准許移除一個或多個使用者的授權 | 寫入 | |||
StartDataSourceSyncJob | 准許啟動資料來源同步任務 | 寫入 | |||
StopDataSourceSyncJob | 准許停止資料來源同步任務 | 寫入 | |||
TagResource | 准許使用指定金鑰值配對來標記資源 | 標記 | |||
UntagResource | 准許從資源中刪除具有給定索引鍵的標籤 | 標記 | |||
UpdateApplication | 准許更新應用程式 | 寫入 | |||
UpdateChatControlsConfiguration | 准許更新應用程式的聊天控制組態 | 寫入 | |||
UpdateDataSource | 准許更新 DataSource | 寫入 | |||
UpdateIndex | 准許更新索引 | 寫入 | |||
UpdatePlugin | 准許更新外掛程式 | 寫入 | |||
UpdateRetriever | 准許更新擷取器 | 寫入 | |||
UpdateSubscription | 准許更新訂閱 | 寫入 | |||
UpdateUser | 准許更新使用者 | 寫入 | |||
UpdateWebExperience | 准許更新 WebExperience | 寫入 | |||
Amazon Q Business 定義的資源類型
下列資源類型由此服務定義,可用於IAM許可政策陳述式的 Resource
元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
資源類型 | ARN | 條件索引鍵 |
---|---|---|
application |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}
|
|
retriever |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/retriever/${RetrieverId}
|
|
index |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}
|
|
data-source |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}/data-source/${DataSourceId}
|
|
plugin |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/plugin/${PluginId}
|
|
web-experience |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/web-experience/${WebExperienceId}
|
|
user-license |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/user-license/${UserLicenseId}
|
|
subscription |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/subscription/${SubscriptionId}
|
Amazon Q Business 的條件索引鍵
Amazon Q Business 會定義下列條件索引鍵,可用於IAM政策的 Condition
元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵,請參閱可用全域條件鍵。
條件索引鍵 | 描述 | 類型 |
---|---|---|
aws:RequestTag/${TagKey} | 依要求中傳遞的標籤來篩選存取權 | 字串 |
aws:ResourceTag/${TagKey} | 依與資源關聯的標籤來篩選存取權 | 字串 |
aws:TagKeys | 依要求中傳遞的標籤索引鍵來篩選存取權 | ArrayOfString |