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

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

參考資料：

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

主題

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

Amazon Q in Connect 定義的動作

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

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

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

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

動作資料表的相依動作欄會顯示成功呼叫動作所需的其他許可。除了動作本身的許可之外，還可能需要這些許可。當動作指定相依動作時，這些相依性可能適用於針對該動作定義的其他資源，而不只是資料表中列出的第一個資源。

注意

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

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

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
ActivateMessageTemplate	准許啟用訊息範本	寫入	KnowledgeBase*
ActivateMessageTemplate	准許啟用訊息範本	寫入	MessageTemplate*
AllowVendedLogDeliveryForResource [僅限許可]	准許設定助理的付費日誌交付	許可管理	Assistant
CreateAIAgent	准許建立 AI 代理程式	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIAgentVersion	准許建立 AI 代理程式版本	寫入	AIAgent*
CreateAIAgentVersion	准許建立 AI 代理程式版本	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIGuardrail	准許建立 AI 護欄	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIGuardrailVersion	准許建立 AI 護欄版本	寫入	AIGuardrail*
CreateAIGuardrailVersion	准許建立 AI 護欄版本	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIPrompt	准許建立 AI 提示	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIPromptVersion	准許建立 AI 提示版本	寫入	AIPrompt*
CreateAIPromptVersion	准許建立 AI 提示版本	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateAssistant	准許建立助理	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateAssistantAssociation	准許建立助理及其他資源的關聯	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateContent	准許建立容器	寫入	KnowledgeBase*
CreateContent	准許建立容器	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateContentAssociation	准許建立內容關聯	寫入	Content*
			KnowledgeBase*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateKnowledgeBase	准許建立知識庫	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateMessageTemplate	准許建立訊息範本	寫入	KnowledgeBase*
CreateMessageTemplate	准許建立訊息範本	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateMessageTemplateAttachment	准許建立訊息範本的附件	寫入	KnowledgeBase*
CreateMessageTemplateAttachment	准許建立訊息範本的附件	寫入	MessageTemplate*
CreateMessageTemplateVersion	准許建立訊息範本的版本	寫入	KnowledgeBase*
CreateMessageTemplateVersion	准許建立訊息範本的版本	寫入	MessageTemplate*
CreateQuickResponse	准許建立快速回應	寫入		aws:TagKeys aws:RequestTag/${TagKey}
CreateSession	准許建立工作階段	寫入		aws:TagKeys aws:RequestTag/${TagKey}
DeactivateMessageTemplate	准許停用訊息範本	寫入	KnowledgeBase*
DeactivateMessageTemplate	准許停用訊息範本	寫入	MessageTemplate*
DeleteAIAgent	准許刪除 ai 代理程式	寫入	AIAgent*
DeleteAIAgentVersion	准許刪除 AI 代理程式版本	寫入	AIAgent*
DeleteAIGuardrail	准許刪除 ai 護欄	寫入	AIGuardrail*
DeleteAIGuardrailVersion	准許刪除 ai 護欄版本	寫入	AIGuardrail*
DeleteAIPrompt	准許刪除 AI 提示	寫入	AIPrompt*
DeleteAIPromptVersion	准許刪除 AI 提示版本	寫入	AIPrompt*
DeleteAssistant	准許刪除助理	寫入	Assistant*
DeleteAssistantAssociation	准許刪除助理關聯	寫入	AssistantAssociation*
DeleteContent	准許刪除內容	寫入	Content*
DeleteContent	准許刪除內容	寫入	KnowledgeBase*
DeleteContentAssociation	准許刪除內容關聯	寫入	Content*
			ContentAssociation*
			KnowledgeBase*
