Avis de fin de support : le 15 septembre 2025, le support pour Amazon Lex V1 AWS sera interrompu. Après le 15 septembre 2025, vous ne pourrez plus accéder à la console Amazon Lex V1 ni aux ressources Amazon Lex V1. Si vous utilisez Amazon Lex V2, consultez plutôt le [guide Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 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. # GetBot Renvoie des informations de métadonnées pour un bot spécifique. Vous devez fournir le nom du bot ainsi que la version ou l'alias du bot. Cette opération exige des autorisations pour l’action `lex:GetBot`. ## Syntaxe de la demande ``` GET /bots/name/versions/versionoralias HTTP/1.1 ``` ## Paramètres de demande URI La demande utilise les paramètres URI suivants. ** [name](#API_GetBot_RequestSyntax) ** Le nom du bot. Le nom est sensible à la casse. Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50. Modèle : `^([A-Za-z]_?)+$` Obligatoire : oui ** [versionoralias](#API_GetBot_RequestSyntax) ** Version ou alias du bot. Obligatoire : oui ## Corps de la demande La demande n’a pas de corps de requête. ## Syntaxe de la réponse ``` HTTP/1.1 200 Content-type: application/json { "abortStatement": { "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "checksum": "string", "childDirected": boolean, "clarificationPrompt": { "maxAttempts": number, "messages": [ { "content": "string", "contentType": "string", "groupNumber": number } ], "responseCard": "string" }, "createdDate": number, "description": "string", "detectSentiment": boolean, "enableModelImprovements": boolean, "failureReason": "string", "idleSessionTTLInSeconds": number, "intents": [ { "intentName": "string", "intentVersion": "string" } ], "lastUpdatedDate": number, "locale": "string", "name": "string", "nluIntentConfidenceThreshold": number, "status": "string", "version": "string", "voiceId": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [abortStatement](#API_GetBot_ResponseSyntax) ** Message renvoyé par Amazon Lex lorsque l'utilisateur choisit de mettre fin à la conversation sans la terminer. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md). Type : objet [Statement](API_Statement.md) ** [checksum](#API_GetBot_ResponseSyntax) ** Somme de contrôle du bot utilisée pour identifier une révision spécifique de la `$LATEST` version du bot. Type : Chaîne ** [childDirected](#API_GetBot_ResponseSyntax) ** Pour chaque bot Amazon Lex créé avec Amazon Lex Model Building Service, vous devez indiquer si votre utilisation d'Amazon Lex est liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la loi COPPA (Children's Online Privacy Protection Act) en spécifiant `true` ou `false` dans le `childDirected` champ. `true`En spécifiant dans ce `childDirected` champ, vous confirmez que votre utilisation d'Amazon Lex **est** liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la COPPA. `false`En spécifiant dans ce `childDirected` champ, vous confirmez que votre utilisation d'Amazon Lex **n'est pas** liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la COPPA. Vous ne pouvez pas spécifier de valeur par défaut pour le `childDirected` champ qui ne reflète pas exactement si votre utilisation d'Amazon Lex est liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la COPPA. Si votre utilisation d'Amazon Lex concerne un site Web, un programme ou une autre application destinés, en tout ou en partie, à des enfants de moins de 13 ans, vous devez obtenir le consentement parental vérifiable requis en vertu de la COPPA. Pour plus d'informations concernant l'utilisation d'Amazon Lex en relation avec des sites Web, des programmes ou d'autres applications destinés ou ciblés, en tout ou en partie, aux enfants de moins de 13 ans, consultez la [FAQ Amazon Lex.](https://aws.amazon.com/lex/faqs#data-security) Type : Boolean ** [clarificationPrompt](#API_GetBot_ResponseSyntax) ** Le message qu'utilise Amazon Lex lorsqu'il ne comprend pas la demande de l'utilisateur. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md). Type : objet [Prompt](API_Prompt.md) ** [createdDate](#API_GetBot_ResponseSyntax) ** Date de création du bot. Type : Timestamp ** [description](#API_GetBot_ResponseSyntax) ** Description du bot. Type : Chaîne Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200. ** [detectSentiment](#API_GetBot_ResponseSyntax) ** Indique si les déclarations des utilisateurs doivent être envoyées à Amazon Comprehend pour analyse des sentiments. Type : Boolean ** [enableModelImprovements](#API_GetBot_ResponseSyntax) ** Indique si le bot utilise des améliorations de précision. `true`indique que le bot utilise les améliorations, sinon,`false`. Type : Boolean ** [failureReason](#API_GetBot_ResponseSyntax) ** Dans `status` l'affirmative`FAILED`, Amazon Lex explique pourquoi il n'a pas réussi à créer le bot. Type : Chaîne ** [idleSessionTTLInSeconds](#API_GetBot_ResponseSyntax) ** Durée maximale en secondes pendant laquelle Amazon Lex conserve les données collectées au cours d'une conversation. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md). Type : Integer Plage valide : Valeur minimum de 60. Valeur maximum de 86 400. ** [intents](#API_GetBot_ResponseSyntax) ** Tableau d’objets `intent`. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md). Type : tableau d’objets [Intent](API_Intent.md) ** [lastUpdatedDate](#API_GetBot_ResponseSyntax) ** Date à laquelle le bot a été mis à jour. Lorsque vous créez une ressource, la date de création et la date de dernière mise à jour sont identiques. Type : Timestamp ** [locale](#API_GetBot_ResponseSyntax) ** La localisation cible du bot. Type : Chaîne Valeurs valides : `de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR` ** [name](#API_GetBot_ResponseSyntax) ** Le nom du bot. Type : Chaîne Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50. Modèle : `^([A-Za-z]_?)+$` ** [nluIntentConfidenceThreshold](#API_GetBot_ResponseSyntax) ** Le score qui détermine l'endroit où Amazon Lex insère le `AMAZON.FallbackIntent` ou les deux lorsqu'il renvoie des intentions alternatives dans une [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)réponse [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)ou. `AMAZON.KendraSearchIntent` `AMAZON.FallbackIntent`est inséré si le score de confiance à toutes fins utiles est inférieur à cette valeur. `AMAZON.KendraSearchIntent`n'est inséré que s'il est configuré pour le bot. Type : double Plage valide : Valeur minimum de 0. Valeur maximale de 1. ** [status](#API_GetBot_ResponseSyntax) ** État du bot. Lorsque le statut est défini, `BUILDING` Amazon Lex crée le bot à des fins de test et d'utilisation. Si le statut du bot est`READY_BASIC_TESTING`, vous pouvez le tester en utilisant les énoncés exacts spécifiés dans les intentions du bot. Lorsque le bot est prêt pour un test complet ou pour être exécuté, le statut est`READY`. En cas de problème lors de la création du bot, le statut est le suivant `FAILED` et le `failureReason` champ explique pourquoi le bot n'a pas été créé. Si le bot a été enregistré mais n'a pas été créé, le statut est`NOT_BUILT`. Type : Chaîne Valeurs valides : `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` ** [version](#API_GetBot_ResponseSyntax) ** La version du bot. Pour un nouveau bot, la version est toujours`$LATEST`. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères. Modèle : `\$LATEST|[0-9]+` ** [voiceId](#API_GetBot_ResponseSyntax) ** L'identifiant vocal Amazon Polly utilisé par Amazon Lex pour l'interaction vocale avec l'utilisateur. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md). Type : Chaîne ## Erreurs ** BadRequestException ** La demande n'est pas bien formulée. Par exemple, une valeur n'est pas valide ou un champ obligatoire est manquant. Vérifiez les valeurs des champs, puis réessayez. Code d’état HTTP : 400 ** InternalFailureException ** Une erreur interne Amazon Lex s'est produite. Réessayez votre demande. Code d’état HTTP : 500 ** LimitExceededException ** La demande a dépassé une limite. Réessayez votre demande. Code d’état HTTP : 429 ** NotFoundException ** La ressource spécifiée dans la demande est introuvable. Vérifiez la ressource et réessayez. Code d’état HTTP :404 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBot) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBot) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBot) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBot) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBot) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBot) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBot) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBot) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBot) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBot)