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

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

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

Amazon Q in Connect 定義的動作

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

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

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

注意

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

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

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
CreateAssistant	准許建立助理	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateAssistantAssociation	准許建立助理及其他資源的關聯	寫入	Assistant*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateContent	准許建立容器	寫入	KnowledgeBase*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateContentAssociation	授予建立內容關聯的權限	寫入	Content*
			KnowledgeBase*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateKnowledgeBase	准許建立知識庫	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateQuickResponse	准許建立快速回應	寫入	KnowledgeBase*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateSession	准許建立工作階段	寫入	Assistant*
				aws:TagKeys aws:RequestTag/${TagKey}
DeleteAssistant	准許刪除助理	寫入	Assistant*
DeleteAssistantAssociation	准許刪除助理關聯	寫入	Assistant*
			AssistantAssociation*
DeleteContent	准許刪除內容	寫入	Content*
			KnowledgeBase*
DeleteContentAssociation	授予刪除內容關聯的權限	寫入	Content*
			ContentAssociation*
			KnowledgeBase*
DeleteImportJob	准許刪除知識庫的匯入任務	寫入	KnowledgeBase*
DeleteKnowledgeBase	准許刪除知識庫	寫入	KnowledgeBase*
DeleteQuickResponse	准許刪除快速回應	寫入	KnowledgeBase*
			QuickResponse*
GetAssistant	准許擷取助理的相關資訊	讀取	Assistant*
GetAssistantAssociation	准許擷取助理關聯的相關資訊	讀取	Assistant*
			AssistantAssociation*
GetContent	准許擷取內容 (包含預先簽章的 URL) 以下載內容	讀取	Content*
			KnowledgeBase*
GetContentAssociation	授與擷取內容關聯相關資訊的權限	讀取	Content*
			ContentAssociation*
			KnowledgeBase*
GetContentSummary	准許擷取內容的相關摘要資訊	讀取	Content*
			KnowledgeBase*
GetImportJob	准許擷取匯入任務的相關資訊	讀取	KnowledgeBase*
GetKnowledgeBase	准許擷取知識庫的相關資訊	讀取	KnowledgeBase*
GetQuickResponse	准許擷取內容	讀取	KnowledgeBase*
			QuickResponse*
GetRecommendations	准許擷取指定工作階段的建議	讀取	Assistant*
GetSession	准許擷取指定工作階段資訊	讀取	Assistant*
			Session*
ListAssistantAssociations	准許列出助理關聯的相關資訊	列出	Assistant*
ListAssistants	准許列出助理的相關資訊	清單
ListContentAssociations	授與列出內容關聯相關資訊的權限	清單	Content*
			KnowledgeBase*
ListContents	准許列出包含知識庫的內容	列出	KnowledgeBase*
ListImportJobs	准許列出知識庫的相關資訊	清單	KnowledgeBase*
ListKnowledgeBases	准許列出知識庫的相關資訊	清單
ListQuickResponses	准許列出包含知識庫的快速回應	清單	KnowledgeBase*
ListTagsForResource	准許列出指定資源的標籤	讀取
NotifyRecommendationsReceived	准許從指定助理的新增可用建立佇列移除指定的建議	寫入	Assistant*
PutFeedback	准許提交意見回饋	寫入	Assistant*
QueryAssistant	准許依據指定助理執行手動搜尋	讀取	Assistant*
RemoveKnowledgeBaseTemplateUri	准許從知識庫移除 URI 範本	寫入	KnowledgeBase*
SearchContent	准許搜尋參照指定知識庫的內容。可用於依據其名稱取得特定內容資源	讀取	KnowledgeBase*
SearchQuickResponses	准許搜尋參照指定知識庫的快速回應。	讀取	KnowledgeBase*		wisdom:GetQuickResponse
				wisdom:SearchFilter/RoutingProfileArn
SearchSessions	准許搜尋參照指定助理的工作階段。可用於依據其名稱取得特定工作階段資源	讀取	Assistant*
StartContentUpload	准許取得 URL，以將內容上傳至知識庫	寫入	KnowledgeBase*
StartImportJob	准許建立多個快速回應	寫入	KnowledgeBase*
				aws:TagKeys aws:RequestTag/${TagKey}
TagResource	准許將指定的標籤新增至指定資源	標記	Assistant
			AssistantAssociation
			Content
			ContentAssociation
			KnowledgeBase
			QuickResponse
			Session
				aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
UntagResource	准許從指定的資源移除指定的標籤	標記	Assistant
			AssistantAssociation
			Content
			ContentAssociation
			KnowledgeBase
			QuickResponse
			Session
				aws:TagKeys aws:ResourceTag/${TagKey}
UpdateContent	准許更新內容的相關資訊	寫入	Content*
			KnowledgeBase*
UpdateKnowledgeBaseTemplateUri	准許更新知識庫的範本 URI	寫入	KnowledgeBase*
UpdateQuickResponse	准許更新快速回應的資訊或內容	寫入	KnowledgeBase*
			QuickResponse*
UpdateSession	授予更新工作階段的權限	寫入	Assistant*
			Session*

Amazon Q in Connect 定義的資源類型

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

資源類型	ARN	條件索引鍵
Assistant	arn:${Partition}:wisdom:${Region}:${Account}:assistant/${AssistantId}	aws:ResourceTag/${TagKey}
AssistantAssociation	arn:${Partition}:wisdom:${Region}:${Account}:association/${AssistantId}/${AssistantAssociationId}	aws:ResourceTag/${TagKey}
Content	arn:${Partition}:wisdom:${Region}:${Account}:content/${KnowledgeBaseId}/${ContentId}	aws:ResourceTag/${TagKey}
ContentAssociation	arn:${Partition}:wisdom:${Region}:${Account}:content-association/${KnowledgeBaseId}/${ContentId}/${ContentAssociationId}	aws:ResourceTag/${TagKey}
KnowledgeBase	arn:${Partition}:wisdom:${Region}:${Account}:knowledge-base/${KnowledgeBaseId}	aws:ResourceTag/${TagKey}
Session	arn:${Partition}:wisdom:${Region}:${Account}:session/${AssistantId}/${SessionId}	aws:ResourceTag/${TagKey}
QuickResponse	arn:${Partition}:wisdom:${Region}:${Account}:quick-response/${KnowledgeBaseId}/${QuickResponseId}	aws:ResourceTag/${TagKey}

Amazon Q in Connect 的條件索引鍵

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

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

條件索引鍵	描述	類型
aws:RequestTag/${TagKey}	依要求中傳遞的標籤來篩選存取權	字串
aws:ResourceTag/${TagKey}	依與資源關聯的標籤來篩選存取權	字串
aws:TagKeys	依要求中傳遞的標籤索引鍵來篩選存取權	ArrayOfString
wisdom:SearchFilter/RoutingProfileArn	依請求中傳遞的連線路由描述檔 arn 來篩選存取權	ARN