Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Actions, ressources et clés de condition pour Amazon Q in Connect
Amazon Q dans Connect (préfixe du service : wisdom) fournit les opérations, ressources, actions et clés de condition spécifiques au service suivantes à utiliser dans les politiques d'autorisation IAM.
Références :
-
Découvrez comment configurer ce service.
-
Affichez la liste des opérations d'API disponibles pour ce service.
-
Découvrez comment protéger ce service et ses ressources avec les stratégies d'autorisation IAM.
-
Consultez le référence d'autorisation de service programmatique
pour ce service.
Rubriques
Opérations d'API définies par Amazon Q dans Connect
Le tableau suivant associe les opérations d'API aux actions IAM qu'elles autorisent. Seules les clés de condition qui ont des valeurs statiques pour l'API et l'action données sont répertoriées ; pour l'ensemble complet des clés de condition prises en charge par chaque action, consultez le Tableau des actions.
| Opération | Client du SDK | Action IAM | Clé de condition | Valeur (s) possible (s) | Niveau d’accès |
|---|---|---|---|---|---|
|
ActivateMessageTemplate |
qconnect |
Écrire |
|||
|
CreateAIAgent |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateAIAgentVersion |
qconnect |
Écrire |
|||
|
CreateAIGuardrail |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateAIGuardrailVersion |
qconnect |
Écrire |
|||
|
CreateAIPrompt |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateAIPromptVersion |
qconnect |
Écrire |
|||
|
CreateAssistant |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateAssistantAssociation |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
iam:PassedToService |
wisdom.amazonaws.com |
Écrire |
|||
|
CreateContent |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateContentAssociation |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateKnowledgeBase |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateMessageTemplate |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateMessageTemplateAttachment |
qconnect |
Écrire |
|||
|
CreateMessageTemplateVersion |
qconnect |
Écrire |
|||
|
CreateQuickResponse |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateSession |
qconnect |
Écrire |
|||
Marquer, écrire |
|||||
|
DeactivateMessageTemplate |
qconnect |
Écrire |
|||
|
DeleteAIAgent |
qconnect |
Écrire |
|||
|
DeleteAIAgentVersion |
qconnect |
Écrire |
|||
|
DeleteAIGuardrail |
qconnect |
Écrire |
|||
|
DeleteAIGuardrailVersion |
qconnect |
Écrire |
|||
|
DeleteAIPrompt |
qconnect |
Écrire |
|||
|
DeleteAIPromptVersion |
qconnect |
Écrire |
|||
|
DeleteAssistant |
qconnect |
Écrire |
|||
|
DeleteAssistantAssociation |
qconnect |
Écrire |
|||
|
DeleteContent |
qconnect |
Écrire |
|||
|
DeleteContentAssociation |
qconnect |
Écrire |
|||
|
DeleteImportJob |
qconnect |
Écrire |
|||
|
DeleteKnowledgeBase |
qconnect |
Écrire |
|||
|
DeleteMessageTemplate |
qconnect |
Écrire |
|||
|
DeleteMessageTemplateAttachment |
qconnect |
Écrire |
|||
|
DeleteQuickResponse |
qconnect |
Écrire |
|||
|
GetAIAgent |
qconnect |
Lecture |
|||
|
GetAIGuardrail |
qconnect |
Lecture |
|||
|
GetAIPrompt |
qconnect |
Lecture |
|||
|
GetAssistant |
qconnect |
Lecture |
|||
|
GetAssistantAssociation |
qconnect |
Lecture |
|||
|
GetContent |
qconnect |
Lecture |
|||
|
GetContentAssociation |
qconnect |
Lecture |
|||
|
GetContentSummary |
qconnect |
Lecture |
|||
|
GetImportJob |
qconnect |
Lecture |
|||
|
GetKnowledgeBase |
qconnect |
Lecture |
|||
|
GetMessageTemplate |
qconnect |
Lecture |
|||
|
GetNextMessage |
qconnect |
Lecture |
|||
|
GetQuickResponse |
qconnect |
Lecture |
|||
|
GetRecommendations |
qconnect |
Lecture |
|||
|
GetSession |
qconnect |
Lecture |
|||
|
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 |
Lecture |
|||
|
NotifyRecommendationsReceived |
qconnect |
Écrire |
|||
|
PutFeedback |
qconnect |
Écrire |
|||
|
QueryAssistant |
qconnect |
Lecture |
|||
|
RegisterAssistantReplicaKey |
qconnect |
Écrire |
|||
|
RegisterKnowledgeBaseReplicaKey |
qconnect |
Écrire |
|||
|
RemoveAssistantAIAgent |
qconnect |
Écrire |
|||
|
RemoveKnowledgeBaseTemplateUri |
qconnect |
Écrire |
|||
|
RenderMessageTemplate |
qconnect |
Lecture |
|||
Lecture |
|||||
|
Retrieve |
qconnect |
Lecture |
|||
|
SearchContent |
qconnect |
Lecture |
|||
|
SearchMessageTemplates |
qconnect |
Lecture |
|||
|
SearchQuickResponses |
qconnect |
Lecture |
|||
Lecture |
|||||
|
SearchSessions |
qconnect |
Lecture |
|||
|
SendMessage |
qconnect |
Écrire |
|||
|
StartContentUpload |
qconnect |
Écrire |
|||
|
StartImportJob |
qconnect |
Écrire |
|||
|
TagResource |
qconnect |
Marquer, écrire |
|||
|
UntagResource |
qconnect |
Marquer, écrire |
|||
|
UpdateAIAgent |
qconnect |
Écrire |
|||
|
UpdateAIGuardrail |
qconnect |
Écrire |
|||
|
UpdateAIPrompt |
qconnect |
Écrire |
|||
|
UpdateAssistantAIAgent |
qconnect |
Écrire |
|||
|
UpdateContent |
qconnect |
Écrire |
|||
|
UpdateKnowledgeBaseTemplateUri |
qconnect |
Écrire |
|||
|
UpdateMessageTemplate |
qconnect |
Écrire |
|||
|
UpdateMessageTemplateMetadata |
qconnect |
Écrire |
|||
|
UpdateQuickResponse |
qconnect |
Écrire |
|||
|
UpdateSession |
qconnect |
Écrire |
|||
|
UpdateSessionData |
qconnect |
Écrire |
|||
|
CreateAssistant |
wisdom |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateAssistantAssociation |
wisdom |
Écrire |
|||
Marquer, écrire |
|||||
iam:PassedToService |
wisdom.amazonaws.com |
Écrire |
|||
|
CreateContent |
wisdom |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateKnowledgeBase |
wisdom |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateQuickResponse |
wisdom |
Écrire |
|||
Marquer, écrire |
|||||
|
CreateSession |
wisdom |
Écrire |
|||
Marquer, écrire |
|||||
|
DeleteAssistant |
wisdom |
Écrire |
|||
|
DeleteAssistantAssociation |
wisdom |
Écrire |
|||
|
DeleteContent |
wisdom |
Écrire |
|||
|
DeleteImportJob |
wisdom |
Écrire |
|||
|
DeleteKnowledgeBase |
wisdom |
Écrire |
|||
|
DeleteQuickResponse |
wisdom |
Écrire |
|||
|
GetAssistant |
wisdom |
Lecture |
|||
|
GetAssistantAssociation |
wisdom |
Lecture |
|||
|
GetContent |
wisdom |
Lecture |
|||
|
GetContentSummary |
wisdom |
Lecture |
|||
|
GetImportJob |
wisdom |
Lecture |
|||
|
GetKnowledgeBase |
wisdom |
Lecture |
|||
|
GetQuickResponse |
wisdom |
Lecture |
|||
|
GetRecommendations |
wisdom |
Lecture |
|||
|
GetSession |
wisdom |
Lecture |
|||
|
ListAssistantAssociations |
wisdom |
List |
|||
|
ListAssistants |
wisdom |
List |
|||
|
ListContents |
wisdom |
List |
|||
|
ListImportJobs |
wisdom |
List |
|||
|
ListKnowledgeBases |
wisdom |
List |
|||
|
ListQuickResponses |
wisdom |
List |
|||
|
ListTagsForResource |
wisdom |
Lecture |
|||
|
NotifyRecommendationsReceived |
wisdom |
Écrire |
|||
|
QueryAssistant |
wisdom |
Lecture |
|||
|
RemoveKnowledgeBaseTemplateUri |
wisdom |
Écrire |
|||
|
SearchContent |
wisdom |
Lecture |
|||
|
SearchQuickResponses |
wisdom |
Lecture |
|||
Lecture |
|||||
|
SearchSessions |
wisdom |
Lecture |
|||
|
StartContentUpload |
wisdom |
Écrire |
|||
|
StartImportJob |
wisdom |
Écrire |
|||
|
TagResource |
wisdom |
Marquer, écrire |
|||
|
UntagResource |
wisdom |
Marquer, écrire |
|||
|
UpdateContent |
wisdom |
Écrire |
|||
|
UpdateKnowledgeBaseTemplateUri |
wisdom |
Écrire |
|||
|
UpdateQuickResponse |
wisdom |
Écrire |
Actions définies par Amazon Q in Connect
Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. Pour chaque action, le tableau répertorie les types de ressources et les clés de condition pris en charge par cette action. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une politique, vous autorisez ou refusez généralement l'accès à l'opération d'API ou à la commande CLI portant le même nom. Toutefois, dans certains cas, une seule action contrôle l'accès à plusieurs opérations. D'autres opérations, quant à elles, requièrent plusieurs actions différentes.
| Actions | Description | Types de ressources (*obligatoire) | Clés de condition | Niveau d’accès |
|---|---|---|---|---|
Autorise l'activation d'un modèle de message |
Écrire |
|||
Autorise la création d'un agent IA |
Écrire |
|||
Autorise la création d'une version de l'agent AI |
Écrire |
|||
Autorise la création d'un garde-corps aérien |
Écrire |
|||
Autorise la création d'une version AI GUARDRAIL |
Écrire |
|||
Autorise la création d'une invite d'aide |
Écrire |
|||
Autorise la création d'une version AI prompt |
Écrire |
|||
Accorde l'autorisation de créer un assistant |
Écrire |
|||
Accorde l'autorisation de créer une association entre un assistant et une autre ressource |
Écrire |
|||
Accorde l'autorisation de créer du contenu |
Écrire |
|||
Autorise la création d'une association de contenu |
Écrire |
|||
Accorde l'autorisation de créer une base de connaissances |
Écrire |
|||
Autorise la création d'un modèle de message |
Écrire |
|||
Autorise la création d'une pièce jointe à un modèle de message |
Écrire |
|||
Autorise la création d'une version d'un modèle de message |
Écrire |
|||
Accorde l'autorisation de créer une réponse rapide |
Écrire |
|||
Accorde l'autorisation de créer une session |
Écrire |
|||
Autorise la désactivation d'un modèle de message |
Écrire |
|||
Autorise la suppression d'un agent d'IA |
Écrire |
|||
Autorise la suppression d'une version d'un agent IA |
Écrire |
|||
Autorise la suppression d'un garde-corps aérien |
Écrire |
|||
Autorise la suppression d'une version de Air Guardrail |
Écrire |
|||
Autorise la suppression d'une invite d'aide |
Écrire |
|||
Autorise la suppression d'une version d'AI prompt |
Écrire |
|||
Accorde l'autorisation de supprimer un assistant |
Écrire |
|||
Accorde l'autorisation de supprimer une association d'assistant |
Écrire |
|||
Accorde l'autorisation de supprimer du contenu |
Écrire |
|||
Autorise la suppression d'une association de contenu |
Écrire |
|||
Accorde l'autorisation de supprimer une tâche d'importation d'une base de connaissances |
Écrire |
|||
Accorde l'autorisation de supprimer une base de connaissances |
Écrire |
|||
Autorise la suppression d'un modèle de message |
Écrire |
|||
Autorise la suppression d'une pièce jointe d'un modèle de message |
Écrire |
|||
Accorde l'autorisation de supprimer une réponse rapide |
Écrire |
|||
Accorde l'autorisation de récupérer des informations sur un agent d'IA |
Lecture |
|||
Autorise la récupération d'informations sur un garde-corps aérien |
Lecture |
|||
Autorise la récupération des informations relatives à une invite d'aide |
Lecture |
|||
Accorde l'autorisation de récupérer les informations sur un assistant |
Lecture |
|||
Accorde l'autorisation de récupérer les informations sur une association d'assistant |
Lecture |
|||
Accorde l'autorisation de récupérer du contenu, y compris une URL présignée pour télécharger le contenu |
Lecture |
|||
Autorise la récupération des informations relatives à une association de contenu |
Lecture |
|||
Accorde l'autorisation de récupérer des informations récapitulatives sur du contenu |
Lecture |
|||
Accorde l'autorisation de récupérer des informations sur une tâche d'importation |
Lecture |
|||
Accorde l'autorisation de récupérer des informations sur la base de connaissances |
Lecture |
|||
Autorise la récupération d'un modèle de message |
Lecture |
|||
Accorde l'autorisation de récupérer le message suivant dans une session |
Lecture |
|||
Accorde l'autorisation d'extraire du contenu |
Lecture |
|||
Accorde l'autorisation de récupérer des recommandations pour la session spécifiée |
Lecture |
|||
Accorde l'autorisation de récupérer des informations pour une session spécifiée |
Lecture |
|||
Autorise à répertorier les informations sur les versions des agents AI |
List |
|||
Autorise la publication d'informations sur les agents de l'IA |
List |
|||
Permet de répertorier des informations sur les versions de AI Guardrail |
List |
|||
Autorise la publication d'informations sur les garde-corps aériens |
List |
|||
Autorise la liste des informations relatives aux versions rapides de AI |
List |
|||
Autorise à répertorier les informations relatives aux invites d'aide |
List |
|||
Accorde l'autorisation de répertorier des informations sur des associations d'assistant |
List |
|||
Accorde l'autorisation de répertorier des informations sur les assistants |
List |
|||
Autorise à répertorier les informations relatives aux associations de contenu |
List |
|||
Accorde l'autorisation de répertorier le contenu avec une base de connaissances |
List |
|||
Accorde l'autorisation de récupérer des informations sur des bases de connaissances |
List |
|||
Accorde l'autorisation de récupérer des informations sur des bases de connaissances |
List |
|||
Accorde l'autorisation de répertorier les versions des modèles de message pour le modèle de message spécifié |
List |
|||
Permet de répertorier les modèles de messages pour une base de connaissances |
List |
|||
Autorise la liste des messages dans une session |
List |
|||
Autorise un assistant à répertorier les modèles disponibles |
List |
|||
Accorde l'autorisation de répertorier une réponse rapide dans une base de connaissances |
List |
|||
Autorise à répertorier les traces des agents d'IA pour une session |
List |
|||
Accorde l'autorisation de répertorier des balises pour la ressource spécifiée |
Lecture |
|||
Accorde l'autorisation de supprimer les recommandations spécifiées de la file d'attente des recommandations nouvellement disponibles de l'assistant spécifié |
Écrire |
|||
Accorde l'autorisation de soumettre des commentaires |
Écrire |
|||
Accorde l'autorisation d'effectuer une recherche manuelle avec l'assistant spécifié |
Lecture |
|||
Autorise l'enregistrement d'une réplique de clé KMS pour un assistant |
Écrire |
|||
Autorise l'enregistrement d'une réplique de clé KMS pour une base de connaissances |
Écrire |
|||
Autorise la suppression d'un agent d'IA d'un assistant |
Écrire |
|||
Accorde l'autorisation de supprimer un modèle d'URI d'une base de connaissances |
Écrire |
|||
Autorise le rendu d'un modèle de message |
Lecture |
|||
Accorde l'autorisation de récupérer le contenu des connaissances auprès d'associations d'assistants spécifiées |
Lecture |
|||
Accorde l'autorisation de rechercher du contenu référençant une base de connaissances spécifiée. Peut être utilisé pour obtenir une ressource de contenu spécifique par son nom |
Lecture |
|||
Autorise la recherche de modèles de messages faisant référence à une base de connaissances spécifiée |
Lecture |
|||
Accorde l'autorisation de rechercher une réponse rapide en se référant à une base de connaissances spécifiée |
Lecture |
|||
Accorde l'autorisation de rechercher des sessions référençant un assistant spécifié. Peut être utilisé pour définir une ressource de session spécifique par son nom |
Lecture |
|||
Autorise l'envoi d'un message |
Écrire |
|||
Accorde l'autorisation d'obtenir une URL pour charger du contenu dans une base de connaissances |
Écrire |
|||
Accorde l'autorisation de créer plusieurs réponses rapides |
Écrire |
|||
Accorde l'autorisation d'ajouter les balises spécifiées à la ressource spécifiée |
Marquer, écrire |
|||
Accorde l'autorisation de supprimer les balises spécifiées de la ressource spécifiée |
Marquer, écrire |
|||
Autorise la mise à jour des informations relatives à un agent d'IA |
Écrire |
|||
Autorise la mise à jour des informations relatives à un garde-corps aérien |
Écrire |
|||
Autorise la mise à jour des informations relatives à une invite d'aide |
Écrire |
|||
Autorise la mise à jour des informations d'assistant concernant un agent d'IA |
Écrire |
|||
Accorde l'autorisation de mettre à jour les informations sur le contenu |
Écrire |
|||
Accorde l'autorisation de mettre à jour l'URI du modèle d'une base de connaissances |
Écrire |
|||
Autorise la mise à jour du contenu du modèle de message |
Écrire |
|||
Autorise la mise à jour des métadonnées du modèle de message |
Écrire |
|||
Accorde l'autorisation de mettre à jour les informations ou le contenu de la réponse rapide |
Écrire |
|||
Autorise la mise à jour d'une session |
Écrire |
|||
Autorise la mise à jour des données stockées dans une session |
Écrire |
Permission-only actions pour Amazon Q dans Connect
Les actions suivantes sont définies par Amazon Q dans Connect mais ne sont directement invocables via aucune opération d'API. Ils ne peuvent être utilisés que dans les déclarations de politique IAM pour accorder ou refuser des autorisations.
| Actions | Description | Types de ressources (*obligatoire) | Clés de condition | Niveau d’accès |
|---|---|---|---|---|
Autorise un assistant à configurer la livraison automatique de journaux |
Gestion des autorisations, Rédaction |
Types de ressources définis par Amazon Q in Connect
Ce service définit les types de ressources suivants, qui peuvent être utilisés dans l' Resource élément des déclarations de politique d'autorisation IAM.
| Types de ressources | ARN | Clés de condition |
|---|---|---|
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} |
Clés de condition pour Amazon Q in Connect
Amazon Q in Connect définit les clés de condition suivantes que vous pouvez utiliser dans l'élément Condition d'une politique IAM.
| Clés de condition | Description | Type |
|---|---|---|
Filtre l'accès en fonction des identifications transmises dans la demande |
String |
|
Filtre l'accès en fonction des identifications associées à la ressource |
String |
|
Filtre l'accès en fonction des clés d'identification qui sont transmises dans la demande |
ArrayOfString |
|
Filtre l'accès par le profil de routage de connexion (arns) associé à la ressource |
ArrayOfARN |
|
Filtre l'accès en fonction des qualificatifs transmis dans la demande |
ArrayOfString |
|
Filtre l'accès par le profil de routage connect arn qui est transmis dans la demande |
ARN |