DeleteImportJob	准許刪除知識庫的匯入任務	寫入	KnowledgeBase*
DeleteKnowledgeBase	准許刪除知識庫	寫入	KnowledgeBase*
DeleteMessageTemplate	准許刪除訊息範本	寫入	KnowledgeBase*
DeleteMessageTemplate	准許刪除訊息範本	寫入	MessageTemplate*
DeleteMessageTemplateAttachment	准許從訊息範本中刪除附件	寫入	KnowledgeBase*
DeleteMessageTemplateAttachment	准許從訊息範本中刪除附件	寫入	MessageTemplate*
DeleteQuickResponse	准許刪除快速回應	寫入	KnowledgeBase*
DeleteQuickResponse	准許刪除快速回應	寫入	QuickResponse*
GetAIAgent	准許擷取 ai 代理程式的相關資訊	閱讀	AIAgent*
GetAIGuardrail	准許擷取 ai 護欄的相關資訊	閱讀	AIGuardrail*
GetAIPrompt	准許擷取有關 AI 提示的資訊	閱讀	AIPrompt*
GetAssistant	准許擷取助理的相關資訊	閱讀	Assistant*
GetAssistantAssociation	准許擷取助理關聯的相關資訊	閱讀	AssistantAssociation*
GetContent	准許擷取內容 (包含預先簽章的 URL) 以下載內容	閱讀	Content*
GetContent	准許擷取內容 (包含預先簽章的 URL) 以下載內容	閱讀	KnowledgeBase*
GetContentAssociation	准許擷取內容關聯的相關資訊	閱讀	Content*
			ContentAssociation*
			KnowledgeBase*
GetContentSummary	准許擷取內容的相關摘要資訊	閱讀	Content*
GetContentSummary	准許擷取內容的相關摘要資訊	閱讀	KnowledgeBase*
GetImportJob	准許擷取匯入任務的相關資訊	閱讀	KnowledgeBase*
GetKnowledgeBase	准許擷取知識庫的相關資訊	閱讀	KnowledgeBase*
GetMessageTemplate	准許擷取訊息範本	閱讀	KnowledgeBase*
			MessageTemplate*
				wisdom:MessageTemplate/RoutingProfileArn
GetNextMessage	准許擷取工作階段中的下一個訊息	閱讀	Session*
GetQuickResponse	准許擷取內容	閱讀	KnowledgeBase*
GetQuickResponse	准許擷取內容	閱讀	QuickResponse*
GetRecommendations	准許擷取指定工作階段的建議	閱讀	Session*
GetSession	准許擷取指定工作階段資訊	閱讀	Session*
ListAIAgentVersions	准許列出 ai 代理程式版本的相關資訊	清單	AIAgent*
ListAIAgents	准許列出 ai 代理程式的相關資訊	清單
ListAIGuardrailVersions	准許列出 ai 護欄版本的相關資訊	清單	AIGuardrail*
ListAIGuardrails	准許列出 ai 護欄的相關資訊	清單
ListAIPromptVersions	准許列出 ai 提示版本的相關資訊	清單	AIPrompt*
ListAIPrompts	准許列出 ai 提示的相關資訊	清單
ListAssistantAssociations	准許列出助理關聯的相關資訊	列出
ListAssistants	准許列出助理的相關資訊	清單
ListContentAssociations	准許列出內容關聯的相關資訊	清單	Content*
ListContentAssociations	准許列出內容關聯的相關資訊	清單	KnowledgeBase*
ListContents	准許列出包含知識庫的內容	列出	KnowledgeBase*
ListImportJobs	准許列出知識庫的相關資訊	清單	KnowledgeBase*
ListKnowledgeBases	准許列出知識庫的相關資訊	清單
ListMessageTemplateVersions	准許列出指定訊息範本的訊息範本版本	清單	KnowledgeBase*
ListMessageTemplateVersions	准許列出指定訊息範本的訊息範本版本	清單	MessageTemplate*
ListMessageTemplates	准許列出知識庫的訊息範本	清單	KnowledgeBase*
ListMessages	准許列出工作階段中的訊息	清單	Session*
ListQuickResponses	准許列出包含知識庫的快速回應	清單	KnowledgeBase*
ListTagsForResource	准許列出指定資源的標籤	閱讀
NotifyRecommendationsReceived	准許從指定助理的新增可用建立佇列移除指定的建議	寫入	Session*
PutFeedback	准許提交意見回饋	寫入	Assistant*
QueryAssistant	准許依據指定助理執行手動搜尋	閱讀	Assistant*
RemoveAssistantAIAgent	准許從助理中移除 ai 代理程式	寫入	Assistant*
RemoveKnowledgeBaseTemplateUri	准許從知識庫移除 URI 範本	寫入	KnowledgeBase*
RenderMessageTemplate	准許轉譯訊息範本	閱讀	KnowledgeBase*		wisdom:GetMessageTemplate
			MessageTemplate*
				wisdom:MessageTemplate/RoutingProfileArn
