Actions, ressources et clés de condition pour Amazon Lex

Amazon Lex (préfixe de service : lex) fournit les ressources, actions et clés de condition spécifiques au service suivantes en vue de leur utilisation 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.

Actions définies par Amazon Lex

Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. 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.

La colonne Types de ressources indique si chaque action prend en charge les autorisations au niveau des ressources. S'il n'y a pas de valeur pour cette colonne, vous devez indiquer toutes les ressources (« * ») dans l'élément Resource de votre déclaration de politique. Si la colonne inclut un type de ressource, vous pouvez indiquer un ARN de ce type dans une déclaration avec cette action. Si l'action comporte une ou plusieurs ressources requises, l'appelant doit être autorisé à utiliser l'action avec ces ressources. Les ressources requises sont indiquées dans le tableau par un astérisque (*). Si vous limitez l'accès aux ressources avec l'Resourceélément dans une politique IAM, vous devez inclure un ARN ou un modèle pour chaque type de ressource requis. Certaines actions prennent en charge plusieurs types de ressources. Si le type de ressource est facultatif (non indiqué comme obligatoire), vous pouvez choisir d'utiliser l'un, mais pas l'autre.

La colonne Clés de condition inclut des clés que vous pouvez spécifier dans l'élément Condition d'une déclaration de politique. Pour plus d'informations sur les clés de condition associées aux ressources du service, consultez la colonne Clés de condition du tableau des types de ressources.

Note

Les clés de condition des ressources sont répertoriées dans le tableau Types de ressources. Vous pouvez trouver un lien vers le type de ressource qui s'applique à une action dans la colonne Types de ressources (* obligatoire) du tableau Actions. Le type de ressource indiqué dans le tableau Types de ressources inclut la colonne Clés de condition, qui contient les clés de condition de ressource qui s'appliquent à une action dans le tableau Actions.

Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Actions.

Actions	Description	Niveau d'accès	Types de ressources (*obligatoire)	Clés de condition	Actions dépendantes
CreateBotVersion	Crée une version basée sur la version $LATEST du robot spécifié	Écrire	bot version*
CreateIntentVersion	Crée une version basée sur la version $LATEST de l'intention spécifiée	Écrire	intent version*
CreateSlotTypeVersion	Crée une version basée sur la version $LATEST du type d'emplacement spécifié	Écrire	slottype version*
DeleteBot	Supprime toutes les versions d'un robot	Écrire	bot version*
DeleteBotAlias	Supprime un alias pour un robot spécifique	Écrire	bot alias*
DeleteBotChannelAssociation	Supprime l'association entre un alias de robot Amazon Lex et une plateforme de messagerie	Écrire	channel*
DeleteBotVersion	Supprime une version spécifique d'un robot	Écrire	bot version*
DeleteIntent	Supprime toutes les versions d'une intention	Écrire	intent version*
DeleteIntentVersion	Supprime une version spécifique d'une intention	Écrire	intent version*
DeleteSession	Supprime les informations de session pour un bot, un alias et un ID utilisateur spécifiés	Écrire	bot alias
			bot version
DeleteSlotType	Supprime toutes les versions d'un type d'emplacement	Écrire	slottype version*
DeleteSlotTypeVersion	Supprime une version spécifique d'un type d'emplacement	Écrire	slottype version*
DeleteUtterances	Supprime les informations qu'Amazon Lex tient à jour pour des énoncés sur un robot et pour un userId spécifiques	Écrire	bot version*
GetBot	Renvoie des informations pour un robot spécifique. En plus du nom du robot, l'alias ou la version du robot est nécessaire	Lecture	bot alias
			bot version
GetBotAlias	Renvoie des informations sur un alias de robot Amazon Lex	Lecture	bot alias*
GetBotAliases	Renvoie la liste des alias pour un robot Amazon Lex donné	Liste
GetBotChannelAssociation	Renvoie des informations sur l'association entre un robot Amazon Lex et une plateforme de messagerie	Lecture	channel*
GetBotChannelAssociations	Renvoie la liste de tous les canaux associés à un robot individuel	Liste	channel*
GetBotVersions	Renvoie des informations pour toutes les versions d'un robot spécifique	Liste	bot version*
GetBots	Renvoie des informations pour la version $LATEST de tous les robots soumis à des filtres fournis par le client	Liste
GetBuiltinIntent	Renvoie des informations sur une intention intégrée	Lecture
GetBuiltinIntents	Obtient la liste des intentions intégrées qui répondent aux critères spécifiés	Lecture
GetBuiltinSlotTypes	Obtient la liste des types d'emplacement intégrés qui répondent aux critères spécifiés	Lecture
GetExport	Exporte la ressource Amazon Lex dans un format demandé	Lecture	bot version*
GetImport	Obtient des informations sur une tâche d'importation démarrée avec StartImport	Lecture
GetIntent	Renvoie des informations pour une intention spécifique. En plus du nom de l'intention, vous devez également spécifier la version de l'intention	Lecture	intent version*
GetIntentVersions	Renvoie des informations pour toutes les versions d'une intention spécifique	Liste	intent version*
GetIntents	Renvoie des informations pour la version $LATEST de toutes les intentions soumises à des filtres fournis par le client	Liste
GetMigration	Accorde l'autorisation d'afficher une migration en cours ou terminée	Lecture
GetMigrations	Accorde l'autorisation d'afficher la liste des migrations depuis Amazon Lex v1 vers Amazon Lex v2	Liste
GetSession	Renvoie les informations de session pour un robot, un alias et un ID utilisateur spécifiés	Lecture	bot alias
			bot version
