Actions, resources, and condition keys for Amazon Q in Connect
Amazon Q in Connect (service prefix: wisdom) provides the following
service-specific operations, resources, actions, and condition keys for use in IAM permission
policies.
References:
-
Learn how to configure this service.
-
View a list of the API operations available for this service.
-
Learn how to secure this service and its resources by using IAM permission policies.
-
View the programmatic service authorization reference
for this service.
Topics
API operations defined by Amazon Q in Connect
The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.
| Operation | SDK client | IAM action | Condition key | Possible value(s) | Access level |
|---|---|---|---|---|---|
|
ActivateMessageTemplate |
qconnect |
Write |
|||
|
CreateAIAgent |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
CreateAIAgentVersion |
qconnect |
Write |
|||
|
CreateAIGuardrail |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
CreateAIGuardrailVersion |
qconnect |
Write |
|||
|
CreateAIPrompt |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
CreateAIPromptVersion |
qconnect |
Write |
|||
|
CreateAssistant |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
CreateAssistantAssociation |
qconnect |
Write |
|||
Tagging, Write |
|||||
iam:PassedToService |
wisdom.amazonaws.com |
Write |
|||
|
CreateContent |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
CreateContentAssociation |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
CreateKnowledgeBase |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
CreateMessageTemplate |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
CreateMessageTemplateAttachment |
qconnect |
Write |
|||
|
CreateMessageTemplateVersion |
qconnect |
Write |
|||
|
CreateQuickResponse |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
CreateSession |
qconnect |
Write |
|||
Tagging, Write |
|||||
|
DeactivateMessageTemplate |
qconnect |
Write |
|||
|
DeleteAIAgent |
qconnect |
Write |
|||
|
DeleteAIAgentVersion |
qconnect |
Write |
|||
|
DeleteAIGuardrail |
qconnect |
Write |
|||
|
DeleteAIGuardrailVersion |
qconnect |
Write |
|||
|
DeleteAIPrompt |
qconnect |
Write |
|||
|
DeleteAIPromptVersion |
qconnect |
Write |
|||
|
DeleteAssistant |
qconnect |
Write |
|||
|
DeleteAssistantAssociation |
qconnect |
Write |
|||
|
DeleteContent |
qconnect |
Write |
|||
|
DeleteContentAssociation |
qconnect |
Write |
|||
|
DeleteImportJob |
qconnect |
Write |
|||
|
DeleteKnowledgeBase |
qconnect |
Write |
|||
|
DeleteMessageTemplate |
qconnect |
Write |
|||
|
DeleteMessageTemplateAttachment |
qconnect |
Write |
|||
|
DeleteQuickResponse |
qconnect |
Write |
|||
|
GetAIAgent |
qconnect |
Read |
|||
|
GetAIGuardrail |
qconnect |
Read |
|||
|
GetAIPrompt |
qconnect |
Read |
|||
|
GetAssistant |
qconnect |
Read |
|||
|
GetAssistantAssociation |
qconnect |
Read |
|||
|
GetContent |
qconnect |
Read |
|||
|
GetContentAssociation |
qconnect |
Read |
|||
|
GetContentSummary |
qconnect |
Read |
|||
|
GetImportJob |
qconnect |
Read |
|||
|
GetKnowledgeBase |
qconnect |
Read |
|||
|
GetMessageTemplate |
qconnect |
Read |
|||
|
GetNextMessage |
qconnect |
Read |
|||
|
GetQuickResponse |
qconnect |
Read |
|||
|
GetRecommendations |
qconnect |
Read |
|||
|
GetSession |
qconnect |
Read |
|||
|
ListAIAgentVersions |
qconnect |
List |
|||
|
ListAIAgents |
qconnect |
List |
|||
|
ListAIGuardrailVersions |
qconnect |
List |
|||
|
ListAIGuardrails |
qconnect |
List |
|||
|
ListAIPromptVersions |
qconnect |
List |
|||
|
ListAIPrompts |
qconnect |
List |
|||
|
ListAssistantAssociations |
qconnect |
List |
|||
|
ListAssistants |
qconnect |
List |
|||
|
ListContentAssociations |
qconnect |
List |
|||
|
ListContents |
qconnect |
List |
|||
|
ListImportJobs |
qconnect |
List |
|||
|
ListKnowledgeBases |
qconnect |
List |
|||
|
ListMessageTemplateVersions |
qconnect |
List |
|||
|
ListMessageTemplates |
qconnect |
List |
|||
|
ListMessages |
qconnect |
List |
|||
|
ListModels |
qconnect |
List |
|||
|
ListQuickResponses |
qconnect |
List |
|||
|
ListSpans |
qconnect |
List |
|||
|
ListTagsForResource |
qconnect |
Read |
|||
|
NotifyRecommendationsReceived |
qconnect |
Write |
|||
|
PutFeedback |
qconnect |
Write |
|||
|
QueryAssistant |
qconnect |
Read |
|||
|
RemoveAssistantAIAgent |
qconnect |
Write |
|||
|
RemoveKnowledgeBaseTemplateUri |
qconnect |
Write |
|||
|
RenderMessageTemplate |
qconnect |
Read |
|||
Read |
|||||
|
Retrieve |
qconnect |
Read |
|||
|
SearchContent |
qconnect |
Read |
|||
|
SearchMessageTemplates |
qconnect |
Read |
|||
|
SearchQuickResponses |
qconnect |
Read |
|||
Read |
|||||
|
SearchSessions |
qconnect |
Read |
|||
|
SendMessage |
qconnect |
Write |
|||
|
StartContentUpload |
qconnect |
Write |
|||
|
StartImportJob |
qconnect |
Write |
|||
|
TagResource |
qconnect |
Tagging, Write |
|||
|
UntagResource |
qconnect |
Tagging, Write |
|||
|
UpdateAIAgent |
qconnect |
Write |
|||
|
UpdateAIGuardrail |
qconnect |
Write |
|||
|
UpdateAIPrompt |
qconnect |
Write |
|||
|
UpdateAssistantAIAgent |
qconnect |
Write |
|||
|
UpdateContent |
qconnect |
Write |
|||
|
UpdateKnowledgeBaseTemplateUri |
qconnect |
Write |
|||
|
UpdateMessageTemplate |
qconnect |
Write |
|||
|
UpdateMessageTemplateMetadata |
qconnect |
Write |
|||
|
UpdateQuickResponse |
qconnect |
Write |
|||
|
UpdateSession |
qconnect |
Write |
|||
|
UpdateSessionData |
qconnect |
Write |
|||
|
CreateAssistant |
wisdom |
Write |
|||
Tagging, Write |
|||||
|
CreateAssistantAssociation |
wisdom |
Write |
|||
Tagging, Write |
|||||
iam:PassedToService |
wisdom.amazonaws.com |
Write |
|||
|
CreateContent |
wisdom |
Write |
|||
Tagging, Write |
|||||
|
CreateKnowledgeBase |
wisdom |
Write |
|||
Tagging, Write |
|||||
|
CreateQuickResponse |
wisdom |
Write |
|||
Tagging, Write |
|||||
|
CreateSession |
wisdom |
Write |
|||
Tagging, Write |
|||||
|
DeleteAssistant |
wisdom |
Write |
|||
|
DeleteAssistantAssociation |
wisdom |
Write |
|||
|
DeleteContent |
wisdom |
Write |
|||
|
DeleteImportJob |
wisdom |
Write |
|||
|
DeleteKnowledgeBase |
wisdom |
Write |
|||
|
DeleteQuickResponse |
wisdom |
Write |
|||
|
GetAssistant |
wisdom |
Read |
|||
|
GetAssistantAssociation |
wisdom |
Read |
|||
|
GetContent |
wisdom |
Read |
|||
|
GetContentSummary |
wisdom |
Read |
|||
|
GetImportJob |
wisdom |
Read |
|||
|
GetKnowledgeBase |
wisdom |
Read |
|||
|
GetQuickResponse |
wisdom |
Read |
|||
|
GetRecommendations |
wisdom |
Read |
|||
|
GetSession |
wisdom |
Read |
|||
|
ListAssistantAssociations |
wisdom |
List |
|||
|
ListAssistants |
wisdom |
List |
|||
|
ListContents |
wisdom |
List |
|||
|
ListImportJobs |
wisdom |
List |
|||
|
ListKnowledgeBases |
wisdom |
List |
|||
|
ListQuickResponses |
wisdom |
List |
|||
|
ListTagsForResource |
wisdom |
Read |
|||
|
NotifyRecommendationsReceived |
wisdom |
Write |
|||
|
QueryAssistant |
wisdom |
Read |
|||
|
RemoveKnowledgeBaseTemplateUri |
wisdom |
Write |
|||
|
SearchContent |
wisdom |
Read |
|||
|
SearchQuickResponses |
wisdom |
Read |
|||
Read |
|||||
|
SearchSessions |
wisdom |
Read |
|||
|
StartContentUpload |
wisdom |
Write |
|||
|
StartImportJob |
wisdom |
Write |
|||
|
TagResource |
wisdom |
Tagging, Write |
|||
|
UntagResource |
wisdom |
Tagging, Write |
|||
|
UpdateContent |
wisdom |
Write |
|||
|
UpdateKnowledgeBaseTemplateUri |
wisdom |
Write |
|||
|
UpdateQuickResponse |
wisdom |
Write |
Actions defined by Amazon Q in Connect
You can specify the following actions in the Action element of an IAM
policy statement. Use policies to grant permissions to perform an operation in AWS. When
you use an action in a policy, you usually allow or deny access to the API operation or CLI
command with the same name. However, in some cases, a single action controls access to more
than one operation. Alternatively, some operations require several different actions.
| Actions | Description | Resource types (*required) | Condition keys | Access level |
|---|---|---|---|---|
Grants permission to activate a message template |
Write |
|||
Grants permission to create an ai agent |
Write |
|||
Grants permission to create an ai agent version |
Write |
|||
Grants permission to create an ai guardrail |
Write |
|||
Grants permission to create an ai guardrail version |
Write |
|||
Grants permission to create an ai prompt |
Write |
|||
Grants permission to create an ai prompt version |
Write |
|||
Grants permission to create an assistant |
Write |
|||
Grants permission to create an association between an assistant and another resource |
Write |
|||
Grants permission to create content |
Write |
|||
Grants permission to create a content association |
Write |
|||
Grants permission to create a knowledge base |
Write |
|||
Grants permission to create a message template |
Write |
|||
Grants permission to create an attachment to a message template |
Write |
|||
Grants permission to create a version of a message template |
Write |
|||
Grants permission to create quick response |
Write |
|||
Grants permission to create a session |
Write |
|||
Grants permission to deactivate a message template |
Write |
|||
Grants permission to delete an ai agent |
Write |
|||
Grants permission to delete an ai agent version |
Write |
|||
Grants permission to delete an ai guardrail |
Write |
|||
Grants permission to delete an ai guardrail version |
Write |
|||
Grants permission to delete an ai prompt |
Write |
|||
Grants permission to delete an ai prompt version |
Write |
|||
Grants permission to delete an assistant |
Write |
|||
Grants permission to delete an assistant association |
Write |
|||
Grants permission to delete content |
Write |
|||
Grants permission to delete a content association |
Write |
|||
Grants permission to delete a import job of a knowledge base |
Write |
|||
Grants permission to delete a knowledge base |
Write |
|||
Grants permission to delete a message template |
Write |
|||
Grants permission to delete an attachment from a message template |
Write |
|||
Grants permission to delete quick response |
Write |
|||
Grants permission to retrieve information about an ai agent |
Read |
|||
Grants permission to retrieve information about an ai guardrail |
Read |
|||
Grants permission to retrieve information about an ai prompt |
Read |
|||
Grants permission to retrieve information about an assistant |
Read |
|||
Grants permission to retrieve information about an assistant association |
Read |
|||
Grants permission to retrieve content, including a pre-signed URL to download the content |
Read |
|||
Grants permission to retrieve information about a content association |
Read |
|||
Grants permission to retrieve summary information about the content |
Read |
|||
Grants permission to retrieve information about the import job |
Read |
|||
Grants permission to retrieve information about the knowledge base |
Read |
|||
Grants permission to retrieve a message template |
Read |
|||
Grants permission to retrieve for next message in a session |
Read |
|||
Grants permission to retrieve content |
Read |
|||
Grants permission to retrieve recommendations for the specified session |
Read |
|||
Grants permission to retrieve information for a specified session |
Read |
|||
Grants permission to list information about ai agent versions |
List |
|||
Grants permission to list information about ai agents |
List |
|||
Grants permission to list information about ai guardrail versions |
List |
|||
Grants permission to list information about ai guardrails |
List |
|||
Grants permission to list information about ai prompt versions |
List |
|||
Grants permission to list information about ai prompts |
List |
|||
Grants permission to list information about assistant associations |
List |
|||
Grants permission to list information about assistants |
List |
|||
Grants permission to list information about content associations |
List |
|||
Grants permission to list the content with a knowledge base |
List |
|||
Grants permission to list information about knowledge bases |
List |
|||
Grants permission to list information about knowledge bases |
List |
|||
Grants permission to list message template versions for the specified message template |
List |
|||
Grants permission to list the message templates for a knowledge base |
List |
|||
Grants permission to list messages in a session |
List |
|||
Grants permission to list models available for an assistant |
List |
|||
Grants permission to list the quick response with a knowledge base |
List |
|||
Grants permission to list AI agent traces for a session |
List |
|||
Grants permission to list the tags for the specified resource |
Read |
|||
Grants permission to remove the specified recommendations from the specified assistant's queue of newly available recommendations |
Write |
|||
Grants permission to submit feedback |
Write |
|||
Grants permission to perform a manual search against the specified assistant |
Read |
|||
Grants permission to remove an ai agent from an assistant |
Write |
|||
Grants permission to remove a URI template from a knowledge base |
Write |
|||
Grants permission to render a message template |
Read |
|||
Grants permission to retrieve knowledge content from specified assistant associations |
Read |
|||
Grants permission to search for content referencing a specified knowledge base. Can be used to get a specific content resource by its name |
Read |
|||
Grants permission to search for message templates referencing a specified knowledge base |
Read |
|||
Grants permission to search for quick response referencing a specified knowledge base |
Read |
|||
Grants permission to search for sessions referencing a specified assistant. Can be used to et a specific session resource by its name |
Read |
|||
Grants permission to send a message |
Write |
|||
Grants permission to get a URL to upload content to a knowledge base |
Write |
|||
Grants permission to create multiple quick responses |
Write |
|||
Grants permission to add the specified tags to the specified resource |
Tagging, Write |
|||
Grants permission to remove the specified tags from the specified resource |
Tagging, Write |
|||
Grants permission to update information about an ai agent |
Write |
|||
Grants permission to update information about an ai guardrail |
Write |
|||
Grants permission to update information about an ai prompt |
Write |
|||
Grants permission to update assistant information about an ai agent |
Write |
|||
Grants permission to update information about the content |
Write |
|||
Grants permission to update the template URI of a knowledge base |
Write |
|||
Grants permission to update content of the message template |
Write |
|||
Grants permission to update metadata of the message template |
Write |
|||
Grants permission to update information or content of the quick response |
Write |
|||
Grants permission to update a session |
Write |
|||
Grants permission to update data stored in a session |
Write |
Permission-only actions for Amazon Q in Connect
The following actions are defined by Amazon Q in Connect but are not directly invocable through any API operation. They can only be used in IAM policy statements to grant or deny permissions.
| Actions | Description | Resource types (*required) | Condition keys | Access level |
|---|---|---|---|---|
Grants permission to configure vended log delivery for an assistant |
Permissions management, Write |
Resource types defined by Amazon Q in Connect
The following resource types are defined by this service and can be used in the
Resource element of IAM permission policy statements.
| Resource types | ARN | Condition keys |
|---|---|---|
arn:${Partition}:wisdom:${Region}:${Account}:ai-agent/${AssistantId}/${AIAgentId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:ai-guardrail/${AssistantId}/${AIGuardrailId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:ai-prompt/${AssistantId}/${AIPromptId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:assistant/${AssistantId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:association/${AssistantId}/${AssistantAssociationId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:content/${KnowledgeBaseId}/${ContentId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:content-association/${KnowledgeBaseId}/${ContentId}/${ContentAssociationId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:knowledge-base/${KnowledgeBaseId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:message-template/${KnowledgeBaseId}/${MessageTemplateId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:quick-response/${KnowledgeBaseId}/${QuickResponseId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:session/${AssistantId}/${SessionId} |
Condition keys for Amazon Q in Connect
Amazon Q in Connect defines the following condition keys that can be used in the
Condition element of an IAM policy.
| Condition keys | Description | Type |
|---|---|---|
Filters access by the tags that are passed in the request |
String |
|
Filters access by the tags associated with the resource |
String |
|
Filters access by the tag keys that are passed in the request |
ArrayOfString |
|
Filters access by the connect routing profile arns associated with the resource |
ArrayOfARN |
|
Filters access by the qualifiers that are passed in the request |
ArrayOfString |
|
Filters access by the connect routing profile arn that is passed in the request |
ARN |