Amazon Q Business 的動作、資源和條件索引鍵 - 服務授權參考

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Amazon Q Business 的動作、資源和條件索引鍵

Amazon Q Business (服務字首:qbusiness) 提供下列服務特定的資源、動作和條件內容索引鍵,可用於IAM許可政策。

參考資料:

Amazon Q Business 定義的動作

您可以在IAM政策陳述式的 Action元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時,通常會允許或拒絕存取具有相同名稱API的操作或CLI命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作ARN的陳述式中指定該類型的 。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在IAM政策中使用 Resource元素限制資源存取,則必須為每個所需資源類型包含 ARN或 模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊,請參閱動作資料表

動作 描述 存取層級 資源類型 (*必填項目) 條件索引鍵 相依動作
AddUserLicenses 准許新增一個或多個使用者以取得授權 寫入
BatchDeleteDocument 准許批次刪除文件 寫入

application*

index*

BatchPutDocument 准許批次放置文件 寫入

application*

index*

CancelSubscription 准許取消訂閱 寫入

application*

subscription*

Chat 准許使用應用程式聊天 讀取

application*

ChatSync 准許使用應用程式同步聊天 讀取

application*

CreateApplication 准許建立應用程式 寫入

aws:RequestTag/${TagKey}

aws:TagKeys

CreateDataSource 准許建立指定應用程式和索引的資料來源 寫入

application*

index*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateIndex 准許建立指定應用程式的索引 寫入

application*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateLicense 准許建立授權 寫入
CreatePlugin 准許建立指定應用程式的外掛程式 寫入

application*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateRetriever 准許建立指定應用程式的擷取器 寫入

application*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateSubscription 准許建立訂閱 寫入

application*

CreateUser 准許建立使用者 寫入

application*

CreateWebExperience 准許建立指定應用程式的 Web 體驗 寫入

application*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteApplication 准許刪除應用程式 寫入

application*

DeleteChatControlsConfiguration 准許刪除應用程式的聊天控制組態 寫入

application*

DeleteConversation 准許刪除對話 寫入

application*

DeleteDataSource 准許刪除 DataSource 寫入

application*

data-source*

index*

DeleteGroup 准許刪除群組 寫入

application*

index*

DeleteIndex 准許刪除索引 寫入

application*

index*

DeletePlugin 准許刪除外掛程式 寫入

application*

plugin*

DeleteRetriever 准許刪除擷取器 寫入

application*

retriever*

DeleteUser 准許刪除使用者 寫入

application*

DeleteWebExperience 准許刪除 Web 體驗 寫入

application*

web-experience*

DisableAclOnDataSource [僅限許可] 准許在建立 Amazon Q Business 資料來源資源時停用ACL爬蟲 寫入

application*

GetApplication 准許取得應用程式 讀取

application*

GetChatControlsConfiguration 准許取得應用程式的聊天控制項組態 清單

application*

GetDataSource 准許取得資料來源 讀取

application*

data-source*

index*

GetGroup 准許取得群組 讀取

application*

index*

GetIndex 准許取得索引 讀取

application*

index*

GetLicense 准許取得授權 讀取

user-license*

GetPlugin 准許取得外掛程式 讀取

application*

plugin*

GetRetriever 准許取得擷取器 讀取

application*

retriever*

GetUser 准許取得使用者 讀取

application*

GetWebExperience 准許取得 Web 體驗 讀取

application*

web-experience*

ListApplications 准許列出應用程式 清單
ListConversations 准許列出應用程式的所有對話 清單

application*

ListDataSourceSyncJobs 准許取得資料來源同步任務歷史記錄 清單

application*

data-source*

index*

ListDataSources 准許列出應用程式和索引的資料來源 清單

application*

index*

ListDocuments 准許列出所有文件 清單

application*

index*

ListGroups 准許列出群組 清單

application*

index*

ListIndices 准許列出應用程式的授權 清單

application*

ListMessages 准許列出所有訊息 清單

application*

ListPlugins 准許列出應用程式的外掛程式 清單

application*

ListRetrievers 准許列出應用程式的擷取器 清單

application*

ListSubscriptions 准許列出訂閱 清單

application*

ListTagsForResource 准許列出資源的標籤 讀取

application

data-source

index

plugin

retriever

web-experience

ListUserLicenses 准許列出授權 清單
ListWebExperiences 准許列出應用程式的 Web 體驗 清單

application*

PutFeedback 准許放置有關交談訊息的意見回饋 寫入

application*

PutGroup 准許放置使用者群組 寫入

application*

index*

RemoveUserLicenses 准許移除一個或多個使用者的授權 寫入
StartDataSourceSyncJob 准許啟動資料來源同步任務 寫入

application*

data-source*

index*

StopDataSourceSyncJob 准許停止資料來源同步任務 寫入

application*

data-source*

index*

TagResource 准許使用指定金鑰值配對來標記資源 標記

application

data-source

index

plugin

retriever

web-experience

aws:RequestTag/${TagKey}

aws:TagKeys

UntagResource 准許從資源中刪除具有給定索引鍵的標籤 標記

application

data-source

index

plugin

retriever

web-experience

aws:TagKeys

UpdateApplication 准許更新應用程式 寫入

application*

UpdateChatControlsConfiguration 准許更新應用程式的聊天控制組態 寫入

application*

UpdateDataSource 准許更新 DataSource 寫入

application*

data-source*

index*

UpdateIndex 准許更新索引 寫入

application*

index*

UpdatePlugin 准許更新外掛程式 寫入

application*

plugin*

UpdateRetriever 准許更新擷取器 寫入

application*

retriever*

UpdateSubscription 准許更新訂閱 寫入

application*

subscription*

UpdateUser 准許更新使用者 寫入

application*

UpdateWebExperience 准許更新 WebExperience 寫入

application*

web-experience*

Amazon Q Business 定義的資源類型

下列資源類型由此服務定義,可用於IAM許可政策陳述式的 Resource元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表

資源類型 ARN 條件索引鍵
application arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}

aws:ResourceTag/${TagKey}

retriever arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/retriever/${RetrieverId}

aws:ResourceTag/${TagKey}

index arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}

aws:ResourceTag/${TagKey}

data-source arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}/data-source/${DataSourceId}

aws:ResourceTag/${TagKey}

plugin arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/plugin/${PluginId}

aws:ResourceTag/${TagKey}

web-experience arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/web-experience/${WebExperienceId}

aws:ResourceTag/${TagKey}

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