GetSlotType	Renvoie des informations sur une version spécifique d'un type d'emplacement. En plus de spécifier le nom du type d'emplacement, vous devez également spécifier la version du type d'emplacement	Lecture	slottype version*
GetSlotTypeVersions	Renvoie des informations pour toutes les versions d'un type d'emplacement spécifique	Liste	slottype version*
GetSlotTypes	Renvoie des informations pour la version $LATEST de tous les types d'emplacement soumis à des filtres fournis par le client	Liste
GetUtterancesView	Renvoie une vue de données d'énoncé d'agrégation pour les versions d'un robot pour une période récente	Liste	bot version*
ListTagsForResource	Répertorie les balises d'une ressource Lex	Lecture	bot
			bot alias
			channel
PostContent	Envoie l'entrée utilisateur (texte ou voix) à Amazon Lex	Écrire	bot alias
			bot version
PostText	Envoie l'entrée utilisateur (texte uniquement) à Amazon Lex	Écrire	bot alias
			bot version
PutBot	Crée ou met à jour la version $LATEST d'un robot conversationnel Amazon Lex	Écrire	bot version*
				aws:TagKeys aws:RequestTag/${TagKey}
PutBotAlias	Crée ou met à jour un alias pour le robot spécifique	Écrire	bot alias*
				aws:TagKeys aws:RequestTag/${TagKey}
PutIntent	Crée ou met à jour la version $LATEST d'une intention	Écrire	intent version*
PutSession	Crée une nouvelle session ou modifie une session existante avec un robot Amazon Lex	Écrire	bot alias
			bot version
PutSlotType	Crée ou met à jour la version $LATEST d'un type d'emplacement	Écrire	slottype version*
StartImport	Démarre une tâche pour importer une ressource dans Amazon Lex	Écrire
StartMigration	Accorde l'autorisation de migrer un robot depuis Amazon Lex v1 vers Amazon Lex v2	Écrire	bot version*
TagResource	Ajoute ou remplace des balises pour une ressource Lex	Balisage	bot
			bot alias
			channel
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Supprime des balises d'une ressource Lex	Balisage	bot
			bot alias
			channel
				aws:TagKeys aws:RequestTag/${TagKey}

Types de ressources définis par Amazon Lex

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. Chaque action du tableau Actions identifie les types de ressources pouvant être spécifiés avec cette action. Un type de ressource peut également définir les clés de condition que vous pouvez inclure dans une politique. Ces clés sont affichées dans la dernière colonne du tableau. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Types de ressources.

Types de ressources	ARN	Clés de condition
bot	arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}	aws:ResourceTag/${TagKey}
bot version	arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotVersion}	aws:ResourceTag/${TagKey}
bot alias	arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotAlias}	aws:ResourceTag/${TagKey}
channel	arn:${Partition}:lex:${Region}:${Account}:bot-channel:${BotName}:${BotAlias}:${ChannelName}	aws:ResourceTag/${TagKey}
intent version	arn:${Partition}:lex:${Region}:${Account}:intent:${IntentName}:${IntentVersion}
slottype version	arn:${Partition}:lex:${Region}:${Account}:slottype:${SlotName}:${SlotVersion}

Clés de condition pour Amazon Lex

Amazon Lex définit les clés de condition suivantes que vous pouvez utiliser dans l'élément Condition d'une stratégie IAM. Vous pouvez utiliser ces clés pour affiner les conditions d'application de la déclaration de politique. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Clés de condition.

Pour afficher les clés de condition globales disponibles pour tous les services, consultez Clés de condition globales disponibles.

Clés de condition	Description	Type
aws:RequestTag/${TagKey}	Filtre l'accès en fonction des balises de la demande	Chaîne
aws:ResourceTag/${TagKey}	Filtre l'accès en fonction des balises attachées à une ressource Lex	Chaîne
aws:TagKeys	Filtre l'accès en fonction de l'ensemble des clés d'identification dans la demande	ArrayOfString
lex:associatedIntents	Vous permet de contrôler l'accès en fonction des intentions incluses dans la demande	ArrayOfString
lex:associatedSlotTypes	Vous permet de contrôler l'accès en fonction des types d'emplacement inclus dans la demande	ArrayOfString
lex:channelType	Vous permet de contrôler l'accès en fonction du type de canal inclus dans la demande	Chaîne