Retrieve	准許從指定的助理關聯擷取知識內容	閱讀	Assistant*
SearchContent	准許搜尋參照指定知識庫的內容。可用於依據其名稱取得特定內容資源	閱讀	KnowledgeBase*
SearchMessageTemplates	准許搜尋參考指定知識庫的訊息範本	閱讀	KnowledgeBase*
SearchMessageTemplates	准許搜尋參考指定知識庫的訊息範本	閱讀		wisdom:SearchFilter/RoutingProfileArn wisdom:SearchFilter/Qualifier
SearchQuickResponses	准許搜尋參照指定知識庫的快速回應。	閱讀	KnowledgeBase*		wisdom:GetQuickResponse
SearchQuickResponses	准許搜尋參照指定知識庫的快速回應。	閱讀		wisdom:SearchFilter/RoutingProfileArn
SearchSessions	准許搜尋參照指定助理的工作階段。可用於依據其名稱取得特定工作階段資源	閱讀
SendMessage	准許傳送訊息	寫入	Session*
StartContentUpload	准許取得 URL，以將內容上傳至知識庫	寫入	KnowledgeBase*
StartImportJob	准許建立多個快速回應	寫入	KnowledgeBase*
StartImportJob	准許建立多個快速回應	寫入		aws:TagKeys aws:RequestTag/${TagKey}
TagResource	准許將指定的標籤新增至指定資源	標記	Assistant
			AssistantAssociation
			Content
			ContentAssociation
			KnowledgeBase
			MessageTemplate
			QuickResponse
			Session
				aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
UntagResource	准許從指定的資源移除指定的標籤	標記	Assistant
			AssistantAssociation
			Content
			ContentAssociation
			KnowledgeBase
			MessageTemplate
			QuickResponse
			Session
				aws:TagKeys aws:ResourceTag/${TagKey}
UpdateAIAgent	准許更新 ai 代理程式的相關資訊	寫入	AIAgent*
UpdateAIGuardrail	准許更新 ai 護欄的相關資訊	寫入	AIGuardrail*
UpdateAIPrompt	准許更新 ai 提示的相關資訊	寫入	AIPrompt*
UpdateAssistantAIAgent	准許更新 ai 代理程式的助理資訊	寫入	Assistant*
UpdateContent	准許更新內容的相關資訊	寫入	Content*
UpdateContent	准許更新內容的相關資訊	寫入	KnowledgeBase*
UpdateKnowledgeBaseTemplateUri	准許更新知識庫的範本 URI	寫入	KnowledgeBase*
UpdateMessageTemplate	准許更新訊息範本的內容	寫入	KnowledgeBase*
UpdateMessageTemplate	准許更新訊息範本的內容	寫入	MessageTemplate*
UpdateMessageTemplateMetadata	准許更新訊息範本的中繼資料	寫入	KnowledgeBase*
UpdateMessageTemplateMetadata	准許更新訊息範本的中繼資料	寫入	MessageTemplate*
UpdateQuickResponse	准許更新快速回應的資訊或內容	寫入	KnowledgeBase*
UpdateQuickResponse	准許更新快速回應的資訊或內容	寫入	QuickResponse*
UpdateSession	准許更新工作階段	寫入	Session*
UpdateSessionData	准許更新存放在工作階段中的資料	寫入	Session*

Amazon Q in Connect 定義的資源類型

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

資源類型	ARN	條件索引鍵
AIAgent	`arn:${Partition}:wisdom:${Region}:${Account}:ai-agent/${AssistantId}/${AIAgentId}`	aws:ResourceTag/${TagKey}
AIPrompt	`arn:${Partition}:wisdom:${Region}:${Account}:ai-prompt/${AssistantId}/${AIPromptId}`	aws:ResourceTag/${TagKey}
AIGuardrail	`arn:${Partition}:wisdom:${Region}:${Account}:ai-guardrail/${AssistantId}/${AIGuardrailId}`	aws:ResourceTag/${TagKey}
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}
MessageTemplate	`arn:${Partition}:wisdom:${Region}:${Account}:message-template/${KnowledgeBaseId}/${MessageTemplateId}`	aws:ResourceTag/${TagKey} wisdom:MessageTemplate/RoutingProfileArn
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 全域條件內容索引鍵。

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

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

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

文件慣用形式

Amazon Q Developer

Amazon QLDB