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

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

參考資料：

了解如何設定此服務。
檢視可供此服務使用的 API 操作清單。
了解如何使用 IAM 許可政策來保護此服務及其資源。

主題

Amazon Q Business 定義的動作
Amazon Q Business 定義的資源類型
Amazon Q Business 的條件索引鍵

Amazon Q Business 定義的動作

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

動作資料表的存取層級欄說明動作的分類方式（列出、讀取、許可管理或標記）。此分類可協助您了解在政策中使用某動作時，該動作授予您的存取層級。如需存取層級的詳細資訊，請參閱政策摘要中的存取層級。

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

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

注意

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

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

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
AddUserLicenses	准許新增一個或多個使用者以取得授權	寫入
AllowVendedLogDeliveryForResource [僅限許可]	准許設定 Amazon Q Business 應用程式資源的付費日誌交付	許可管理	application*
AllowVendedLogDeliveryForResource [僅限許可]	准許設定 Amazon Q Business 應用程式資源的付費日誌交付	許可管理		aws:ResourceTag/${TagKey}
AssociatePermission	准許將資源型政策陳述式與應用程式建立關聯	寫入	application*		qbusiness:PutResourcePolicy
BatchDeleteDocument	准許批次刪除文件	寫入	application*
BatchDeleteDocument	准許批次刪除文件	寫入	index*
BatchPutDocument	准許批次放置文件	寫入	application*
BatchPutDocument	准許批次放置文件	寫入	index*
CancelSubscription	准許取消訂閱	寫入	application*
CancelSubscription	准許取消訂閱	寫入	subscription*
Chat	准許使用應用程式聊天	讀取	application*
ChatSync	准許使用應用程式同步聊天	讀取	application*
CheckDocumentAccess	准許檢查使用者是否可以存取文件	讀取	application*
CheckDocumentAccess	准許檢查使用者是否可以存取文件	讀取	index*
CreateAnonymousWebExperienceUrl	准許為匿名 Amazon Q Business Web 體驗建立唯一的 URL	寫入	application*
CreateAnonymousWebExperienceUrl	准許為匿名 Amazon Q Business Web 體驗建立唯一的 URL	寫入	web-experience*
CreateApplication	准許建立應用程式	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateChatResponseConfiguration	准許建立對應用程式的聊天回應組態	寫入	application*
CreateChatResponseConfiguration	准許建立對應用程式的聊天回應組態	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateDataAccessor	准許建立應用程式的 DataAccessor	寫入	application*		qbusiness:CreateDataAccessorWithTti
CreateDataAccessor	准許建立應用程式的 DataAccessor	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateDataAccessorWithTti [僅限許可]	准許建立 AWS 應用程式之以 DataAccessor 為基礎的 IAM Identity Center Trusted Token Issuer	寫入	application*
CreateDataSource	准許建立指定應用程式和索引的資料來源	寫入	application*
			index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateIndex	准許建立指定應用程式的索引	寫入	application*
CreateIndex	准許建立指定應用程式的索引	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateIntegration	准許為 Q Business 應用程式建立新的整合	寫入	application*
CreateIntegration	准許為 Q Business 應用程式建立新的整合	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateLicense	准許建立授權	寫入
CreatePlugin	准許建立指定應用程式的外掛程式	寫入	application*
CreatePlugin	准許建立指定應用程式的外掛程式	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateRetriever	准許建立指定應用程式的擷取器	寫入	application*
CreateRetriever	准許建立指定應用程式的擷取器	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateSubscription	准許建立訂閱	寫入	application*
CreateSubscription	准許建立訂閱	寫入		identitystore:UserId identitystore:GroupId
CreateUser	准許建立使用者	寫入	application*
CreateWebExperience	准許建立指定應用程式的 Web 體驗	寫入	application*
CreateWebExperience	准許建立指定應用程式的 Web 體驗	寫入		aws:RequestTag/${TagKey} aws:TagKeys
DeleteApplication	准許刪除應用程式	寫入	application*
DeleteAttachment	准許刪除目前聊天內容中的附件	寫入	application*
DeleteChatControlsConfiguration	准許刪除應用程式的聊天控制組態	寫入	application*
DeleteChatResponseConfiguration	准許刪除聊天回應組態	寫入	application*
DeleteChatResponseConfiguration	准許刪除聊天回應組態	寫入	chat-response-configuration*
DeleteConversation	准許刪除對話	寫入	application*
DeleteDataAccessor	准許刪除 DataAccessor	寫入	application*
DeleteDataAccessor	准許刪除 DataAccessor	寫入	data-accessor*
DeleteDataSource	准許刪除資料來源	寫入	application*
			data-source*
			index*
DeleteGroup	准許刪除群組	寫入	application*
DeleteGroup	准許刪除群組	寫入	index*
DeleteIndex	准許刪除索引	寫入	application*
DeleteIndex	准許刪除索引	寫入	index*
DeleteIntegration	准許刪除 Q Business 應用程式的整合	寫入	application*
DeleteIntegration	准許刪除 Q Business 應用程式的整合	寫入	integration*
DeletePlugin	准許刪除外掛程式	寫入	application*
DeletePlugin	准許刪除外掛程式	寫入	plugin*
DeleteRetriever	准許刪除擷取器	寫入	application*
DeleteRetriever	准許刪除擷取器	寫入	retriever*
DeleteUser	准許刪除使用者	寫入	application*
DeleteWebExperience	准許刪除 Web 體驗	寫入	application*
DeleteWebExperience	准許刪除 Web 體驗	寫入	web-experience*
DisableAclOnDataSource [僅限許可]	准許在建立 Amazon Q Business 資料來源資源時停用 ACL 爬取	寫入	application*
DisassociatePermission	准許取消以資源為基礎的政策陳述式與應用程式的關聯	寫入	application*		qbusiness:PutResourcePolicy
GetApplication	准許取得應用程式	讀取	application*
GetChatControlsConfiguration	准許取得應用程式的聊天控制項組態	清單	application*
GetChatResponseConfiguration	准許取得聊天回應組態	讀取	application*
GetChatResponseConfiguration	准許取得聊天回應組態	讀取	chat-response-configuration*
GetDataAccessor	准許取得 DataAccessor	讀取	application*
GetDataAccessor	准許取得 DataAccessor	讀取	data-accessor*
GetDataSource	准許取得資料來源	讀取	application*
			data-source*
			index*
GetGroup	准許取得群組	讀取	application*
GetGroup	准許取得群組	讀取	index*
GetIndex	准許取得索引	讀取	application*
GetIndex	准許取得索引	讀取	index*
GetIntegration	准許取得 Q Business 應用程式的整合	讀取	application*
GetIntegration	准許取得 Q Business 應用程式的整合	讀取	integration*
GetLicense	准許取得授權	讀取	user-license*
GetMedia	准許取得與系統訊息相關聯的媒體	讀取	application*
GetPlugin	准許取得外掛程式	讀取	application*
GetPlugin	准許取得外掛程式	讀取	plugin*
GetPolicy	准許取得以資源為基礎的應用程式政策	讀取	application*
GetRetriever	准許取得擷取器	讀取	application*
GetRetriever	准許取得擷取器	讀取	retriever*
GetUser	准許取得使用者	讀取	application*
GetWebExperience	准許取得 Web 體驗	讀取	application*
GetWebExperience	准許取得 Web 體驗	讀取	web-experience*
ListApplications	准許列出應用程式	清單
ListAttachments	准許列出目前聊天內容中的附件	清單	application*
ListChatResponseConfigurations	准許列出應用程式的聊天回應組態	清單	application*
ListConversations	准許列出應用程式的所有對話	清單	application*
ListDataAccessors	准許列出應用程式的 DataAccessors	清單	application*
ListDataSourceSyncJobs	准許取得資料來源同步任務歷史記錄	清單	application*
			data-source*
			index*
ListDataSources	准許列出應用程式和索引的資料來源	清單	application*
ListDataSources	准許列出應用程式和索引的資料來源	清單	index*
ListDocuments	准許列出所有文件	清單	application*
ListDocuments	准許列出所有文件	清單	index*
ListGroups	准許列出群組	清單	application*
ListGroups	准許列出群組	清單	index*
ListIndices	准許列出應用程式的授權	清單	application*
ListIntegrations	准許列出 Q Business 應用程式的所有整合	清單	application*
ListMessages	准許列出所有訊息	清單	application*
ListPluginActions	准許列出應用程式中外掛程式的外掛程式動作	讀取	application*
ListPluginActions	准許列出應用程式中外掛程式的外掛程式動作	讀取	plugin*
ListPluginTypeActions	准許列出外掛程式類型的所有動作	讀取
ListPluginTypeMetadata	准許列出所有外掛程式類型中繼資料	讀取
ListPlugins	准許列出應用程式的外掛程式	清單	application*
ListRetrievers	准許列出應用程式的擷取器	清單	application*
ListSubscriptions	准許列出訂閱	清單	application*
ListTagsForResource	准許列出資源的標籤	讀取	application
			chat-response-configuration
			data-accessor
			data-source
			index
			integration
			plugin
			retriever
			web-experience
ListUserLicenses	准許列出授權	清單
ListWebExperiences	准許列出應用程式的 Web 體驗	清單	application*
PutFeedback	准許放置有關交談訊息的意見回饋	寫入	application*
PutGroup	准許放置使用者群組	寫入	application*
PutGroup	准許放置使用者群組	寫入	index*
PutResourcePolicy [僅限許可]	准許將資源型政策陳述式放入應用程式	寫入	application*
RemoveUserLicenses	准許移除一個或多個使用者的授權	寫入
SearchRelevantContent	准許從 Amazon Q Business Application 搜尋相關內容	讀取	application*
StartDataSourceSyncJob	准許啟動資料來源同步任務	寫入	application*
			data-source*
			index*
StartDeployment	准許開始部署整合	寫入	application*
StartDeployment	准許開始部署整合	寫入	integration*
StopDataSourceSyncJob	准許停止資料來源同步任務	寫入	application*
			data-source*
			index*
TagResource	准許使用指定金鑰值配對來標記資源	標記	application
			chat-response-configuration
			data-accessor
			data-source
			index
			integration
			plugin
			retriever
			web-experience
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	准許從資源中刪除具有給定索引鍵的標籤	標記	application
			chat-response-configuration
			data-accessor
			data-source
			index
			integration
			plugin
			retriever
			web-experience
				aws:TagKeys
UpdateApplication	准許更新應用程式	寫入	application*
UpdateChatControlsConfiguration	准許更新應用程式的聊天控制組態	寫入	application*
UpdateChatResponseConfiguration	准許更新聊天回應組態	寫入	application*
UpdateChatResponseConfiguration	准許更新聊天回應組態	寫入	chat-response-configuration*
UpdateDataAccessor	准許更新 DataAccessor	寫入	application*
UpdateDataAccessor	准許更新 DataAccessor	寫入	data-accessor*
UpdateDataSource	准許更新資料來源	寫入	application*
			data-source*
			index*
UpdateIndex	准許更新索引	寫入	application*
UpdateIndex	准許更新索引	寫入	index*
UpdateIntegration	准許更新 Q Business 應用程式的整合	寫入	application*
UpdateIntegration	准許更新 Q Business 應用程式的整合	寫入	integration*
UpdatePlugin	准許更新外掛程式	寫入	application*
UpdatePlugin	准許更新外掛程式	寫入	plugin*
UpdateRetriever	准許更新擷取器	寫入	application*
UpdateRetriever	准許更新擷取器	寫入	retriever*
UpdateSubscription	准許更新訂閱	寫入	application*
UpdateSubscription	准許更新訂閱	寫入	subscription*
UpdateUser	准許更新使用者	寫入	application*
UpdateWebExperience	准許更新網路體驗	寫入	application*
UpdateWebExperience	准許更新網路體驗	寫入	web-experience*

Amazon Q Business 定義的資源類型

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

資源類型	ARN	條件索引鍵
application	`arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}`	aws:ResourceTag/${TagKey}
integration	`arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/integration/${IntegrationId}`	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}`
data-accessor	`arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/data-accessor/${DataAccessorId}`	aws:ResourceTag/${TagKey}
chat-response-configuration	`arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/chat-response-configuration/${ChatResponseConfigurationId}`	aws:ResourceTag/${TagKey}

Amazon Q Business 的條件索引鍵

Amazon Q Business 定義了下列條件索引鍵，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。

若要檢視所有服務可用的全域條件索引鍵，請參閱AWS 全域條件內容索引鍵。

條件索引鍵	描述	類型
aws:RequestTag/${TagKey}	依要求中傳遞的標籤來篩選存取權	字串
aws:ResourceTag/${TagKey}	依與資源關聯的標籤來篩選存取權	字串
aws:TagKeys	依要求中傳遞的標籤索引鍵來篩選存取權	ArrayOfString
identitystore:GroupId	依 IAM Identity Center 群組 ID 篩選存取權	ArrayOfString
identitystore:UserId	依 IAM Identity Center 使用者 ID 篩選存取權	ArrayOfString

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Amazon Q

Amazon Q Business Q 應用程式