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.

# Référence d’API
<a name="API_Reference"></a>

Cette section fournit de la documentation sur les opérations de l'API Amazon Lex. Pour obtenir la liste des régions AWS dans lesquelles Amazon Lex est disponible, consultez la section [Régions et points de terminaison AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html#lex_region) dans le manuel *Amazon Web Services General Reference*.

**Rubriques**
+ [Actions](API_Operations.md)
+ [Types de données](API_Types.md)

# Actions
<a name="API_Operations"></a>

Les actions suivantes sont prises en charge par Amazon Lex Model Building Service :
+  [CreateBotVersion](API_CreateBotVersion.md) 
+  [CreateIntentVersion](API_CreateIntentVersion.md) 
+  [CreateSlotTypeVersion](API_CreateSlotTypeVersion.md) 
+  [DeleteBot](API_DeleteBot.md) 
+  [DeleteBotAlias](API_DeleteBotAlias.md) 
+  [DeleteBotChannelAssociation](API_DeleteBotChannelAssociation.md) 
+  [DeleteBotVersion](API_DeleteBotVersion.md) 
+  [DeleteIntent](API_DeleteIntent.md) 
+  [DeleteIntentVersion](API_DeleteIntentVersion.md) 
+  [DeleteSlotType](API_DeleteSlotType.md) 
+  [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md) 
+  [DeleteUtterances](API_DeleteUtterances.md) 
+  [GetBot](API_GetBot.md) 
+  [GetBotAlias](API_GetBotAlias.md) 
+  [GetBotAliases](API_GetBotAliases.md) 
+  [GetBotChannelAssociation](API_GetBotChannelAssociation.md) 
+  [GetBotChannelAssociations](API_GetBotChannelAssociations.md) 
+  [GetBots](API_GetBots.md) 
+  [GetBotVersions](API_GetBotVersions.md) 
+  [GetBuiltinIntent](API_GetBuiltinIntent.md) 
+  [GetBuiltinIntents](API_GetBuiltinIntents.md) 
+  [GetBuiltinSlotTypes](API_GetBuiltinSlotTypes.md) 
+  [GetExport](API_GetExport.md) 
+  [GetImport](API_GetImport.md) 
+  [GetIntent](API_GetIntent.md) 
+  [GetIntents](API_GetIntents.md) 
+  [GetIntentVersions](API_GetIntentVersions.md) 
+  [GetMigration](API_GetMigration.md) 
+  [GetMigrations](API_GetMigrations.md) 
+  [GetSlotType](API_GetSlotType.md) 
+  [GetSlotTypes](API_GetSlotTypes.md) 
+  [GetSlotTypeVersions](API_GetSlotTypeVersions.md) 
+  [GetUtterancesView](API_GetUtterancesView.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [PutBot](API_PutBot.md) 
+  [PutBotAlias](API_PutBotAlias.md) 
+  [PutIntent](API_PutIntent.md) 
+  [PutSlotType](API_PutSlotType.md) 
+  [StartImport](API_StartImport.md) 
+  [StartMigration](API_StartMigration.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 

Les actions suivantes sont prises en charge par Amazon Lex Runtime Service :
+  [DeleteSession](API_runtime_DeleteSession.md) 
+  [GetSession](API_runtime_GetSession.md) 
+  [PostContent](API_runtime_PostContent.md) 
+  [PostText](API_runtime_PostText.md) 
+  [PutSession](API_runtime_PutSession.md) 

# Service de modélisme Amazon Lex
<a name="API_Operations_Amazon_Lex_Model_Building_Service"></a>

Les actions suivantes sont prises en charge par Amazon Lex Model Building Service :
+  [CreateBotVersion](API_CreateBotVersion.md) 
+  [CreateIntentVersion](API_CreateIntentVersion.md) 
+  [CreateSlotTypeVersion](API_CreateSlotTypeVersion.md) 
+  [DeleteBot](API_DeleteBot.md) 
+  [DeleteBotAlias](API_DeleteBotAlias.md) 
+  [DeleteBotChannelAssociation](API_DeleteBotChannelAssociation.md) 
+  [DeleteBotVersion](API_DeleteBotVersion.md) 
+  [DeleteIntent](API_DeleteIntent.md) 
+  [DeleteIntentVersion](API_DeleteIntentVersion.md) 
+  [DeleteSlotType](API_DeleteSlotType.md) 
+  [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md) 
+  [DeleteUtterances](API_DeleteUtterances.md) 
+  [GetBot](API_GetBot.md) 
+  [GetBotAlias](API_GetBotAlias.md) 
+  [GetBotAliases](API_GetBotAliases.md) 
+  [GetBotChannelAssociation](API_GetBotChannelAssociation.md) 
+  [GetBotChannelAssociations](API_GetBotChannelAssociations.md) 
+  [GetBots](API_GetBots.md) 
+  [GetBotVersions](API_GetBotVersions.md) 
+  [GetBuiltinIntent](API_GetBuiltinIntent.md) 
+  [GetBuiltinIntents](API_GetBuiltinIntents.md) 
+  [GetBuiltinSlotTypes](API_GetBuiltinSlotTypes.md) 
+  [GetExport](API_GetExport.md) 
+  [GetImport](API_GetImport.md) 
+  [GetIntent](API_GetIntent.md) 
+  [GetIntents](API_GetIntents.md) 
+  [GetIntentVersions](API_GetIntentVersions.md) 
+  [GetMigration](API_GetMigration.md) 
+  [GetMigrations](API_GetMigrations.md) 
+  [GetSlotType](API_GetSlotType.md) 
+  [GetSlotTypes](API_GetSlotTypes.md) 
+  [GetSlotTypeVersions](API_GetSlotTypeVersions.md) 
+  [GetUtterancesView](API_GetUtterancesView.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [PutBot](API_PutBot.md) 
+  [PutBotAlias](API_PutBotAlias.md) 
+  [PutIntent](API_PutIntent.md) 
+  [PutSlotType](API_PutSlotType.md) 
+  [StartImport](API_StartImport.md) 
+  [StartMigration](API_StartMigration.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 

# CreateBotVersion
<a name="API_CreateBotVersion"></a>

Crée une nouvelle version du bot en fonction de la `$LATEST` version. Si la `$LATEST` version de cette ressource n'a pas changé depuis que vous avez créé la dernière version, Amazon Lex ne crée pas de nouvelle version. Elle renvoie la dernière version créée.

**Note**  
Vous ne pouvez mettre à jour que la `$LATEST` version du bot. Vous ne pouvez pas mettre à jour les versions numérotées que vous créez avec cette `CreateBotVersion` opération.

 Lorsque vous créez la première version d'un bot, Amazon Lex définit la version sur 1. Les versions suivantes sont incrémentées de 1. Pour de plus amples informations, veuillez consulter [Gestion des versions](versioning-aliases.md#versioning-intro). 

 Cette opération nécessite une autorisation pour l’action `lex:CreateBotVersion`. 

## Syntaxe de la demande
<a name="API_CreateBotVersion_RequestSyntax"></a>

```
POST /bots/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}
```

## Paramètres de demande URI
<a name="API_CreateBotVersion_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-uri-name"></a>
Nom du bot dont vous souhaitez créer une nouvelle version. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_CreateBotVersion_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [checksum](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-checksum"></a>
Identifie une révision spécifique de la `$LATEST` version du bot. Si vous spécifiez une somme de contrôle et que la `$LATEST` version du bot possède une somme de contrôle différente, une `PreconditionFailedException` exception est renvoyée et Amazon Lex ne publie pas de nouvelle version. Si vous ne spécifiez pas de somme de contrôle, Amazon Lex publie la `$LATEST` version.  
Type : chaîne  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateBotVersion_ResponseSyntax"></a>

```
HTTP/1.1 201
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",
   "status": "string",
   "version": "string",
   "voiceId": "string"
}
```

## Eléments de réponse
<a name="API_CreateBotVersion_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [abortStatement](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-abortStatement"></a>
Le message utilisé par Amazon Lex pour annuler une conversation. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md).  
Type : objet [Statement](API_Statement.md)

 ** [checksum](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-checksum"></a>
Somme de contrôle identifiant la version du bot qui a été créée.  
Type : Chaîne

 ** [childDirected](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-childDirected"></a>
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_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-clarificationPrompt"></a>
Message utilisé par 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_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-createdDate"></a>
Date à laquelle la version du bot a été créée.  
Type : Timestamp

 ** [description](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-description"></a>
Description du bot.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [detectSentiment](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-detectSentiment"></a>
Indique si les énoncés saisis par l'utilisateur doivent être envoyés à Amazon Comprehend pour analyse des sentiments.  
Type : Boolean

 ** [enableModelImprovements](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-enableModelImprovements"></a>
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_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-failureReason"></a>
Dans `status` l'affirmative`FAILED`, Amazon Lex fournit la raison pour laquelle il n'a pas réussi à créer le bot.  
Type : Chaîne

 ** [idleSessionTTLInSeconds](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-idleSessionTTLInSeconds"></a>
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_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-intents"></a>
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_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-lastUpdatedDate"></a>
Date à laquelle la `$LATEST` version de ce bot a été mise à jour.   
Type : Timestamp

 ** [locale](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-locale"></a>
 Spécifie les paramètres régionaux cibles pour le 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_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-name"></a>
Le nom du bot.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [status](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-status"></a>
 Lorsque vous envoyez une demande de création ou de mise à jour d'un bot, Amazon Lex définit l'élément de `status` réponse sur`BUILDING`. Une fois qu'Amazon Lex a créé le bot, celui-ci `status` passe à`READY`. Si Amazon Lex ne parvient pas à créer le bot, il est `status` configuré sur`FAILED`. Amazon Lex renvoie la raison de l'échec dans l'élément de `failureReason` réponse.   
Type : Chaîne  
Valeurs valides : `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-version"></a>
La version du bot.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

 ** [voiceId](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-voiceId"></a>
L'identifiant vocal Amazon Polly utilisé par Amazon Lex pour les interactions vocales avec l'utilisateur.  
Type : Chaîne

## Erreurs
<a name="API_CreateBotVersion_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** PreconditionFailedException **   
 La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.  
Code d’état HTTP : 412

## Voir aussi
<a name="API_CreateBotVersion_SeeAlso"></a>

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/CreateBotVersion) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateBotVersion) 

# CreateIntentVersion
<a name="API_CreateIntentVersion"></a>

Crée une nouvelle version d'une intention en fonction de la `$LATEST` version de l'intention. Si la `$LATEST` version de cette intention n'a pas changé depuis votre dernière mise à jour, Amazon Lex ne crée pas de nouvelle version. Elle renvoie la dernière version que vous avez créée.

**Note**  
Vous ne pouvez mettre à jour que la `$LATEST` version de l'intention. Vous ne pouvez pas mettre à jour les versions numérotées que vous créez avec cette `CreateIntentVersion` opération.

 Lorsque vous créez une version d'une intention, Amazon Lex définit la version sur 1. Les versions suivantes sont incrémentées de 1. Pour de plus amples informations, veuillez consulter [Gestion des versions](versioning-aliases.md#versioning-intro). 

Cette opération exige des autorisations pour exécuter l'action `lex:CreateIntentVersion`. 

## Syntaxe de la demande
<a name="API_CreateIntentVersion_RequestSyntax"></a>

```
POST /intents/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}
```

## Paramètres de demande URI
<a name="API_CreateIntentVersion_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-uri-name"></a>
Nom de l'intention dont vous souhaitez créer une nouvelle version. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_CreateIntentVersion_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [checksum](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-checksum"></a>
Somme de contrôle de la `$LATEST` version de l'intention qui doit être utilisée pour créer la nouvelle version. Si vous spécifiez une somme de contrôle et que la `$LATEST` version de l'intention possède une somme de contrôle différente, Amazon Lex renvoie une `PreconditionFailedException` exception et ne publie pas de nouvelle version. Si vous ne spécifiez pas de somme de contrôle, Amazon Lex publie la `$LATEST` version.  
Type : chaîne  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateIntentVersion_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}
```

## Eléments de réponse
<a name="API_CreateIntentVersion_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [checksum](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-checksum"></a>
Somme de contrôle de la version intentionnelle créée.  
Type : Chaîne

 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-conclusionStatement"></a>
Une fois que la fonction Lambda spécifiée dans le `fulfillmentActivity` champ répond à l'intention, Amazon Lex transmet cette déclaration à l'utilisateur.   
Type : objet [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-confirmationPrompt"></a>
Si elle est définie, l'invite qu'Amazon Lex utilise pour confirmer l'intention de l'utilisateur avant de la concrétiser.   
Type : objet [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-createdDate"></a>
Date à laquelle l'intention a été créée.  
Type : Timestamp

 ** [description](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-description"></a>
Une description de l'intention.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-dialogCodeHook"></a>
Si elle est définie, Amazon Lex invoque cette fonction Lambda pour chaque entrée utilisateur.  
Type : objet [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-followUpPrompt"></a>
Si elle est définie, Amazon Lex utilise cette invite pour solliciter une activité supplémentaire des utilisateurs une fois que l'intention a été remplie.   
Type : objet [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-fulfillmentActivity"></a>
 Décrit comment l'intention est atteinte.   
Type : objet [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-inputContexts"></a>
Tableau d'`InputContext`objets répertoriant les contextes qui doivent être actifs pour qu'Amazon Lex puisse choisir l'intention d'une conversation avec l'utilisateur.  
Type : tableau d’objets [InputContext](API_InputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 5 éléments.

 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-kendraConfiguration"></a>
Informations de configuration, le cas échéant, pour connecter un index Amazon Kendra à l'`AMAZON.KendraSearchIntent`intention.  
Type : objet [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-lastUpdatedDate"></a>
Date à laquelle l'intention a été mise à jour.   
Type : Timestamp

 ** [name](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-name"></a>
Nom de l'intention.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-outputContexts"></a>
Tableau d'`OutputContext`objets répertoriant les contextes que l'intention active lorsque l'intention est atteinte.  
Type : tableau d’objets [OutputContext](API_OutputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-parentIntentSignature"></a>
Identifiant unique pour une intention intégrée.  
Type : Chaîne

 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-rejectionStatement"></a>
Si l'utilisateur répond « non » à la question définie dans`confirmationPrompt`, Amazon Lex répond par cette déclaration pour reconnaître que l'intention a été annulée.   
Type : objet [Statement](API_Statement.md)

 ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-sampleUtterances"></a>
Un ensemble d'exemples d'énoncés configurés en fonction de l'intention.   
Type : tableau de chaînes  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1500 articles.  
Contraintes de longueur : longueur minimale de 1. Longueur maximum de 200.

 ** [slots](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-slots"></a>
Un ensemble de types d'emplacements qui définit les informations requises pour atteindre l'objectif.  
Type : tableau d’objets [Slot](API_Slot.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 100 éléments.

 ** [version](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-version"></a>
Le numéro de version attribué à la nouvelle version de l'intention.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

## Erreurs
<a name="API_CreateIntentVersion_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** PreconditionFailedException **   
 La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.  
Code d’état HTTP : 412

## Voir aussi
<a name="API_CreateIntentVersion_SeeAlso"></a>

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/CreateIntentVersion) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateIntentVersion) 

# CreateSlotTypeVersion
<a name="API_CreateSlotTypeVersion"></a>

Crée une nouvelle version d'un type d'emplacement en fonction de la `$LATEST` version du type d'emplacement spécifié. Si la `$LATEST` version de cette ressource n'a pas changé depuis la dernière version que vous avez créée, Amazon Lex ne crée pas de nouvelle version. Elle renvoie la dernière version que vous avez créée. 

**Note**  
Vous ne pouvez mettre à jour que la `$LATEST` version d'un type de slot. Vous ne pouvez pas mettre à jour les versions numérotées que vous créez avec cette `CreateSlotTypeVersion` opération.

Lorsque vous créez une version d'un type de slot, Amazon Lex définit la version sur 1. Les versions suivantes sont incrémentées de 1. Pour de plus amples informations, veuillez consulter [Gestion des versions](versioning-aliases.md#versioning-intro). 

Cette opération exige des autorisations pour l’action `lex:CreateSlotTypeVersion`.

## Syntaxe de la demande
<a name="API_CreateSlotTypeVersion_RequestSyntax"></a>

```
POST /slottypes/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}
```

## Paramètres de demande URI
<a name="API_CreateSlotTypeVersion_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-uri-name"></a>
Nom du type de slot pour lequel vous souhaitez créer une nouvelle version. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_CreateSlotTypeVersion_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [checksum](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-checksum"></a>
Somme de contrôle correspondant à la `$LATEST` version du type de slot que vous souhaitez publier. Si vous spécifiez une somme de contrôle et que la `$LATEST` version du type d'emplacement possède une somme de contrôle différente, Amazon Lex renvoie une `PreconditionFailedException` exception et ne publie pas la nouvelle version. Si vous ne spécifiez pas de somme de contrôle, Amazon Lex publie la `$LATEST` version.  
Type : chaîne  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateSlotTypeVersion_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "checksum": "string",
   "createdDate": number,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "lastUpdatedDate": number,
   "name": "string",
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string",
   "version": "string"
}
```

## Eléments de réponse
<a name="API_CreateSlotTypeVersion_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [checksum](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-checksum"></a>
Somme de contrôle de la `$LATEST` version du type de slot.  
Type : Chaîne

 ** [createdDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-createdDate"></a>
Date à laquelle le type de slot a été créé.  
Type : Timestamp

 ** [description](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-description"></a>
Une description du type d'emplacement.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [enumerationValues](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-enumerationValues"></a>
Liste d'`EnumerationValue`objets qui définit les valeurs que le type de slot peut prendre.  
Type : tableau d’objets [EnumerationValue](API_EnumerationValue.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 000 articles.

 ** [lastUpdatedDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-lastUpdatedDate"></a>
Date à laquelle le type de slot 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

 ** [name](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-name"></a>
Nom du type d'option.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-parentSlotTypeSignature"></a>
Le type d'emplacement intégré utilisé comme parent du type d'emplacement.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-slotTypeConfigurations"></a>
Informations de configuration qui étendent le type de slot intégré du parent.  
Type : tableau d’objets [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

 ** [valueSelectionStrategy](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-valueSelectionStrategy"></a>
Stratégie utilisée par Amazon Lex pour déterminer la valeur de l'emplacement. Pour de plus amples informations, veuillez consulter [PutSlotType](API_PutSlotType.md).  
Type : Chaîne  
Valeurs valides : `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-version"></a>
Version attribuée à la nouvelle version de type de slot.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

## Erreurs
<a name="API_CreateSlotTypeVersion_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** PreconditionFailedException **   
 La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.  
Code d’état HTTP : 412

## Voir aussi
<a name="API_CreateSlotTypeVersion_SeeAlso"></a>

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/CreateSlotTypeVersion) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateSlotTypeVersion) 

# DeleteBot
<a name="API_DeleteBot"></a>

Supprime toutes les versions du bot, y compris la `$LATEST` version. Pour supprimer une version spécifique du bot, utilisez l'[DeleteBotVersion](API_DeleteBotVersion.md)opération. L'`DeleteBot`opération ne supprime pas immédiatement le schéma du bot. Au lieu de cela, il est marqué pour suppression et supprimé ultérieurement.

Amazon Lex stocke les énoncés indéfiniment afin d'améliorer la capacité de votre bot à répondre aux entrées des utilisateurs. Ces énoncés ne sont pas supprimés lorsque le bot est supprimé. Pour supprimer les énoncés, utilisez l'[DeleteUtterances](API_DeleteUtterances.md)opération.

Si un bot possède un alias, vous ne pouvez pas le supprimer. Au lieu de cela, l'`DeleteBot`opération renvoie une `ResourceInUseException` exception qui inclut une référence à l'alias qui fait référence au bot. Pour supprimer la référence au bot, supprimez l'alias. Si vous obtenez à nouveau la même exception, supprimez l'alias de référence jusqu'à ce que l'`DeleteBot`opération soit réussie.

Cette opération exige des autorisations pour l’action `lex:DeleteBot`.

## Syntaxe de la demande
<a name="API_DeleteBot_RequestSyntax"></a>

```
DELETE /bots/name HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteBot_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_DeleteBot_RequestSyntax) **   <a name="lex-DeleteBot-request-uri-name"></a>
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

## Corps de la demande
<a name="API_DeleteBot_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteBot_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteBot_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_DeleteBot_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** ResourceInUseException **   
La ressource que vous essayez de supprimer est référencée par une autre ressource. Utilisez ces informations pour supprimer les références à la ressource que vous essayez de supprimer.  
Le corps de l'exception contient un objet JSON qui décrit la ressource.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Décrit la ressource qui fait référence à la ressource que vous essayez de supprimer. Cet objet est renvoyé dans le cadre de l'`ResourceInUseException`exception. 
Code d’état HTTP : 400

## Voir aussi
<a name="API_DeleteBot_SeeAlso"></a>

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/DeleteBot) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBot) 

# DeleteBotAlias
<a name="API_DeleteBotAlias"></a>

Supprime un alias pour le robot spécifié. 

Vous ne pouvez pas supprimer un alias utilisé dans le cadre de l'association entre un bot et un canal de messagerie. Si un alias est utilisé dans une association de canaux, l'`DeleteBot`opération renvoie une `ResourceInUseException` exception qui inclut une référence à l'association de canaux qui fait référence au bot. Vous pouvez supprimer la référence à l'alias en supprimant l'association de canaux. Si vous obtenez à nouveau la même exception, supprimez l'association référente jusqu'à ce que l'`DeleteBotAlias`opération soit réussie.

## Syntaxe de la demande
<a name="API_DeleteBotAlias_RequestSyntax"></a>

```
DELETE /bots/botName/aliases/name HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteBotAlias_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [botName](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-botName"></a>
Nom du robot sur lequel l'alias pointe.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [name](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-name"></a>
Nom de l'alias à supprimer. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteBotAlias_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteBotAlias_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteBotAlias_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_DeleteBotAlias_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** ResourceInUseException **   
La ressource que vous essayez de supprimer est référencée par une autre ressource. Utilisez ces informations pour supprimer les références à la ressource que vous essayez de supprimer.  
Le corps de l'exception contient un objet JSON qui décrit la ressource.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Décrit la ressource qui fait référence à la ressource que vous essayez de supprimer. Cet objet est renvoyé dans le cadre de l'`ResourceInUseException`exception. 
Code d’état HTTP : 400

## Voir aussi
<a name="API_DeleteBotAlias_SeeAlso"></a>

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/DeleteBotAlias) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotAlias) 

# DeleteBotChannelAssociation
<a name="API_DeleteBotChannelAssociation"></a>

Supprime l'association entre un bot Amazon Lex et une plateforme de messagerie.

Cette opération nécessite une autorisation pour l’action `lex:DeleteBotChannelAssociation`.

## Syntaxe de la demande
<a name="API_DeleteBotChannelAssociation_RequestSyntax"></a>

```
DELETE /bots/botName/aliases/aliasName/channels/name HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteBotChannelAssociation_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [aliasName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botAlias"></a>
Alias qui pointe vers la version spécifique du bot Amazon Lex avec laquelle cette association est établie.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [botName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botName"></a>
Nom du bot Amazon Lex.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [name](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-name"></a>
Nom de l'association. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteBotChannelAssociation_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteBotChannelAssociation_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteBotChannelAssociation_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_DeleteBotChannelAssociation_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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
<a name="API_DeleteBotChannelAssociation_SeeAlso"></a>

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/DeleteBotChannelAssociation) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 

# DeleteBotVersion
<a name="API_DeleteBotVersion"></a>

Supprime une version spécifique d'un robot. Pour supprimer toutes les versions d'un bot, utilisez l'[DeleteBot](API_DeleteBot.md)opération. 

Cette opération exige des autorisations pour l’action `lex:DeleteBotVersion`.

## Syntaxe de la demande
<a name="API_DeleteBotVersion_RequestSyntax"></a>

```
DELETE /bots/name/versions/version HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteBotVersion_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-name"></a>
Le nom du bot.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [version](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-version"></a>
Version du bot à supprimer. Vous ne pouvez pas supprimer la `$LATEST` version du bot. Pour supprimer la `$LATEST` version, utilisez l'[DeleteBot](API_DeleteBot.md)opération.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[0-9]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteBotVersion_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteBotVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteBotVersion_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_DeleteBotVersion_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** ResourceInUseException **   
La ressource que vous essayez de supprimer est référencée par une autre ressource. Utilisez ces informations pour supprimer les références à la ressource que vous essayez de supprimer.  
Le corps de l'exception contient un objet JSON qui décrit la ressource.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Décrit la ressource qui fait référence à la ressource que vous essayez de supprimer. Cet objet est renvoyé dans le cadre de l'`ResourceInUseException`exception. 
Code d’état HTTP : 400

## Voir aussi
<a name="API_DeleteBotVersion_SeeAlso"></a>

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/DeleteBotVersion) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotVersion) 

# DeleteIntent
<a name="API_DeleteIntent"></a>

Supprime toutes les versions de l'intention, y compris la `$LATEST` version. Pour supprimer une version spécifique de l'intention, utilisez l'[DeleteIntentVersion](API_DeleteIntentVersion.md)opération.

 Vous pouvez supprimer une version d'une intention uniquement si elle n'est pas référencée. Pour supprimer une intention mentionnée dans un ou plusieurs robots (voir[Amazon Lex : comment ça marche](how-it-works.md)), vous devez d'abord supprimer ces références. 

**Note**  
 Si vous obtenez l'`ResourceInUseException`exception, elle fournit un exemple de référence qui indique où l'intention est référencée. Pour supprimer la référence à l'intention, mettez à jour le bot ou supprimez-le. Si vous obtenez la même exception lorsque vous tentez à nouveau de supprimer l'intention, recommencez jusqu'à ce que l'intention n'ait aucune référence et que l'appel à `DeleteIntent` aboutisse. 

 Cette opération nécessite une autorisation pour l’action `lex:DeleteIntent`. 

## Syntaxe de la demande
<a name="API_DeleteIntent_RequestSyntax"></a>

```
DELETE /intents/name HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteIntent_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_DeleteIntent_RequestSyntax) **   <a name="lex-DeleteIntent-request-uri-name"></a>
Nom de l'intention. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteIntent_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteIntent_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteIntent_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_DeleteIntent_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** ResourceInUseException **   
La ressource que vous essayez de supprimer est référencée par une autre ressource. Utilisez ces informations pour supprimer les références à la ressource que vous essayez de supprimer.  
Le corps de l'exception contient un objet JSON qui décrit la ressource.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Décrit la ressource qui fait référence à la ressource que vous essayez de supprimer. Cet objet est renvoyé dans le cadre de l'`ResourceInUseException`exception. 
Code d’état HTTP : 400

## Voir aussi
<a name="API_DeleteIntent_SeeAlso"></a>

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/DeleteIntent) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntent) 

# DeleteIntentVersion
<a name="API_DeleteIntentVersion"></a>

Supprime une version spécifique d'une intention. Pour supprimer toutes les versions d'une intention, utilisez l'[DeleteIntent](API_DeleteIntent.md)opération. 

Cette opération exige des autorisations pour l’action `lex:DeleteIntentVersion`.

## Syntaxe de la demande
<a name="API_DeleteIntentVersion_RequestSyntax"></a>

```
DELETE /intents/name/versions/version HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteIntentVersion_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-name"></a>
Nom de l'intention.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [version](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-version"></a>
Version de l'intention de suppression. Vous ne pouvez pas supprimer la `$LATEST` version de l'intention. Pour supprimer la `$LATEST` version, utilisez l'[DeleteIntent](API_DeleteIntent.md)opération.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[0-9]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteIntentVersion_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteIntentVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteIntentVersion_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_DeleteIntentVersion_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** ResourceInUseException **   
La ressource que vous essayez de supprimer est référencée par une autre ressource. Utilisez ces informations pour supprimer les références à la ressource que vous essayez de supprimer.  
Le corps de l'exception contient un objet JSON qui décrit la ressource.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Décrit la ressource qui fait référence à la ressource que vous essayez de supprimer. Cet objet est renvoyé dans le cadre de l'`ResourceInUseException`exception. 
Code d’état HTTP : 400

## Voir aussi
<a name="API_DeleteIntentVersion_SeeAlso"></a>

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/DeleteIntentVersion) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntentVersion) 

# DeleteSlotType
<a name="API_DeleteSlotType"></a>

Supprime toutes les versions du type de slot, y compris la `$LATEST` version. Pour supprimer une version spécifique du type de slot, utilisez l'[DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md)opération.

 Vous pouvez supprimer une version d'un type de slot uniquement si elle n'est pas référencée. Pour supprimer un type de slot auquel il est fait référence dans une ou plusieurs intentions, vous devez d'abord supprimer ces références. 

**Note**  
 Si vous obtenez l'`ResourceInUseException`exception, celle-ci fournit un exemple de référence qui indique l'intention dans laquelle le type de slot est référencé. Pour supprimer la référence au type d'emplacement, mettez à jour l'intention ou supprimez-la. Si vous obtenez la même exception lorsque vous tentez à nouveau de supprimer le type d'emplacement, répétez l'opération jusqu'à ce que le type d'emplacement n'ait aucune référence et que l'`DeleteSlotType`appel aboutisse. 

Cette opération nécessite une autorisation pour l’action `lex:DeleteSlotType`.

## Syntaxe de la demande
<a name="API_DeleteSlotType_RequestSyntax"></a>

```
DELETE /slottypes/name HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteSlotType_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_DeleteSlotType_RequestSyntax) **   <a name="lex-DeleteSlotType-request-uri-name"></a>
Nom du type d'option. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteSlotType_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteSlotType_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteSlotType_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_DeleteSlotType_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** ResourceInUseException **   
La ressource que vous essayez de supprimer est référencée par une autre ressource. Utilisez ces informations pour supprimer les références à la ressource que vous essayez de supprimer.  
Le corps de l'exception contient un objet JSON qui décrit la ressource.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Décrit la ressource qui fait référence à la ressource que vous essayez de supprimer. Cet objet est renvoyé dans le cadre de l'`ResourceInUseException`exception. 
Code d’état HTTP : 400

## Voir aussi
<a name="API_DeleteSlotType_SeeAlso"></a>

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/DeleteSlotType) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotType) 

# DeleteSlotTypeVersion
<a name="API_DeleteSlotTypeVersion"></a>

Supprime une version spécifique d'un type d'emplacement. Pour supprimer toutes les versions d'un type de slot, utilisez l'[DeleteSlotType](API_DeleteSlotType.md)opération. 

Cette opération exige des autorisations pour l’action `lex:DeleteSlotTypeVersion`.

## Syntaxe de la demande
<a name="API_DeleteSlotTypeVersion_RequestSyntax"></a>

```
DELETE /slottypes/name/version/version HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteSlotTypeVersion_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-name"></a>
Nom du type d'option.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [version](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-version"></a>
Version du type de slot à supprimer. Vous ne pouvez pas supprimer la `$LATEST` version du type de slot. Pour supprimer la `$LATEST` version, utilisez l'[DeleteSlotType](API_DeleteSlotType.md)opération.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[0-9]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteSlotTypeVersion_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteSlotTypeVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteSlotTypeVersion_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_DeleteSlotTypeVersion_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** ResourceInUseException **   
La ressource que vous essayez de supprimer est référencée par une autre ressource. Utilisez ces informations pour supprimer les références à la ressource que vous essayez de supprimer.  
Le corps de l'exception contient un objet JSON qui décrit la ressource.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Décrit la ressource qui fait référence à la ressource que vous essayez de supprimer. Cet objet est renvoyé dans le cadre de l'`ResourceInUseException`exception. 
Code d’état HTTP : 400

## Voir aussi
<a name="API_DeleteSlotTypeVersion_SeeAlso"></a>

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/DeleteSlotTypeVersion) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 

# DeleteUtterances
<a name="API_DeleteUtterances"></a>

Supprime les énoncés enregistrés.

Amazon Lex stocke les énoncés que les utilisateurs envoient à votre bot. Les énoncés sont conservés pendant 15 jours pour être utilisés dans le cadre de l'[GetUtterancesView](API_GetUtterancesView.md)opération, puis stockés indéfiniment pour améliorer la capacité de votre robot à répondre aux entrées des utilisateurs.

Utilisez cette `DeleteUtterances` opération pour supprimer manuellement les énoncés enregistrés pour un utilisateur spécifique. Lorsque vous utilisez cette `DeleteUtterances` opération, les énoncés enregistrés pour améliorer la capacité de votre robot à répondre aux entrées de l'utilisateur sont immédiatement supprimés. Les énoncés enregistrés pour être utilisés dans le cadre de l'`GetUtterancesView`opération sont supprimés au bout de 15 jours.

Cette opération exige des autorisations pour l’action `lex:DeleteUtterances`.

## Syntaxe de la demande
<a name="API_DeleteUtterances_RequestSyntax"></a>

```
DELETE /bots/botName/utterances/userId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_DeleteUtterances_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [botName](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-botName"></a>
Nom du bot qui a enregistré les énoncés.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [userId](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-userId"></a>
 Identifiant unique de l'utilisateur qui a émis les énoncés. Il s'agit de l'ID utilisateur envoyé dans la demande [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)d'opération [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)ou contenant l'énoncé.  
Contraintes de longueur : longueur minimale de 2. Longueur maximum de 100.  
Obligatoire : oui

## Corps de la demande
<a name="API_DeleteUtterances_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_DeleteUtterances_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_DeleteUtterances_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_DeleteUtterances_Errors"></a>

 ** 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
<a name="API_DeleteUtterances_SeeAlso"></a>

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/DeleteUtterances) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteUtterances) 

# GetBot
<a name="API_GetBot"></a>

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
<a name="API_GetBot_RequestSyntax"></a>

```
GET /bots/name/versions/versionoralias HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBot_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-name"></a>
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) **   <a name="lex-GetBot-request-uri-versionOrAlias"></a>
Version ou alias du bot.  
Obligatoire : oui

## Corps de la demande
<a name="API_GetBot_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBot_ResponseSyntax"></a>

```
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
<a name="API_GetBot_ResponseElements"></a>

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) **   <a name="lex-GetBot-response-abortStatement"></a>
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) **   <a name="lex-GetBot-response-checksum"></a>
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) **   <a name="lex-GetBot-response-childDirected"></a>
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) **   <a name="lex-GetBot-response-clarificationPrompt"></a>
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) **   <a name="lex-GetBot-response-createdDate"></a>
Date de création du bot.  
Type : Timestamp

 ** [description](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-description"></a>
Description du bot.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [detectSentiment](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-detectSentiment"></a>
Indique si les déclarations des utilisateurs doivent être envoyées à Amazon Comprehend pour analyse des sentiments.  
Type : Boolean

 ** [enableModelImprovements](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-enableModelImprovements"></a>
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) **   <a name="lex-GetBot-response-failureReason"></a>
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) **   <a name="lex-GetBot-response-idleSessionTTLInSeconds"></a>
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) **   <a name="lex-GetBot-response-intents"></a>
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) **   <a name="lex-GetBot-response-lastUpdatedDate"></a>
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) **   <a name="lex-GetBot-response-locale"></a>
 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) **   <a name="lex-GetBot-response-name"></a>
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) **   <a name="lex-GetBot-response-nluIntentConfidenceThreshold"></a>
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) **   <a name="lex-GetBot-response-status"></a>
É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) **   <a name="lex-GetBot-response-version"></a>
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) **   <a name="lex-GetBot-response-voiceId"></a>
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
<a name="API_GetBot_Errors"></a>

 ** 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
<a name="API_GetBot_SeeAlso"></a>

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) 

# GetBotAlias
<a name="API_GetBotAlias"></a>

Renvoie des informations sur un alias de bot Amazon Lex. Pour en savoir plus sur les alias, consultez la section [Versions et alias](versioning-aliases.md).

Cette opération exige des autorisations pour l’action `lex:GetBotAlias`.

## Syntaxe de la demande
<a name="API_GetBotAlias_RequestSyntax"></a>

```
GET /bots/botName/aliases/name HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBotAlias_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [botName](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-botName"></a>
Le nom du bot.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [name](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-name"></a>
Le nom de l'alias du bot. Le nom est sensible à la casse.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetBotAlias_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBotAlias_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botName": "string",
   "botVersion": "string",
   "checksum": "string",
   "conversationLogs": { 
      "iamRoleArn": "string",
      "logSettings": [ 
         { 
            "destination": "string",
            "kmsKeyArn": "string",
            "logType": "string",
            "resourceArn": "string",
            "resourcePrefix": "string"
         }
      ]
   },
   "createdDate": number,
   "description": "string",
   "lastUpdatedDate": number,
   "name": "string"
}
```

## Eléments de réponse
<a name="API_GetBotAlias_ResponseElements"></a>

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.

 ** [botName](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botName"></a>
Nom du robot sur lequel l'alias pointe.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [botVersion](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botVersion"></a>
Version du bot vers laquelle pointe l'alias.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

 ** [checksum](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-checksum"></a>
Somme de contrôle de l'alias du bot.  
Type : Chaîne

 ** [conversationLogs](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-conversationLogs"></a>
Les paramètres qui déterminent la manière dont Amazon Lex utilise les journaux de conversation pour l'alias.  
Type : objet [ConversationLogsResponse](API_ConversationLogsResponse.md)

 ** [createdDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-createdDate"></a>
Date à laquelle l'alias du bot a été créé.  
Type : Timestamp

 ** [description](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-description"></a>
Description de l'alias du bot.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [lastUpdatedDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-lastUpdatedDate"></a>
Date à laquelle l'alias du 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

 ** [name](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-name"></a>
Le nom de l'alias du bot.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

## Erreurs
<a name="API_GetBotAlias_Errors"></a>

 ** 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
<a name="API_GetBotAlias_SeeAlso"></a>

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/GetBotAlias) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAlias) 

# GetBotAliases
<a name="API_GetBotAliases"></a>

Renvoie une liste d'alias pour un bot Amazon Lex spécifié.

Cette opération exige des autorisations pour l’action `lex:GetBotAliases`.

## Syntaxe de la demande
<a name="API_GetBotAliases_RequestSyntax"></a>

```
GET /bots/botName/aliases/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBotAliases_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [botName](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-botName"></a>
Le nom du bot.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [maxResults](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-maxResults"></a>
Le nombre maximum d'alias à renvoyer dans la réponse. La valeur par défaut est 50.   
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [nameContains](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nameContains"></a>
Sous-chaîne à faire correspondre dans les noms d'alias du bot. Un alias sera renvoyé si une partie de son nom correspond à la sous-chaîne. Par exemple, « xyz » correspond à la fois à « xyzabc » et à « abcxyz ».  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nextToken"></a>
Un jeton de pagination pour récupérer la page suivante d'alias. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page d'alias suivante, spécifiez le jeton de pagination dans la demande suivante. 

## Corps de la requête
<a name="API_GetBotAliases_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBotAliases_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BotAliases": [ 
      { 
         "botName": "string",
         "botVersion": "string",
         "checksum": "string",
         "conversationLogs": { 
            "iamRoleArn": "string",
            "logSettings": [ 
               { 
                  "destination": "string",
                  "kmsKeyArn": "string",
                  "logType": "string",
                  "resourceArn": "string",
                  "resourcePrefix": "string"
               }
            ]
         },
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string"
      }
   ],
   "nextToken": "string"
}
```

## Eléments de réponse
<a name="API_GetBotAliases_ResponseElements"></a>

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.

 ** [BotAliases](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-BotAliases"></a>
Tableau d'`BotAliasMetadata`objets, chacun décrivant un alias de bot.  
Type : tableau d’objets [BotAliasMetadata](API_BotAliasMetadata.md)

 ** [nextToken](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-nextToken"></a>
Un jeton de pagination pour récupérer la page suivante d'alias. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page d'alias suivante, spécifiez le jeton de pagination dans la demande suivante.   
Type : Chaîne

## Erreurs
<a name="API_GetBotAliases_Errors"></a>

 ** 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

## Voir aussi
<a name="API_GetBotAliases_SeeAlso"></a>

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/GetBotAliases) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAliases) 

# GetBotChannelAssociation
<a name="API_GetBotChannelAssociation"></a>

Renvoie des informations sur l'association entre un bot Amazon Lex et une plateforme de messagerie.

Cette opération exige des autorisations pour l’action `lex:GetBotChannelAssociation`.

## Syntaxe de la demande
<a name="API_GetBotChannelAssociation_RequestSyntax"></a>

```
GET /bots/botName/aliases/aliasName/channels/name HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBotChannelAssociation_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [aliasName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botAlias"></a>
Alias pointant vers la version spécifique du bot Amazon Lex avec laquelle cette association est établie.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [botName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botName"></a>
Nom du bot Amazon Lex.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [name](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-name"></a>
Nom de l'association entre le bot et le canal. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetBotChannelAssociation_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBotChannelAssociation_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botAlias": "string",
   "botConfiguration": { 
      "string" : "string" 
   },
   "botName": "string",
   "createdDate": number,
   "description": "string",
   "failureReason": "string",
   "name": "string",
   "status": "string",
   "type": "string"
}
```

## Eléments de réponse
<a name="API_GetBotChannelAssociation_ResponseElements"></a>

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.

 ** [botAlias](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botAlias"></a>
Alias pointant vers la version spécifique du bot Amazon Lex avec laquelle cette association est établie.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [botConfiguration](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botConfiguration"></a>
Fournit les informations dont la plateforme de messagerie a besoin pour communiquer avec le bot Amazon Lex.  
Type : mappage chaîne/chaîne  
Entrées cartographiques : nombre maximum de 10 éléments.

 ** [botName](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botName"></a>
Nom du bot Amazon Lex.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [createdDate](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-createdDate"></a>
Date à laquelle l'association entre le bot et le canal a été créée.  
Type : Timestamp

 ** [description](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-description"></a>
Description de l'association entre le bot et le canal.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [failureReason](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-failureReason"></a>
Dans `status` l'affirmative`FAILED`, Amazon Lex fournit la raison pour laquelle il n'a pas réussi à créer l'association.  
Type : Chaîne

 ** [name](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-name"></a>
Nom de l'association entre le bot et le canal.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [status](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-status"></a>
État du canal du bot.   
+  `CREATED`- La chaîne a été créée et est prête à être utilisée.
+  `IN_PROGRESS`- La création de la chaîne est en cours.
+  `FAILED`- Une erreur s'est produite lors de la création de la chaîne. Pour plus d'informations sur la raison de l'échec, consultez le `failureReason` champ.
Type : Chaîne  
Valeurs valides : `IN_PROGRESS | CREATED | FAILED` 

 ** [type](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-type"></a>
Type de plateforme de messagerie.  
Type : Chaîne  
Valeurs valides : `Facebook | Slack | Twilio-Sms | Kik` 

## Erreurs
<a name="API_GetBotChannelAssociation_Errors"></a>

 ** 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
<a name="API_GetBotChannelAssociation_SeeAlso"></a>

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/GetBotChannelAssociation) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociation) 

# GetBotChannelAssociations
<a name="API_GetBotChannelAssociations"></a>

 Renvoie une liste de tous les canaux associés au bot spécifié. 

L'`GetBotChannelAssociations`opération nécessite des autorisations pour l'`lex:GetBotChannelAssociations`action.

## Syntaxe de la demande
<a name="API_GetBotChannelAssociations_RequestSyntax"></a>

```
GET /bots/botName/aliases/aliasName/channels/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBotChannelAssociations_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [aliasName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botAlias"></a>
Alias pointant vers la version spécifique du bot Amazon Lex avec laquelle cette association est établie.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^(-|^([A-Za-z]_?)+$)$`   
Obligatoire : oui

 ** [botName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botName"></a>
Nom du bot Amazon Lex dans l'association.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [maxResults](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-maxResults"></a>
Le nombre maximum d'associations à renvoyer dans la réponse. La valeur par défaut est 50.   
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [nameContains](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nameContains"></a>
Sous-chaîne à faire correspondre dans les noms des associations de canaux. Une association sera renvoyée si une partie de son nom correspond à la sous-chaîne. Par exemple, « xyz » correspond à la fois à « xyzabc » et à « abcxyz ». Pour renvoyer toutes les associations de canaux du bot, utilisez un trait d'union (« - ») comme `nameContains` paramètre.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nextToken"></a>
Un jeton de pagination pour récupérer la page suivante d'associations. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page d'associations suivante, spécifiez le jeton de pagination dans la demande suivante. 

## Corps de la requête
<a name="API_GetBotChannelAssociations_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBotChannelAssociations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botChannelAssociations": [ 
      { 
         "botAlias": "string",
         "botConfiguration": { 
            "string" : "string" 
         },
         "botName": "string",
         "createdDate": number,
         "description": "string",
         "failureReason": "string",
         "name": "string",
         "status": "string",
         "type": "string"
      }
   ],
   "nextToken": "string"
}
```

## Eléments de réponse
<a name="API_GetBotChannelAssociations_ResponseElements"></a>

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.

 ** [botChannelAssociations](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-botChannelAssociations"></a>
Tableau d'objets, un pour chaque association, qui fournit des informations sur le bot Amazon Lex et son association avec le canal.   
Type : tableau d’objets [BotChannelAssociation](API_BotChannelAssociation.md)

 ** [nextToken](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-nextToken"></a>
Un jeton de pagination qui permet de récupérer la page d'associations suivante. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page d'associations suivante, spécifiez le jeton de pagination dans la demande suivante.   
Type : Chaîne

## Erreurs
<a name="API_GetBotChannelAssociations_Errors"></a>

 ** 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

## Voir aussi
<a name="API_GetBotChannelAssociations_SeeAlso"></a>

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/GetBotChannelAssociations) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociations) 

# GetBots
<a name="API_GetBots"></a>

Renvoie les informations du bot comme suit : 
+ Si vous fournissez le `nameContains` champ, la réponse inclut des informations sur la `$LATEST` version de tous les robots dont le nom contient la chaîne spécifiée.
+ Si vous ne spécifiez pas le `nameContains` champ, l'opération renvoie des informations sur la `$LATEST` version de tous vos robots.

Cette opération nécessite une autorisation pour l’action `lex:GetBots`.

## Syntaxe de la demande
<a name="API_GetBots_RequestSyntax"></a>

```
GET /bots/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBots_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-maxResults"></a>
Le nombre maximum de robots à renvoyer dans la réponse que la demande renverra. La valeur par défaut est 10.  
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [nameContains](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nameContains"></a>
Sous-chaîne à faire correspondre dans les noms des robots. Un bot sera renvoyé si une partie de son nom correspond à la sous-chaîne. Par exemple, « xyz » correspond à la fois à « xyzabc » et à « abcxyz ».  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nextToken"></a>
Un jeton de pagination qui récupère la page suivante des bots. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page suivante de robots, spécifiez le jeton de pagination dans la demande suivante. 

## Corps de la requête
<a name="API_GetBots_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBots_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "bots": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "status": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}
```

## Eléments de réponse
<a name="API_GetBots_ResponseElements"></a>

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.

 ** [bots](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-bots"></a>
Un tableau d'`botMetadata`objets, avec une entrée pour chaque bot.   
Type : tableau d’objets [BotMetadata](API_BotMetadata.md)

 ** [nextToken](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-nextToken"></a>
Si la réponse est tronquée, elle inclut un jeton de pagination que vous pouvez spécifier dans votre prochaine demande pour récupérer la page suivante de bots.   
Type : Chaîne

## Erreurs
<a name="API_GetBots_Errors"></a>

 ** 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
<a name="API_GetBots_SeeAlso"></a>

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/GetBots) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBots) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBots) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBots) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBots) 

# GetBotVersions
<a name="API_GetBotVersions"></a>

Obtient des informations sur toutes les versions d'un bot.

L'`GetBotVersions`opération renvoie un `BotMetadata` objet pour chaque version d'un bot. Par exemple, si un bot possède trois versions numérotées, l'`GetBotVersions`opération renvoie quatre `BotMetadata` objets dans la réponse, un pour chaque version numérotée et un pour la `$LATEST` version. 

L'`GetBotVersions`opération renvoie toujours au moins une version, la `$LATEST` version.

Cette opération exige des autorisations pour l’action `lex:GetBotVersions`.

## Syntaxe de la demande
<a name="API_GetBotVersions_RequestSyntax"></a>

```
GET /bots/name/versions/?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBotVersions_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-maxResults"></a>
Le nombre maximum de versions de bot à renvoyer dans la réponse. La valeur par défaut est 10.  
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [name](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-name"></a>
Nom du robot pour lequel les versions doivent être renvoyées.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [nextToken](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-nextToken"></a>
Un jeton de pagination pour récupérer la page suivante des versions du bot. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page de versions suivante, spécifiez le jeton de pagination dans la demande suivante. 

## Corps de la requête
<a name="API_GetBotVersions_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBotVersions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "bots": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "status": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}
```

## Eléments de réponse
<a name="API_GetBotVersions_ResponseElements"></a>

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.

 ** [bots](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-bots"></a>
Un ensemble d'`BotMetadata`objets, un pour chaque version numérotée du bot plus un pour la `$LATEST` version.  
Type : tableau d’objets [BotMetadata](API_BotMetadata.md)

 ** [nextToken](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-nextToken"></a>
Un jeton de pagination pour récupérer la page suivante des versions du bot. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page de versions suivante, spécifiez le jeton de pagination dans la demande suivante.   
Type : Chaîne

## Erreurs
<a name="API_GetBotVersions_Errors"></a>

 ** 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
<a name="API_GetBotVersions_SeeAlso"></a>

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/GetBotVersions) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotVersions) 

# GetBuiltinIntent
<a name="API_GetBuiltinIntent"></a>

Renvoie des informations sur une intention intégrée.

Cette opération nécessite une autorisation pour l’action `lex:GetBuiltinIntent`.

## Syntaxe de la demande
<a name="API_GetBuiltinIntent_RequestSyntax"></a>

```
GET /builtins/intents/signature HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBuiltinIntent_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [signature](#API_GetBuiltinIntent_RequestSyntax) **   <a name="lex-GetBuiltinIntent-request-uri-signature"></a>
Identifiant unique pour une intention intégrée. Pour trouver la signature d'une intention, consultez la section [Intentions intégrées standard dans](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) le *kit de compétences Alexa*.  
Obligatoire : oui

## Corps de la demande
<a name="API_GetBuiltinIntent_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBuiltinIntent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "signature": "string",
   "slots": [ 
      { 
         "name": "string"
      }
   ],
   "supportedLocales": [ "string" ]
}
```

## Eléments de réponse
<a name="API_GetBuiltinIntent_ResponseElements"></a>

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.

 ** [signature](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-signature"></a>
Identifiant unique pour une intention intégrée.  
Type : Chaîne

 ** [slots](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-slots"></a>
Un tableau d'`BuiltinIntentSlot`objets, une entrée pour chaque type de slot dans l'intention.  
Type : tableau d’objets [BuiltinIntentSlot](API_BuiltinIntentSlot.md)

 ** [supportedLocales](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-supportedLocales"></a>
Liste des paramètres régionaux pris en charge par l'intention.  
Type : tableau de chaînes  
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` 

## Erreurs
<a name="API_GetBuiltinIntent_Errors"></a>

 ** 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
<a name="API_GetBuiltinIntent_SeeAlso"></a>

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/GetBuiltinIntent) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntent) 

# GetBuiltinIntents
<a name="API_GetBuiltinIntents"></a>

Obtient la liste des intentions intégrées qui répondent aux critères spécifiés.

Cette opération nécessite une autorisation pour l’action `lex:GetBuiltinIntents`.

## Syntaxe de la demande
<a name="API_GetBuiltinIntents_RequestSyntax"></a>

```
GET /builtins/intents/?locale=locale&maxResults=maxResults&nextToken=nextToken&signatureContains=signatureContains HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBuiltinIntents_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [locale](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-locale"></a>
Liste des paramètres régionaux pris en charge par l'intention.  
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` 

 ** [maxResults](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-maxResults"></a>
Le nombre maximum d'intentions à renvoyer dans la réponse. La valeur par défaut est 10.  
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [nextToken](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-nextToken"></a>
Un jeton de pagination qui permet de récupérer la page d'intention suivante. Si cet appel d'API est tronqué, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page d'intentions suivante, utilisez le jeton de pagination dans la requête suivante.

 ** [signatureContains](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-signatureContains"></a>
Sous-chaîne à associer aux signatures d'intention intégrées. Une intention sera renvoyée si une partie de sa signature correspond à la sous-chaîne. Par exemple, « xyz » correspond à la fois à « xyzabc » et à « abcxyz ». Pour trouver la signature d'une intention, consultez la section [Intentions intégrées standard dans](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) le *kit de compétences Alexa*.

## Corps de la requête
<a name="API_GetBuiltinIntents_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBuiltinIntents_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "intents": [ 
      { 
         "signature": "string",
         "supportedLocales": [ "string" ]
      }
   ],
   "nextToken": "string"
}
```

## Eléments de réponse
<a name="API_GetBuiltinIntents_ResponseElements"></a>

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.

 ** [intents](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-intents"></a>
Un ensemble d'`builtinIntentMetadata`objets, un pour chaque intention de la réponse.  
Type : tableau d’objets [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md)

 ** [nextToken](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-nextToken"></a>
Un jeton de pagination qui permet de récupérer la page d'intention suivante. Si la réponse à cet appel d'API est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page d'intentions suivante, spécifiez le jeton de pagination dans la demande suivante.  
Type : Chaîne

## Erreurs
<a name="API_GetBuiltinIntents_Errors"></a>

 ** 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

## Voir aussi
<a name="API_GetBuiltinIntents_SeeAlso"></a>

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/GetBuiltinIntents) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntents) 

# GetBuiltinSlotTypes
<a name="API_GetBuiltinSlotTypes"></a>

Obtient la liste des types d'emplacement intégrés qui répondent aux critères spécifiés.

Pour obtenir la liste des types d'emplacements intégrés, consultez la section [Référence des types d'emplacements](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) dans le *kit Alexa Skills*.

Cette opération nécessite une autorisation pour l’action `lex:GetBuiltInSlotTypes`.

## Syntaxe de la demande
<a name="API_GetBuiltinSlotTypes_RequestSyntax"></a>

```
GET /builtins/slottypes/?locale=locale&maxResults=maxResults&nextToken=nextToken&signatureContains=signatureContains HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetBuiltinSlotTypes_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [locale](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-locale"></a>
Liste des paramètres régionaux pris en charge par le type de slot.  
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` 

 ** [maxResults](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-maxResults"></a>
Le nombre maximal de types d'emplacements à renvoyer dans la réponse. La valeur par défaut est 10.  
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [nextToken](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-nextToken"></a>
Un jeton de pagination qui permet de récupérer la page suivante des types de machines à sous. Si la réponse à cet appel d'API est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour accéder à la page suivante des types d'emplacements, spécifiez le jeton de pagination dans la demande suivante.

 ** [signatureContains](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-signatureContains"></a>
Sous-chaîne à associer aux signatures de type de slot intégrées. Un type de slot sera renvoyé si une partie de sa signature correspond à la sous-chaîne. Par exemple, « xyz » correspond à la fois à « xyzabc » et à « abcxyz ».

## Corps de la requête
<a name="API_GetBuiltinSlotTypes_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetBuiltinSlotTypes_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "slotTypes": [ 
      { 
         "signature": "string",
         "supportedLocales": [ "string" ]
      }
   ]
}
```

## Eléments de réponse
<a name="API_GetBuiltinSlotTypes_ResponseElements"></a>

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.

 ** [nextToken](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-nextToken"></a>
Si la réponse est tronquée, elle inclut un jeton de pagination que vous pouvez utiliser dans votre prochaine demande pour récupérer la page suivante des types d'emplacements.  
Type : Chaîne

 ** [slotTypes](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-slotTypes"></a>
Un tableau d'`BuiltInSlotTypeMetadata`objets, une entrée pour chaque type d'emplacement renvoyé.  
Type : tableau d’objets [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md)

## Erreurs
<a name="API_GetBuiltinSlotTypes_Errors"></a>

 ** 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

## Voir aussi
<a name="API_GetBuiltinSlotTypes_SeeAlso"></a>

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/GetBuiltinSlotTypes) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 

# GetExport
<a name="API_GetExport"></a>

Exporte le contenu d'une ressource Amazon Lex dans un format spécifié. 

## Syntaxe de la demande
<a name="API_GetExport_RequestSyntax"></a>

```
GET /exports/?exportType=exportType&name=name&resourceType=resourceType&version=version HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetExport_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [exportType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-exportType"></a>
Format des données exportées.  
Valeurs valides : `ALEXA_SKILLS_KIT | LEX`   
Obligatoire : oui

 ** [name](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-name"></a>
Nom du bot à exporter.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `[a-zA-Z_]+`   
Obligatoire : oui

 ** [resourceType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-resourceType"></a>
Type de ressource à exporter.   
Valeurs valides : `BOT | INTENT | SLOT_TYPE`   
Obligatoire : oui

 ** [version](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-version"></a>
Version du bot à exporter.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[0-9]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetExport_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetExport_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "exportStatus": "string",
   "exportType": "string",
   "failureReason": "string",
   "name": "string",
   "resourceType": "string",
   "url": "string",
   "version": "string"
}
```

## Eléments de réponse
<a name="API_GetExport_ResponseElements"></a>

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.

 ** [exportStatus](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportStatus"></a>
État de l'exportation.   
+  `IN_PROGRESS`- L'export est en cours.
+  `READY`- L'exportation est terminée.
+  `FAILED`- L'exportation n'a pas pu être terminée.
Type : Chaîne  
Valeurs valides : `IN_PROGRESS | READY | FAILED` 

 ** [exportType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportType"></a>
Format des données exportées.  
Type : Chaîne  
Valeurs valides : `ALEXA_SKILLS_KIT | LEX` 

 ** [failureReason](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-failureReason"></a>
Dans `status` l'affirmative`FAILED`, Amazon Lex fournit la raison pour laquelle il n'a pas réussi à exporter la ressource.  
Type : Chaîne

 ** [name](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-name"></a>
Nom du bot exporté.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `[a-zA-Z_]+` 

 ** [resourceType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-resourceType"></a>
Type de ressource exportée.  
Type : Chaîne  
Valeurs valides : `BOT | INTENT | SLOT_TYPE` 

 ** [url](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-url"></a>
URL pré-signée S3 qui indique l'emplacement de la ressource exportée. La ressource exportée est une archive ZIP qui contient la ressource exportée au format JSON. La structure de l'archive peut changer. Votre code ne doit pas dépendre de la structure de l'archive.  
Type : Chaîne

 ** [version](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-version"></a>
Version du bot en cours d'exportation.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[0-9]+` 

## Erreurs
<a name="API_GetExport_Errors"></a>

 ** 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
<a name="API_GetExport_SeeAlso"></a>

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/GetExport) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetExport) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetExport) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetExport) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetExport) 

# GetImport
<a name="API_GetImport"></a>

Obtient des informations sur une tâche d'importation démarrée par l'`StartImport`opération.

## Syntaxe de la demande
<a name="API_GetImport_RequestSyntax"></a>

```
GET /imports/importId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetImport_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [importId](#API_GetImport_RequestSyntax) **   <a name="lex-GetImport-request-uri-importId"></a>
Identifiant des informations relatives à la tâche d'importation à renvoyer.  
Obligatoire : oui

## Corps de la demande
<a name="API_GetImport_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetImport_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "createdDate": number,
   "failureReason": [ "string" ],
   "importId": "string",
   "importStatus": "string",
   "mergeStrategy": "string",
   "name": "string",
   "resourceType": "string"
}
```

## Eléments de réponse
<a name="API_GetImport_ResponseElements"></a>

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.

 ** [createdDate](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-createdDate"></a>
Horodatage de la date et de l'heure de création de la tâche d'importation.  
Type : Timestamp

 ** [failureReason](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-failureReason"></a>
Chaîne qui décrit la raison pour laquelle une tâche d'importation a échoué.  
Type : tableau de chaînes

 ** [importId](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importId"></a>
Identifiant de la tâche d'importation spécifique.  
Type : Chaîne

 ** [importStatus](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importStatus"></a>
État de la tâche d'importation. Si le statut est le cas`FAILED`, vous pouvez obtenir la raison de l'échec `failureReason` sur le terrain.  
Type : Chaîne  
Valeurs valides : `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-mergeStrategy"></a>
Action prise en cas de conflit entre une ressource existante et une ressource du fichier d'importation.  
Type : Chaîne  
Valeurs valides : `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-name"></a>
Nom attribué à la tâche d'importation.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `[a-zA-Z_]+` 

 ** [resourceType](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-resourceType"></a>
Type de ressource importée.  
Type : Chaîne  
Valeurs valides : `BOT | INTENT | SLOT_TYPE` 

## Erreurs
<a name="API_GetImport_Errors"></a>

 ** 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
<a name="API_GetImport_SeeAlso"></a>

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/GetImport) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetImport) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetImport) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetImport) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetImport) 

# GetIntent
<a name="API_GetIntent"></a>

 Renvoie des informations relatives à une intention. Outre le nom de l'intention, vous devez spécifier la version de l'intention. 

 Cette opération exige des autorisations pour exécuter l'action `lex:GetIntent`. 

## Syntaxe de la demande
<a name="API_GetIntent_RequestSyntax"></a>

```
GET /intents/name/versions/version HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetIntent_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-name"></a>
Nom de l'intention. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [version](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-version"></a>
La version de l'intention.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetIntent_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetIntent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}
```

## Eléments de réponse
<a name="API_GetIntent_ResponseElements"></a>

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.

 ** [checksum](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-checksum"></a>
Somme de contrôle de l'intention.  
Type : Chaîne

 ** [conclusionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-conclusionStatement"></a>
Une fois que la fonction Lambda spécifiée dans l'`fulfillmentActivity`élément répond à l'intention, Amazon Lex transmet cette déclaration à l'utilisateur.  
Type : objet [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-confirmationPrompt"></a>
Si cela est défini dans le bot, Amazon Lex utilise une invite pour confirmer l'intention avant de répondre à la demande de l'utilisateur. Pour de plus amples informations, veuillez consulter [PutIntent](API_PutIntent.md).   
Type : objet [Prompt](API_Prompt.md)

 ** [createdDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-createdDate"></a>
Date à laquelle l'intention a été créée.  
Type : Timestamp

 ** [description](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-description"></a>
Une description de l'intention.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [dialogCodeHook](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-dialogCodeHook"></a>
Si elle est définie dans le bot, Amazon Amazon Lex invoque cette fonction Lambda pour chaque entrée utilisateur. Pour de plus amples informations, veuillez consulter [PutIntent](API_PutIntent.md).   
Type : objet [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-followUpPrompt"></a>
Si elle est définie dans le bot, Amazon Lex utilise cette invite pour solliciter une activité supplémentaire de l'utilisateur une fois que l'intention a été remplie. Pour de plus amples informations, veuillez consulter [PutIntent](API_PutIntent.md).  
Type : objet [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-fulfillmentActivity"></a>
Décrit comment l'intention est atteinte. Pour de plus amples informations, veuillez consulter [PutIntent](API_PutIntent.md).   
Type : objet [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-inputContexts"></a>
Tableau d'`InputContext`objets répertoriant les contextes qui doivent être actifs pour qu'Amazon Lex puisse choisir l'intention d'une conversation avec l'utilisateur.  
Type : tableau d’objets [InputContext](API_InputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 5 éléments.

 ** [kendraConfiguration](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-kendraConfiguration"></a>
Informations de configuration, le cas échéant, pour se connecter à un index Amazon Kendra dans le `AMAZON.KendraSearchIntent` but recherché.  
Type : objet [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-lastUpdatedDate"></a>
Date à laquelle l'intention a été mise à jour. Lorsque vous créez une ressource, la date de création et la date de dernière mise à jour sont identiques.   
Type : Timestamp

 ** [name](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-name"></a>
Nom de l'intention.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-outputContexts"></a>
Tableau d'`OutputContext`objets répertoriant les contextes que l'intention active lorsqu'elle est réalisée.  
Type : tableau d’objets [OutputContext](API_OutputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

 ** [parentIntentSignature](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-parentIntentSignature"></a>
Identifiant unique pour une intention intégrée.  
Type : Chaîne

 ** [rejectionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-rejectionStatement"></a>
Si l'utilisateur répond « non » à la question définie dans`confirmationPrompt`, Amazon Lex répond par cette déclaration pour reconnaître que l'intention a été annulée.   
Type : objet [Statement](API_Statement.md)

 ** [sampleUtterances](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-sampleUtterances"></a>
Un ensemble d'exemples d'énoncés configurés en fonction de l'intention.  
Type : tableau de chaînes  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 500 articles.  
Contraintes de longueur : longueur minimale de 1. Longueur maximum de 200.

 ** [slots](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-slots"></a>
Un ensemble de créneaux d'intention configurés pour l'intention.  
Type : tableau d’objets [Slot](API_Slot.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 100 éléments.

 ** [version](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-version"></a>
La version de l'intention.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

## Erreurs
<a name="API_GetIntent_Errors"></a>

 ** 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
<a name="API_GetIntent_SeeAlso"></a>

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/GetIntent) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntent) 

# GetIntents
<a name="API_GetIntents"></a>

Renvoie les informations d'intention comme suit : 
+ Si vous spécifiez le `nameContains` champ, renvoie la `$LATEST` version de toutes les intentions contenant la chaîne spécifiée.
+  Si vous ne spécifiez pas le `nameContains` champ, renvoie des informations sur la `$LATEST` version de toutes les intentions. 

 L'opération nécessite une autorisation pour l'`lex:GetIntents`action. 

## Syntaxe de la demande
<a name="API_GetIntents_RequestSyntax"></a>

```
GET /intents/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetIntents_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-maxResults"></a>
Le nombre maximum d'intentions à renvoyer dans la réponse. La valeur par défaut est 10.  
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [nameContains](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nameContains"></a>
Sous-chaîne à faire correspondre dans les noms d'intention. Une intention sera renvoyée si une partie de son nom correspond à la sous-chaîne. Par exemple, « xyz » correspond à la fois à « xyzabc » et à « abcxyz ».  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nextToken"></a>
Un jeton de pagination qui permet de récupérer la page d'intention suivante. Si la réponse à cet appel d'API est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page d'intentions suivante, spécifiez le jeton de pagination dans la demande suivante. 

## Corps de la requête
<a name="API_GetIntents_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetIntents_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "intents": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}
```

## Eléments de réponse
<a name="API_GetIntents_ResponseElements"></a>

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.

 ** [intents](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-intents"></a>
Tableau d’objets `Intent`. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md).  
Type : tableau d’objets [IntentMetadata](API_IntentMetadata.md)

 ** [nextToken](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-nextToken"></a>
Si la réponse est tronquée, elle inclut un jeton de pagination que vous pouvez spécifier dans votre prochaine demande pour récupérer la page d'intentions suivante.   
Type : Chaîne

## Erreurs
<a name="API_GetIntents_Errors"></a>

 ** 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
<a name="API_GetIntents_SeeAlso"></a>

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/GetIntents) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntents) 

# GetIntentVersions
<a name="API_GetIntentVersions"></a>

Obtient des informations sur toutes les versions d'une intention.

L'`GetIntentVersions`opération renvoie un `IntentMetadata` objet pour chaque version d'une intention. Par exemple, si une intention comporte trois versions numérotées, l'`GetIntentVersions`opération renvoie quatre `IntentMetadata` objets dans la réponse, un pour chaque version numérotée et un pour la `$LATEST` version. 

L'`GetIntentVersions`opération renvoie toujours au moins une version, la `$LATEST` version.

Cette opération exige des autorisations pour l’action `lex:GetIntentVersions`.

## Syntaxe de la demande
<a name="API_GetIntentVersions_RequestSyntax"></a>

```
GET /intents/name/versions/?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetIntentVersions_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-maxResults"></a>
Le nombre maximum de versions d'intention à renvoyer dans la réponse. La valeur par défaut est 10.  
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [name](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-name"></a>
Nom de l'intention pour laquelle les versions doivent être renvoyées.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [nextToken](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-nextToken"></a>
Un jeton de pagination pour récupérer la page suivante des versions d'intention. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page de versions suivante, spécifiez le jeton de pagination dans la demande suivante. 

## Corps de la requête
<a name="API_GetIntentVersions_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetIntentVersions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "intents": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}
```

## Eléments de réponse
<a name="API_GetIntentVersions_ResponseElements"></a>

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.

 ** [intents](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-intents"></a>
Un tableau d'`IntentMetadata`objets, un pour chaque version numérotée de l'intention plus un pour la `$LATEST` version.  
Type : tableau d’objets [IntentMetadata](API_IntentMetadata.md)

 ** [nextToken](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-nextToken"></a>
Un jeton de pagination pour récupérer la page suivante des versions d'intention. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page de versions suivante, spécifiez le jeton de pagination dans la demande suivante.   
Type : Chaîne

## Erreurs
<a name="API_GetIntentVersions_Errors"></a>

 ** 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
<a name="API_GetIntentVersions_SeeAlso"></a>

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/GetIntentVersions) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntentVersions) 

# GetMigration
<a name="API_GetMigration"></a>

Fournit des informations sur une migration en cours ou complète d'un bot Amazon Lex V1 vers un bot Amazon Lex V2. Utilisez cette opération pour afficher les alertes de migration et les avertissements liés à la migration.

## Syntaxe de la demande
<a name="API_GetMigration_RequestSyntax"></a>

```
GET /migrations/migrationId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetMigration_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [migrationId](#API_GetMigration_RequestSyntax) **   <a name="lex-GetMigration-request-uri-migrationId"></a>
Identifiant unique de la migration à consulter. Le `migrationID` est renvoyé par l'[StartMigration](API_StartMigration.md)opération.  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetMigration_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetMigration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "alerts": [ 
      { 
         "details": [ "string" ],
         "message": "string",
         "referenceURLs": [ "string" ],
         "type": "string"
      }
   ],
   "migrationId": "string",
   "migrationStatus": "string",
   "migrationStrategy": "string",
   "migrationTimestamp": number,
   "v1BotLocale": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotId": "string",
   "v2BotRole": "string"
}
```

## Eléments de réponse
<a name="API_GetMigration_ResponseElements"></a>

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.

 ** [alerts](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-alerts"></a>
Liste d'alertes et d'avertissements signalant des problèmes liés à la migration du bot Amazon Lex V1 vers Amazon Lex V2. Vous recevez un avertissement lorsqu'une fonctionnalité Amazon Lex V1 est implémentée différemment dans Amazon Lex V2.  
Pour plus d'informations, consultez la section [Migration d'un bot](https://docs.aws.amazon.com/lexv2/latest/dg/migrate.html) dans le *guide du développeur Amazon Lex V2*.  
Type : tableau d’objets [MigrationAlert](API_MigrationAlert.md)

 ** [migrationId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationId"></a>
Identifiant unique de la migration. Il s'agit du même identifiant que celui utilisé lors de l'appel de l'`GetMigration`opération.  
Type : Chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$` 

 ** [migrationStatus](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStatus"></a>
Indique le statut de la migration. Lorsque le statut est `COMPLETE` le suivant, la migration est terminée et le bot est disponible dans Amazon Lex V2. Certaines alertes et avertissements doivent peut-être être résolus pour terminer la migration.  
Type : Chaîne  
Valeurs valides : `IN_PROGRESS | COMPLETED | FAILED` 

 ** [migrationStrategy](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStrategy"></a>
La stratégie utilisée pour effectuer la migration.  
+  `CREATE_NEW`- Crée un nouveau bot Amazon Lex V2 et migre le bot Amazon Lex V1 vers le nouveau bot.
+  `UPDATE_EXISTING`- Remplace les métadonnées du bot Amazon Lex V2 existantes et les paramètres régionaux en cours de migration. Cela ne change aucune autre localisation dans le bot Amazon Lex V2. Si les paramètres régionaux n'existent pas, un nouveau paramètre régional est créé dans le bot Amazon Lex V2.
Type : Chaîne  
Valeurs valides : `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationTimestamp"></a>
Date et heure de début de la migration.  
Type : Timestamp

 ** [v1BotLocale](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotLocale"></a>
Les paramètres régionaux du bot Amazon Lex V1 ont été migrés vers Amazon Lex V2.  
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` 

 ** [v1BotName](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotName"></a>
Nom du bot Amazon Lex V1 migré vers Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotVersion"></a>
La version du bot Amazon Lex V1 a migré vers Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotId"></a>
Identifiant unique du bot Amazon Lex V2 vers lequel l'Amazon Lex V1 est migré.  
Type : Chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotRole"></a>
Rôle IAM utilisé par Amazon Lex pour exécuter le bot Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

## Erreurs
<a name="API_GetMigration_Errors"></a>

 ** 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
<a name="API_GetMigration_SeeAlso"></a>

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/GetMigration) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigration) 

# GetMigrations
<a name="API_GetMigrations"></a>

Obtient la liste des migrations entre Amazon Lex V1 et Amazon Lex V2.

## Syntaxe de la demande
<a name="API_GetMigrations_RequestSyntax"></a>

```
GET /migrations?maxResults=maxResults&migrationStatusEquals=migrationStatusEquals&nextToken=nextToken&sortByAttribute=sortByAttribute&sortByOrder=sortByOrder&v1BotNameContains=v1BotNameContains HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetMigrations_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-maxResults"></a>
Le nombre maximum de migrations à renvoyer dans la réponse. La valeur par défaut est 10.  
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [migrationStatusEquals](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-migrationStatusEquals"></a>
Filtre la liste pour ne contenir que les migrations dans l'état spécifié.  
Valeurs valides : `IN_PROGRESS | COMPLETED | FAILED` 

 ** [nextToken](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-nextToken"></a>
Un jeton de pagination qui récupère la page suivante des migrations. Si la réponse à cette opération est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour accéder à la page suivante des migrations, spécifiez le jeton de pagination dans la demande.

 ** [sortByAttribute](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByAttribute"></a>
Champ permettant de trier la liste des migrations. Vous pouvez trier en fonction du nom du bot Amazon Lex V1 ou de la date et de l'heure de début de la migration.  
Valeurs valides : `V1_BOT_NAME | MIGRATION_DATE_TIME` 

 ** [sortByOrder](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByOrder"></a>
L'ordre, donc, triez la liste.  
Valeurs valides : `ASCENDING | DESCENDING` 

 ** [v1BotNameContains](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-v1BotNameContains"></a>
Filtre la liste pour ne contenir que les robots dont le nom contient la chaîne spécifiée. La chaîne correspond à n'importe quel endroit du nom du bot.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

## Corps de la demande
<a name="API_GetMigrations_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetMigrations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "migrationSummaries": [ 
      { 
         "migrationId": "string",
         "migrationStatus": "string",
         "migrationStrategy": "string",
         "migrationTimestamp": number,
         "v1BotLocale": "string",
         "v1BotName": "string",
         "v1BotVersion": "string",
         "v2BotId": "string",
         "v2BotRole": "string"
      }
   ],
   "nextToken": "string"
}
```

## Eléments de réponse
<a name="API_GetMigrations_ResponseElements"></a>

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.

 ** [migrationSummaries](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-migrationSummaries"></a>
Un ensemble de résumés des migrations d'Amazon Lex V1 vers Amazon Lex V2. Pour voir les détails de la migration, utilisez le `migrationId` résumé dans un appel à l'[GetMigration](API_GetMigration.md)opération.  
Type : tableau d’objets [MigrationSummary](API_MigrationSummary.md)

 ** [nextToken](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-nextToken"></a>
Si la réponse est tronquée, elle inclut un jeton de pagination que vous pouvez spécifier dans votre prochaine demande pour récupérer la page suivante des migrations.  
Type : Chaîne

## Erreurs
<a name="API_GetMigrations_Errors"></a>

 ** 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

## Voir aussi
<a name="API_GetMigrations_SeeAlso"></a>

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/GetMigrations) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigrations) 

# GetSlotType
<a name="API_GetSlotType"></a>

Renvoie des informations sur une version spécifique d'un type d'emplacement. Outre le nom du type d'emplacement, vous devez spécifier la version du type d'emplacement.

Cette opération exige des autorisations pour l’action `lex:GetSlotType`.

## Syntaxe de la demande
<a name="API_GetSlotType_RequestSyntax"></a>

```
GET /slottypes/name/versions/version HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetSlotType_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-name"></a>
Nom du type d'option. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [version](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-version"></a>
Version du type de slot.   
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetSlotType_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetSlotType_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "createdDate": number,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "lastUpdatedDate": number,
   "name": "string",
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string",
   "version": "string"
}
```

## Eléments de réponse
<a name="API_GetSlotType_ResponseElements"></a>

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.

 ** [checksum](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-checksum"></a>
Somme de contrôle de la `$LATEST` version du type de slot.  
Type : Chaîne

 ** [createdDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-createdDate"></a>
Date à laquelle le type de slot a été créé.  
Type : Timestamp

 ** [description](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-description"></a>
Une description du type d'emplacement.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [enumerationValues](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-enumerationValues"></a>
Liste d'`EnumerationValue`objets qui définit les valeurs que le type de slot peut prendre.  
Type : tableau d’objets [EnumerationValue](API_EnumerationValue.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 000 articles.

 ** [lastUpdatedDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-lastUpdatedDate"></a>
Date à laquelle le type de slot 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

 ** [name](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-name"></a>
Nom du type d'option.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-parentSlotTypeSignature"></a>
Type d'emplacement intégré utilisé comme parent pour le type d'emplacement.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-slotTypeConfigurations"></a>
Informations de configuration qui étendent le type de slot intégré du parent.  
Type : tableau d’objets [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

 ** [valueSelectionStrategy](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-valueSelectionStrategy"></a>
Stratégie utilisée par Amazon Lex pour déterminer la valeur de l'emplacement. Pour de plus amples informations, veuillez consulter [PutSlotType](API_PutSlotType.md).  
Type : Chaîne  
Valeurs valides : `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-version"></a>
Version du type de slot.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

## Erreurs
<a name="API_GetSlotType_Errors"></a>

 ** 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
<a name="API_GetSlotType_SeeAlso"></a>

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/GetSlotType) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotType) 

# GetSlotTypes
<a name="API_GetSlotTypes"></a>

Renvoie les informations relatives au type de slot comme suit : 
+ Si vous spécifiez le `nameContains` champ, renvoie la `$LATEST` version de tous les types d'emplacements contenant la chaîne spécifiée.
+  Si vous ne spécifiez pas le `nameContains` champ, renvoie des informations sur la `$LATEST` version de tous les types de machines à sous. 

 L'opération nécessite une autorisation pour l'`lex:GetSlotTypes`action. 

## Syntaxe de la demande
<a name="API_GetSlotTypes_RequestSyntax"></a>

```
GET /slottypes/?maxResults=maxResults&nameContains=nameContains&nextToken=nextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetSlotTypes_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-maxResults"></a>
Le nombre maximal de types d'emplacements à renvoyer dans la réponse. La valeur par défaut est 10.  
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [nameContains](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nameContains"></a>
Sous-chaîne à associer aux noms des types d'emplacements. Un type de slot sera renvoyé si une partie de son nom correspond à la sous-chaîne. Par exemple, « xyz » correspond à la fois à « xyzabc » et à « abcxyz ».  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nextToken"></a>
Un jeton de pagination qui permet de récupérer la page suivante des types de machines à sous. Si la réponse à cet appel d'API est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page suivante des types d'emplacements, spécifiez le jeton de pagination dans la demande suivante.

## Corps de la requête
<a name="API_GetSlotTypes_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetSlotTypes_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "slotTypes": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "version": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_GetSlotTypes_ResponseElements"></a>

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.

 ** [nextToken](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-nextToken"></a>
Si la réponse est tronquée, elle inclut un jeton de pagination que vous pouvez spécifier dans votre prochaine demande pour récupérer la page suivante des types d'emplacements.  
Type : Chaîne

 ** [slotTypes](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-slotTypes"></a>
Tableau d'objets, un pour chaque type d'emplacement, qui fournit des informations telles que le nom du type d'emplacement, la version et une description.  
Type : tableau d’objets [SlotTypeMetadata](API_SlotTypeMetadata.md)

## Erreurs
<a name="API_GetSlotTypes_Errors"></a>

 ** 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
<a name="API_GetSlotTypes_SeeAlso"></a>

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/GetSlotTypes) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypes) 

# GetSlotTypeVersions
<a name="API_GetSlotTypeVersions"></a>

Obtient des informations sur toutes les versions d'un type de slot.

L'`GetSlotTypeVersions`opération renvoie un `SlotTypeMetadata` objet pour chaque version d'un type de slot. Par exemple, si un type de slot comporte trois versions numérotées, l'`GetSlotTypeVersions`opération renvoie quatre `SlotTypeMetadata` objets dans la réponse, un pour chaque version numérotée et un pour la `$LATEST` version. 

L'`GetSlotTypeVersions`opération renvoie toujours au moins une version, la `$LATEST` version.

Cette opération exige des autorisations pour l’action `lex:GetSlotTypeVersions`.

## Syntaxe de la demande
<a name="API_GetSlotTypeVersions_RequestSyntax"></a>

```
GET /slottypes/name/versions/?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetSlotTypeVersions_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-maxResults"></a>
Le nombre maximum de versions de type slot à renvoyer dans la réponse. La valeur par défaut est 10.  
Plage valide : valeur minimum de 1. Valeur maximale de 50.

 ** [name](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-name"></a>
Nom du type de slot pour lequel les versions doivent être renvoyées.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [nextToken](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-nextToken"></a>
Un jeton de pagination pour récupérer la page suivante des versions de type slot. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page de versions suivante, spécifiez le jeton de pagination dans la demande suivante. 

## Corps de la requête
<a name="API_GetSlotTypeVersions_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetSlotTypeVersions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "slotTypes": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "version": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_GetSlotTypeVersions_ResponseElements"></a>

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.

 ** [nextToken](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-nextToken"></a>
Un jeton de pagination pour récupérer la page suivante des versions de type slot. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page de versions suivante, spécifiez le jeton de pagination dans la demande suivante.   
Type : Chaîne

 ** [slotTypes](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-slotTypes"></a>
Un tableau d'`SlotTypeMetadata`objets, un pour chaque version numérotée du type de slot plus un pour la `$LATEST` version.  
Type : tableau d’objets [SlotTypeMetadata](API_SlotTypeMetadata.md)

## Erreurs
<a name="API_GetSlotTypeVersions_Errors"></a>

 ** 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
<a name="API_GetSlotTypeVersions_SeeAlso"></a>

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/GetSlotTypeVersions) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypeVersions) 

# GetUtterancesView
<a name="API_GetUtterancesView"></a>

Utilisez cette `GetUtterancesView` opération pour obtenir des informations sur les déclarations que vos utilisateurs ont adressées à votre bot. Vous pouvez utiliser cette liste pour ajuster les énoncés auxquels votre bot répond.

Supposons, par exemple, que vous ayez créé un robot pour commander des fleurs. Une fois que vos utilisateurs ont utilisé votre bot pendant un certain temps, utilisez l'`GetUtterancesView`opération pour voir les demandes qu'ils ont faites et si elles ont abouti. Vous constaterez peut-être que l'énoncé « Je veux des fleurs » n'est pas reconnu. Vous pouvez ajouter cet énoncé à l'`OrderFlowers`intention afin que votre bot le reconnaisse.

Après avoir publié une nouvelle version d'un bot, vous pouvez obtenir des informations sur l'ancienne version et la nouvelle afin de pouvoir comparer les performances entre les deux versions. 

Les statistiques d'énoncés sont générées une fois par jour. Les données sont disponibles pour les 15 derniers jours. Vous pouvez demander des informations pour un maximum de 5 versions de votre bot par demande. Amazon Lex renvoie les énoncés les plus fréquemment reçus par le bot au cours des 15 derniers jours. La réponse contient des informations concernant un maximum de 100 énoncés pour chaque version.

Les statistiques d'énoncé ne sont pas générées dans les conditions suivantes :
+ Le `childDirected` champ était défini sur true lors de la création du bot.
+ Vous utilisez l'obfuscation des emplacements avec un ou plusieurs emplacements.
+ Vous avez choisi de ne pas participer à l'amélioration d'Amazon Lex.

Cette opération exige des autorisations pour l’action `lex:GetUtterancesView`.

## Syntaxe de la demande
<a name="API_GetUtterancesView_RequestSyntax"></a>

```
GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1
```

## Paramètres de demande URI
<a name="API_GetUtterancesView_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [botname](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botName"></a>
Nom du bot pour lequel les informations d'énoncé doivent être renvoyées.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [botVersions](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botVersions"></a>
Tableau de versions de robots pour lesquelles les informations d'énoncé doivent être renvoyées. La limite est de 5 versions par demande.  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : oui

 ** [statusType](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-statusType"></a>
Pour renvoyer des énoncés reconnus et traités, utilisez. `Detected` Pour renvoyer des énoncés qui n'ont pas été reconnus, utilisez. `Missed`  
Valeurs valides : `Detected | Missed`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetUtterancesView_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_GetUtterancesView_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botName": "string",
   "utterances": [ 
      { 
         "botVersion": "string",
         "utterances": [ 
            { 
               "count": number,
               "distinctUsers": number,
               "firstUtteredDate": number,
               "lastUtteredDate": number,
               "utteranceString": "string"
            }
         ]
      }
   ]
}
```

## Eléments de réponse
<a name="API_GetUtterancesView_ResponseElements"></a>

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.

 ** [botName](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-botName"></a>
Nom du bot pour lequel les informations d'énoncé ont été renvoyées.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [utterances](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-utterances"></a>
Un tableau d'[UtteranceList](API_UtteranceList.md)objets contenant chacun une liste d'[UtteranceData](API_UtteranceData.md)objets décrivant les énoncés traités par votre bot. La réponse contient un maximum de 100 `UtteranceData` objets pour chaque version. Amazon Lex renvoie les énoncés les plus fréquemment reçus par le bot au cours des 15 derniers jours.  
Type : tableau d’objets [UtteranceList](API_UtteranceList.md)

## Erreurs
<a name="API_GetUtterancesView_Errors"></a>

 ** 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

## Voir aussi
<a name="API_GetUtterancesView_SeeAlso"></a>

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/GetUtterancesView) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Obtient la liste des balises associées à la ressource spécifiée. Seuls les bots, les alias de robots et les canaux de robots peuvent être associés à des balises.

## Syntaxe de la demande
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/resourceArn HTTP/1.1
```

## Paramètres de demande URI
<a name="API_ListTagsForResource_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="lex-ListTagsForResource-request-uri-resourceArn"></a>
Le nom de ressource Amazon (ARN) de la ressource pour laquelle vous souhaitez obtenir une liste de balises.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1011.  
Obligatoire : oui

## Corps de la demande
<a name="API_ListTagsForResource_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_ListTagsForResource_ResponseElements"></a>

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.

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="lex-ListTagsForResource-response-tags"></a>
Les balises associées à une ressource.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

## Erreurs
<a name="API_ListTagsForResource_Errors"></a>

 ** 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
<a name="API_ListTagsForResource_SeeAlso"></a>

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/ListTagsForResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ListTagsForResource) 

# PutBot
<a name="API_PutBot"></a>

Crée un bot conversationnel Amazon Lex ou remplace un bot existant. Lorsque vous créez ou mettez à jour un bot, il vous suffit de spécifier un nom, un paramètre régional et de préciser si le bot est destiné aux enfants de moins de 13 ans. Vous pouvez l'utiliser pour ajouter des intentions ultérieurement ou pour supprimer des intentions d'un bot existant. Lorsque vous créez un bot avec le minimum d'informations, celui-ci est créé ou mis à jour, mais Amazon Lex renvoie la `` réponse`FAILED`. Vous pouvez créer le bot après avoir ajouté une ou plusieurs intentions. Pour plus d'informations sur les robots Amazon Lex, consultez[Amazon Lex : comment ça marche](how-it-works.md). 

Si vous spécifiez le nom d'un bot existant, les champs de la demande remplacent les valeurs existantes dans la `$LATEST` version du bot. Amazon Lex supprime tous les champs pour lesquels vous ne fournissez pas de valeurs dans la demande, à l'exception des `privacySettings` champs `idleTTLInSeconds` et, qui sont définis sur leurs valeurs par défaut. Si vous ne spécifiez aucune valeur pour les champs obligatoires, Amazon Lex émet une exception.

Cette opération exige des autorisations pour l’action `lex:PutBot`. Pour de plus amples informations, veuillez consulter [Identity and Access Management pour Amazon Lex](security-iam.md).

## Syntaxe de la demande
<a name="API_PutBot_RequestSyntax"></a>

```
PUT /bots/name/versions/$LATEST HTTP/1.1
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"
   },
   "createVersion": boolean,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "locale": "string",
   "nluIntentConfidenceThreshold": number,
   "processBehavior": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "voiceId": "string"
}
```

## Paramètres de demande URI
<a name="API_PutBot_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-uri-name"></a>
Le nom du bot. Le nom *ne distingue pas les majuscules* et minuscules.   
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_PutBot_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [abortStatement](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-abortStatement"></a>
Lorsqu'Amazon Lex ne parvient pas à comprendre la saisie de l'utilisateur dans son contexte, il essaie d'obtenir les informations à plusieurs reprises. Amazon Lex envoie ensuite le message défini `abortStatement` à l'utilisateur, puis annule la conversation. Pour définir le nombre de tentatives, utilisez le `valueElicitationPrompt` champ correspondant au type de slot.   
Par exemple, dans un robot de commande de pizzas, Amazon Lex peut demander à un utilisateur « Quel type de croûte souhaitez-vous ? » Si la réponse de l'utilisateur n'est pas l'une des réponses attendues (par exemple, « croûte mince », « plat profond », etc.), Amazon Lex essaie d'obtenir une réponse correcte plusieurs fois de plus.   
Par exemple, dans une application de commande de pizzas, `OrderPizza` cela peut être l'une des intentions. Cette intention peut nécessiter le `CrustType` slot. Vous spécifiez le `valueElicitationPrompt` champ lorsque vous créez le `CrustType` slot.  
Si vous avez défini une intention de remplacement, la déclaration d'annulation ne sera pas envoyée à l'utilisateur, c'est l'intention de secours qui est utilisée à la place. Pour plus d'informations, consultez [AMAZON. FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html).  
Type : objet [Statement](API_Statement.md)  
Obligatoire : non

 ** [checksum](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-checksum"></a>
Identifie une révision spécifique de la `$LATEST` version.  
Lorsque vous créez un nouveau bot, laissez le `checksum` champ vide. Si vous spécifiez une somme de contrôle, vous obtenez une `BadRequestException` exception.  
Lorsque vous souhaitez mettre à jour un bot, définissez le `checksum` champ sur la somme de contrôle de la dernière révision de la `$LATEST` version. Si vous ne spécifiez pas le ` checksum` champ, ou si la somme de contrôle ne correspond pas à la `$LATEST` version, vous obtenez une `PreconditionFailedException` exception.  
Type : chaîne  
Obligatoire : non

 ** [childDirected](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-childDirected"></a>
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  
Obligatoire : oui

 ** [clarificationPrompt](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-clarificationPrompt"></a>
Lorsqu'Amazon Lex ne comprend pas l'intention de l'utilisateur, il utilise ce message pour obtenir des éclaircissements. Pour spécifier combien de fois Amazon Lex doit répéter l'invite de clarification, utilisez le `maxAttempts` champ. Si Amazon Lex ne comprend toujours pas, il envoie le message `abortStatement` sur le terrain.   
Lorsque vous créez une invite de clarification, assurez-vous qu'elle suggère la bonne réponse de la part de l'utilisateur. Par exemple, pour un bot qui commande des pizzas et des boissons, vous pouvez créer cette invite de clarification : « Que souhaitez-vous faire ? Vous pouvez dire « Commandez une pizza » ou « Commandez un verre ». »  
Si vous avez défini une intention de remplacement, elle sera invoquée si l'invite de clarification est répétée le nombre de fois défini dans le `maxAttempts` champ. Pour plus d'informations, consultez [AMAZON. FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html).  
Si vous ne définissez pas d'invite de clarification, Amazon Lex renverra une exception 400 Bad Request au moment de l'exécution dans trois cas :   
+ Demande de suivi : lorsque l'utilisateur répond à une demande de suivi sans fournir d'intention. Par exemple, en réponse à une demande de suivi indiquant « Voulez-vous autre chose aujourd'hui ? » l'utilisateur répond « Oui ». Amazon Lex renverra une exception 400 Bad Request car aucune demande de clarification n'est à envoyer à l'utilisateur pour obtenir une intention.
+ Fonction Lambda : lorsque vous utilisez une fonction Lambda, vous renvoyez un type de dialogue. `ElicitIntent` Amazon Lex n'étant pas invité à clarifier l'intention de l'utilisateur, il renvoie une exception 400 Bad Request.
+ PutSession opération - Lorsque vous utilisez l'`PutSession`opération, vous envoyez un type `ElicitIntent` de dialogue. Amazon Lex n'étant pas invité à clarifier l'intention de l'utilisateur, il renvoie une exception 400 Bad Request.
Type : objet [Prompt](API_Prompt.md)  
Obligatoire : non

 ** [createVersion](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-createVersion"></a>
Lorsqu'il est réglé sur `true` une nouvelle version numérotée du bot est créée. Cela revient à appeler l'`CreateBotVersion`opération. Si vous ne le spécifiez pas`createVersion`, la valeur par défaut est`false`.  
Type : booléen  
Obligatoire : non

 ** [description](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-description"></a>
Description du bot.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** [detectSentiment](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-detectSentiment"></a>
Lorsque ce paramètre est défini sur « `true` utilisateur », les énoncés sont envoyés à Amazon Comprehend pour analyse des sentiments. Si vous ne le spécifiez pas`detectSentiment`, la valeur par défaut est`false`.  
Type : booléen  
Obligatoire : non

 ** [enableModelImprovements](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-enableModelImprovements"></a>
Réglez sur `true` pour permettre l'accès aux améliorations de compréhension du langage naturel.   
Lorsque vous définissez le `enableModelImprovements` paramètre sur, `true` vous pouvez l'`nluIntentConfidenceThreshold`utiliser pour configurer les scores de confiance. Pour plus d'informations, consultez la section [Scores de confiance](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html).  
Vous ne pouvez définir le `enableModelImprovements` paramètre que dans certaines régions. Si vous définissez le paramètre sur`true`, votre bot a accès à des améliorations de précision.  
Les régions dans lesquelles vous pouvez définir le `enableModelImprovements` paramètre `false` pour les paramètres régionaux en-US sont les suivantes :  
+ USA Est (Virginie du Nord) (us-east-1)
+ USA Ouest (Oregon) (us-west-2)
+ Asie-Pacifique (Sydney) (ap-southeast-2)
+ EU (Irlande) (eu-west-1)
Dans les autres régions et régions, le `enableModelImprovements` paramètre est défini `true` par défaut. Dans ces régions et régions, le fait de définir le paramètre `false` sur génère une `ValidationException` exception.  
Type : booléen  
Obligatoire : non

 ** [idleSessionTTLInSeconds](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-idleSessionTTLInSeconds"></a>
Durée maximale en secondes pendant laquelle Amazon Lex conserve les données collectées au cours d'une conversation.  
Une session d'interaction utilisateur reste active pendant la durée spécifiée. Si aucune conversation n'a lieu pendant cette période, la session expire et Amazon Lex supprime toutes les données fournies avant l'expiration du délai.  
Supposons, par exemple, qu'un utilisateur choisisse son OrderPizza intention, mais qu'il se laisse distraire à mi-chemin de la commande. Si l'utilisateur ne termine pas la commande dans le délai imparti, Amazon Lex supprime les informations sur les créneaux qu'il a collectées et l'utilisateur doit recommencer à zéro.  
Si vous n'incluez pas l'`idleSessionTTLInSeconds`élément dans une demande d'`PutBot`opération, Amazon Lex utilise la valeur par défaut. Cela est également vrai si la demande remplace un bot existant.  
La valeur par défaut est de 300 secondes (5 minutes).  
Type : Integer  
Plage valide : Valeur minimum de 60. Valeur maximum de 86 400.  
Obligatoire : non

 ** [intents](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-intents"></a>
Tableau d’objets `Intent`. Chaque intention représente une commande qu'un utilisateur peut exprimer. Par exemple, un robot de commande de pizzas peut soutenir une OrderPizza intention. Pour de plus amples informations, veuillez consulter [Amazon Lex : comment ça marche](how-it-works.md).  
Type : tableau d’objets [Intent](API_Intent.md)  
Obligatoire : non

 ** [locale](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-locale"></a>
 Spécifie les paramètres régionaux cibles pour le bot. Toute intention utilisée dans le bot doit être compatible avec les paramètres régionaux du bot.   
La valeur par défaut est `en-US`.  
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`   
Obligatoire : oui

 ** [nluIntentConfidenceThreshold](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-nluIntentConfidenceThreshold"></a>
Détermine le seuil auquel Amazon Lex insérera `AMAZON.FallbackIntent` le `AMAZON.KendraSearchIntent` 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.FallbackIntent`et ne `AMAZON.KendraSearchIntent` sont insérés que s'ils sont configurés pour le bot.  
Vous devez définir le `enableModelImprovements` paramètre sur `true` pour utiliser les scores de confiance dans les régions suivantes.  
+ USA Est (Virginie du Nord) (us-east-1)
+ USA Ouest (Oregon) (us-west-2)
+ Asie-Pacifique (Sydney) (ap-southeast-2)
+ EU (Irlande) (eu-west-1)
Dans les autres régions, le `enableModelImprovements` paramètre est défini `true` par défaut.  
Supposons, par exemple, qu'un bot soit configuré avec le seuil de confiance de 0,80 et le`AMAZON.FallbackIntent`. Amazon Lex renvoie trois intentions alternatives avec les scores de confiance suivants : IntentA (0,70), IntentB (0,60), IntentC (0,50). La réponse de l'`PostText`opération serait la suivante :  
+ AMAZON. FallbackIntent
+ à Tenta
+ IntenteB
+ Intente C
Type : double  
Plage valide : Valeur minimum de 0. Valeur maximale de 1.  
Obligatoire : non

 ** [processBehavior](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-processBehavior"></a>
Si vous définissez l'`processBehavior`élément sur`BUILD`, Amazon Lex crée le bot afin qu'il puisse être exécuté. Si vous définissez l'élément `SAVE` sur Amazon Lex, il enregistre le bot, mais ne le crée pas.   
Si vous ne spécifiez pas cette valeur, la valeur par défaut est`BUILD`.  
Type : Chaîne  
Valeurs valides : `SAVE | BUILD`   
Obligatoire : non

 ** [tags](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-tags"></a>
Une liste de balises à ajouter au bot. Vous ne pouvez ajouter des balises que lorsque vous créez un bot, vous ne pouvez pas utiliser l'`PutBot`opération pour mettre à jour les balises d'un bot. Pour mettre à jour les balises, utilisez l'opération `TagResource`.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

 ** [voiceId](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-voiceId"></a>
L'identifiant vocal Amazon Polly que vous souhaitez qu'Amazon Lex utilise pour les interactions vocales avec l'utilisateur. Les paramètres régionaux configurés pour la voix doivent correspondre aux paramètres régionaux du bot. Pour plus d'informations, consultez [Voices in Amazon Polly dans le manuel Amazon Polly](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html) *Developer Guide*.  
Type : chaîne  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_PutBot_ResponseSyntax"></a>

```
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,
   "createVersion": boolean,
   "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",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "version": "string",
   "voiceId": "string"
}
```

## Eléments de réponse
<a name="API_PutBot_ResponseElements"></a>

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_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-abortStatement"></a>
Le message utilisé par Amazon Lex pour annuler une conversation. Pour de plus amples informations, veuillez consulter [PutBot](#API_PutBot).  
Type : objet [Statement](API_Statement.md)

 ** [checksum](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-checksum"></a>
Somme de contrôle du bot que vous avez créé.  
Type : Chaîne

 ** [childDirected](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-childDirected"></a>
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_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-clarificationPrompt"></a>
 Les invites qu'Amazon Lex utilise lorsqu'il ne comprend pas l'intention de l'utilisateur. Pour de plus amples informations, veuillez consulter [PutBot](#API_PutBot).   
Type : objet [Prompt](API_Prompt.md)

 ** [createdDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createdDate"></a>
Date à laquelle le bot a été créé.  
Type : Timestamp

 ** [createVersion](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createVersion"></a>
 `True`si une nouvelle version du bot a été créée. Si le `createVersion` champ n'a pas été spécifié dans la demande, le `createVersion` champ est défini sur false dans la réponse.  
Type : Boolean

 ** [description](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-description"></a>
Description du bot.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [detectSentiment](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-detectSentiment"></a>
 `true`si le bot est configuré pour envoyer les déclarations des utilisateurs à Amazon Comprehend à des fins d'analyse des sentiments. Si le `detectSentiment` champ n'a pas été spécifié dans la demande, il figure `false` dans la réponse. `detectSentiment`  
Type : Boolean

 ** [enableModelImprovements](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-enableModelImprovements"></a>
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_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-failureReason"></a>
Dans `status` l'affirmative`FAILED`, Amazon Lex fournit la raison pour laquelle il n'a pas réussi à créer le bot.  
Type : Chaîne

 ** [idleSessionTTLInSeconds](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-idleSessionTTLInSeconds"></a>
Durée maximale 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).  
Type : Integer  
Plage valide : Valeur minimum de 60. Valeur maximum de 86 400.

 ** [intents](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-intents"></a>
Tableau d’objets `Intent`. Pour de plus amples informations, veuillez consulter [PutBot](#API_PutBot).  
Type : tableau d’objets [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-lastUpdatedDate"></a>
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_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-locale"></a>
 La localisation cible pour le 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_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-name"></a>
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_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-nluIntentConfidenceThreshold"></a>
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_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-status"></a>
 Lorsque vous envoyez une demande pour créer un bot `processBehavior` défini sur`BUILD`, Amazon Lex définit l'élément de `status` réponse sur`BUILDING`.  
Dans `READY_BASIC_TESTING` cet état, vous pouvez tester le bot avec des entrées utilisateur qui correspondent exactement aux énoncés configurés en fonction des intentions et des valeurs du bot dans les types d'emplacements.  
Si Amazon Lex ne parvient pas à créer le bot, Amazon Lex passe `status` à`FAILED`. Amazon Lex renvoie la raison de l'échec dans l'élément de `failureReason` réponse.   
Lorsque vous définissez `processBehavior` sur`SAVE`, Amazon Lex définit le code de statut sur`NOT BUILT`.  
Lorsque le bot est dans `READY` cet état, vous pouvez le tester et le publier.  
Type : Chaîne  
Valeurs valides : `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [tags](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-tags"></a>
Liste des balises associées au bot.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

 ** [version](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-version"></a>
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_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-voiceId"></a>
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).  
Type : Chaîne

## Erreurs
<a name="API_PutBot_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** PreconditionFailedException **   
 La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.  
Code d’état HTTP : 412

## Voir aussi
<a name="API_PutBot_SeeAlso"></a>

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/PutBot) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBot) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBot) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBot) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBot) 

# PutBotAlias
<a name="API_PutBotAlias"></a>

Crée un alias pour la version spécifiée du bot ou remplace un alias pour le bot spécifié. Pour modifier la version du bot vers laquelle pointe l'alias, remplacez l'alias. Pour en savoir plus sur les alias, consultez la section [Versions et alias](versioning-aliases.md).

Cette opération exige des autorisations pour l’action `lex:PutBotAlias`. 

## Syntaxe de la demande
<a name="API_PutBotAlias_RequestSyntax"></a>

```
PUT /bots/botName/aliases/name HTTP/1.1
Content-type: application/json

{
   "botVersion": "string",
   "checksum": "string",
   "conversationLogs": { 
      "iamRoleArn": "string",
      "logSettings": [ 
         { 
            "destination": "string",
            "kmsKeyArn": "string",
            "logType": "string",
            "resourceArn": "string"
         }
      ]
   },
   "description": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Paramètres de demande URI
<a name="API_PutBotAlias_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [botName](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-botName"></a>
Le nom du bot.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [name](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-name"></a>
Nom de l’alias. Le nom *ne distingue pas les majuscules* et minuscules.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_PutBotAlias_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [botVersion](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-botVersion"></a>
La version du bot.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : oui

 ** [checksum](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-checksum"></a>
Identifie une révision spécifique de la `$LATEST` version.  
Lorsque vous créez un nouvel alias de bot, laissez le `checksum` champ vide. Si vous spécifiez une somme de contrôle, vous obtenez une `BadRequestException` exception.  
Lorsque vous souhaitez mettre à jour l'alias d'un bot, définissez le `checksum` champ sur la somme de contrôle de la dernière révision de la `$LATEST` version. Si vous ne spécifiez pas le ` checksum` champ, ou si la somme de contrôle ne correspond pas à la `$LATEST` version, vous obtenez une `PreconditionFailedException` exception.  
Type : chaîne  
Obligatoire : non

 ** [conversationLogs](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-conversationLogs"></a>
Paramètres des journaux de conversation pour l'alias.  
Type : objet [ConversationLogsRequest](API_ConversationLogsRequest.md)  
Obligatoire : non

 ** [description](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-description"></a>
Description de l’alias.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** [tags](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-tags"></a>
Liste des balises à ajouter à l'alias du bot. Vous ne pouvez ajouter des balises que lorsque vous créez un alias. Vous ne pouvez pas utiliser l'`PutBotAlias`opération pour mettre à jour les balises d'un alias de bot. Pour mettre à jour les balises, utilisez l'opération `TagResource`.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_PutBotAlias_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botName": "string",
   "botVersion": "string",
   "checksum": "string",
   "conversationLogs": { 
      "iamRoleArn": "string",
      "logSettings": [ 
         { 
            "destination": "string",
            "kmsKeyArn": "string",
            "logType": "string",
            "resourceArn": "string",
            "resourcePrefix": "string"
         }
      ]
   },
   "createdDate": number,
   "description": "string",
   "lastUpdatedDate": number,
   "name": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_PutBotAlias_ResponseElements"></a>

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.

 ** [botName](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botName"></a>
Nom du robot sur lequel l'alias pointe.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [botVersion](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botVersion"></a>
Version du bot vers laquelle pointe l'alias.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

 ** [checksum](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-checksum"></a>
Somme de contrôle pour la version actuelle de l'alias.  
Type : Chaîne

 ** [conversationLogs](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-conversationLogs"></a>
Les paramètres qui déterminent la manière dont Amazon Lex utilise les journaux de conversation pour l'alias.  
Type : objet [ConversationLogsResponse](API_ConversationLogsResponse.md)

 ** [createdDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-createdDate"></a>
Date à laquelle l'alias du bot a été créé.  
Type : Timestamp

 ** [description](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-description"></a>
Description de l’alias.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [lastUpdatedDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-lastUpdatedDate"></a>
Date à laquelle l'alias du 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

 ** [name](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-name"></a>
Nom de l’alias.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [tags](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-tags"></a>
Liste des tags associés à un bot.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

## Erreurs
<a name="API_PutBotAlias_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** PreconditionFailedException **   
 La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.  
Code d’état HTTP : 412

## Voir aussi
<a name="API_PutBotAlias_SeeAlso"></a>

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/PutBotAlias) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBotAlias) 

# PutIntent
<a name="API_PutIntent"></a>

Crée une intention ou remplace une intention existante.

Pour définir l'interaction entre l'utilisateur et votre bot, vous devez utiliser une ou plusieurs intentions. Pour un robot qui commande des pizzas, par exemple, vous devez créer une `OrderPizza` intention. 

Pour créer une intention ou remplacer une intention existante, vous devez fournir les informations suivantes :
+ Nom de l'intention. Par exemple, `OrderPizza`.
+ Exemples d'énoncés. Par exemple, « Puis-je commander une pizza, s'il vous plaît ? » et « Je veux commander une pizza. »
+ Informations à recueillir. Vous spécifiez les types d'emplacements pour les informations que votre bot demandera à l'utilisateur. Vous pouvez spécifier des types de créneaux standard, tels qu'une date ou une heure, ou des types de créneaux personnalisés tels que la taille et la croûte d'une pizza.
+ Comment l'intention sera-t-elle atteinte ? Vous pouvez fournir une fonction Lambda ou configurer l'intention pour renvoyer les informations d'intention à l'application cliente. Si vous utilisez une fonction Lambda, lorsque toutes les informations d'intention sont disponibles, Amazon Lex appelle votre fonction Lambda. Si vous configurez votre intention pour renvoyer les informations d'intention à l'application cliente. 

Vous pouvez spécifier d'autres informations facultatives dans la demande, telles que :
+ Une invite de confirmation demandant à l'utilisateur de confirmer une intention. Par exemple, « Dois-je commander votre pizza ? »
+ Une déclaration de conclusion à envoyer à l'utilisateur une fois que l'intention a été atteinte. Par exemple, « J'ai passé votre commande de pizza ».
+ Une invite de suivi demandant à l'utilisateur d'effectuer une activité supplémentaire. Par exemple, demander « Voulez-vous commander un verre avec votre pizza ? »

Si vous spécifiez un nom d'intention existant pour mettre à jour l'intention, Amazon Lex remplace les valeurs de la `$LATEST` version de l'intention par celles de la demande. Amazon Lex supprime les champs que vous ne fournissez pas dans la demande. Si vous ne spécifiez pas les champs obligatoires, Amazon Lex génère une exception. Lorsque vous mettez à jour la `$LATEST` version d'une intention, le `status` champ de tout bot utilisant la `$LATEST` version de l'intention est défini sur`NOT_BUILT`.

Pour de plus amples informations, veuillez consulter [Amazon Lex : comment ça marche](how-it-works.md).

Cette opération exige des autorisations pour l’action `lex:PutIntent`.

## Syntaxe de la demande
<a name="API_PutIntent_RequestSyntax"></a>

```
PUT /intents/name/versions/$LATEST HTTP/1.1
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createVersion": boolean,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ]
}
```

## Paramètres de demande URI
<a name="API_PutIntent_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-uri-name"></a>
Nom de l'intention. Le nom *ne distingue pas les majuscules* et minuscules.   
Le nom ne peut pas correspondre à un nom d'intention intégré ou à un nom d'intention intégré avec « AMAZON ». supprimé. Par exemple, étant donné qu'une intention intégrée est appelée`AMAZON.HelpIntent`, vous ne pouvez pas créer une intention personnalisée appelée`HelpIntent`.  
Pour obtenir la liste des intentions prédéfinies, consultez [Intentions prédéfinies standard](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) dans le *kit Alexa Skills*.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_PutIntent_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [checksum](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-checksum"></a>
Identifie une révision spécifique de la `$LATEST` version.  
Lorsque vous créez une nouvelle intention, laissez le `checksum` champ vide. Si vous spécifiez une somme de contrôle, vous obtenez une `BadRequestException` exception.  
Lorsque vous souhaitez mettre à jour une intention, définissez le `checksum` champ sur la somme de contrôle de la dernière révision de la `$LATEST` version. Si vous ne spécifiez pas le ` checksum` champ, ou si la somme de contrôle ne correspond pas à la `$LATEST` version, vous obtenez une `PreconditionFailedException` exception.  
Type : chaîne  
Obligatoire : non

 ** [conclusionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-conclusionStatement"></a>
 Déclaration que vous souhaitez qu'Amazon Lex transmette à l'utilisateur une fois que l'intention a été remplie avec succès par la fonction Lambda.   
Cet élément n'est pertinent que si vous fournissez une fonction Lambda dans le. `fulfillmentActivity` Si vous renvoyez l'intention à l'application cliente, vous ne pouvez pas spécifier cet élément.  
Les `followUpPrompt` et s'`conclusionStatement`excluent mutuellement. Vous ne pouvez en spécifier qu'un.
Type : objet [Statement](API_Statement.md)  
Obligatoire : non

 ** [confirmationPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-confirmationPrompt"></a>
Invite l'utilisateur à confirmer son intention. Cette question doit recevoir une réponse par oui ou par non.  
Amazon Lex utilise cette invite pour s'assurer que l'utilisateur reconnaît que l'intention est prête à être exécutée. Par exemple, dans le `OrderPizza` but de le faire, vous souhaiterez peut-être confirmer que la commande est correcte avant de la passer. À d'autres fins, telles que celles qui répondent simplement aux questions des utilisateurs, il se peut que vous n'ayez pas besoin de demander une confirmation à l'utilisateur avant de fournir les informations.   
Vous devez fournir à la fois le `rejectionStatement` et le`confirmationPrompt`, ou aucun des deux.
Type : objet [Prompt](API_Prompt.md)  
Obligatoire : non

 ** [createVersion](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-createVersion"></a>
Lorsqu'elle est définie sur `true` une nouvelle version numérotée de l'intention est créée. Cela revient à appeler l'`CreateIntentVersion`opération. Si vous ne le spécifiez pas`createVersion`, la valeur par défaut est`false`.  
Type : booléen  
Obligatoire : non

 ** [description](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-description"></a>
Une description de l'intention.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** [dialogCodeHook](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-dialogCodeHook"></a>
 Spécifie une fonction Lambda à appeler pour chaque entrée utilisateur. Vous pouvez invoquer cette fonction Lambda pour personnaliser l'interaction de l'utilisateur.   
Supposons, par exemple, que votre bot détermine que l'utilisateur est John. Votre fonction Lambda peut récupérer les informations de John dans une base de données principale et préremplir certaines valeurs. Par exemple, si vous constatez que John est intolérant au gluten, vous pouvez définir le créneau d'intention correspondant sur true. `GlutenIntolerant` Vous pouvez trouver le numéro de téléphone de John et définir l'attribut de session correspondant.   
Type : objet [CodeHook](API_CodeHook.md)  
Obligatoire : non

 ** [followUpPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-followUpPrompt"></a>
Amazon Lex utilise cette invite pour solliciter une activité supplémentaire après avoir répondu à une intention. Par exemple, une fois l'`OrderPizza`intention remplie, vous pouvez demander à l'utilisateur de commander une boisson.  
L'action entreprise par Amazon Lex dépend de la réponse de l'utilisateur, comme suit :  
+ Si l'utilisateur répond « Oui », il répond par l'invite de clarification configurée pour le bot.
+ si l'utilisateur répond « Oui » et continue avec un énoncé qui déclenche une intention, il entame une conversation pour cette intention.
+ Si l'utilisateur répond « Non », il répond par la déclaration de rejet configurée pour l'invite de suivi.
+ S'il ne reconnaît pas l'énoncé, il répète à nouveau l'invite de suivi.
Le `followUpPrompt` champ et le `conclusionStatement` champ s'excluent mutuellement. Vous ne pouvez en spécifier qu'un.   
Type : objet [FollowUpPrompt](API_FollowUpPrompt.md)  
Obligatoire : non

 ** [fulfillmentActivity](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-fulfillmentActivity"></a>
Obligatoire. Décrit comment l'intention est atteinte. Par exemple, une fois qu'un utilisateur a fourni toutes les informations relatives à une commande de pizza, `fulfillmentActivity` définit la manière dont le bot passe une commande auprès d'une pizzeria locale.   
 Vous pouvez configurer Amazon Lex pour renvoyer toutes les informations d'intention à l'application cliente, ou lui demander d'appeler une fonction Lambda capable de traiter l'intention (par exemple, passer une commande auprès d'une pizzeria).   
Type : objet [FulfillmentActivity](API_FulfillmentActivity.md)  
Obligatoire : non

 ** [inputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-inputContexts"></a>
Tableau d'`InputContext`objets répertoriant les contextes qui doivent être actifs pour qu'Amazon Lex puisse choisir l'intention d'une conversation avec l'utilisateur.  
Type : tableau d’objets [InputContext](API_InputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 5 éléments.  
Obligatoire : non

 ** [kendraConfiguration](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-kendraConfiguration"></a>
Informations de configuration requises pour utiliser l'`AMAZON.KendraSearchIntent`intention de se connecter à un index Amazon Kendra. Pour plus d'informations, consultez [AMAZON. KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html).  
Type : objet [KendraConfiguration](API_KendraConfiguration.md)  
Obligatoire : non

 ** [outputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-outputContexts"></a>
Tableau d'`OutputContext`objets répertoriant les contextes que l'intention active lorsqu'elle est réalisée.  
Type : tableau d’objets [OutputContext](API_OutputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.  
Obligatoire : non

 ** [parentIntentSignature](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-parentIntentSignature"></a>
Un identifiant unique pour l'intention intégrée sur laquelle baser cette intention. Pour trouver la signature d'une intention, consultez la section [Intentions intégrées standard dans](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) le *kit de compétences Alexa*.  
Type : chaîne  
Obligatoire : non

 ** [rejectionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-rejectionStatement"></a>
Lorsque l'utilisateur répond « non » à la question définie dans`confirmationPrompt`, Amazon Lex répond par cette déclaration pour confirmer que l'intention a été annulée.   
Vous devez fournir à la fois le `rejectionStatement` et le`confirmationPrompt`, ou aucun des deux.
Type : objet [Statement](API_Statement.md)  
Obligatoire : non

 ** [sampleUtterances](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-sampleUtterances"></a>
Un ensemble d'énoncés (chaînes) qu'un utilisateur peut prononcer pour signaler son intention. Par exemple, « Je veux \$1PizzaSize\$1 pizza », « Commander \$1Quantité\$1 \$1PizzaSize\$1 pizzas ».   
Dans chaque énoncé, le nom d'une case est placé entre accolades.   
Type : tableau de chaînes  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 500 articles.  
Contraintes de longueur : longueur minimale de 1. Longueur maximum de 200.  
Obligatoire : non

 ** [slots](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-slots"></a>
Un ensemble de créneaux d'intention. Au moment de l'exécution, Amazon Lex demande à l'utilisateur les valeurs d'emplacement requises à l'aide des instructions définies dans les emplacements. Pour de plus amples informations, veuillez consulter [Amazon Lex : comment ça marche](how-it-works.md).   
Type : tableau d’objets [Slot](API_Slot.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 100 éléments.  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_PutIntent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "createVersion": boolean,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}
```

## Eléments de réponse
<a name="API_PutIntent_ResponseElements"></a>

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.

 ** [checksum](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-checksum"></a>
Somme de contrôle de la `$LATEST` version de l'intention créée ou mise à jour.  
Type : Chaîne

 ** [conclusionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-conclusionStatement"></a>
Une fois que la fonction Lambda spécifiée dans l'`fulfillmentActivity`intention répond à l'intention, Amazon Lex transmet cette déclaration à l'utilisateur.  
Type : objet [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-confirmationPrompt"></a>
Si elle est définie dans l'intention, Amazon Lex invite l'utilisateur à confirmer l'intention avant de la réaliser.  
Type : objet [Prompt](API_Prompt.md)

 ** [createdDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createdDate"></a>
Date à laquelle l'intention a été créée.  
Type : Timestamp

 ** [createVersion](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createVersion"></a>
 `True`si une nouvelle version de l'intention a été créée. Si le `createVersion` champ n'a pas été spécifié dans la demande, le `createVersion` champ est défini sur false dans la réponse.  
Type : Boolean

 ** [description](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-description"></a>
Une description de l'intention.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [dialogCodeHook](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-dialogCodeHook"></a>
Si elle est définie dans l'intention, Amazon Lex invoque cette fonction Lambda pour chaque entrée utilisateur.  
Type : objet [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-followUpPrompt"></a>
Si cela est défini dans l'intention, Amazon Lex utilise cette invite pour solliciter une activité supplémentaire de l'utilisateur une fois que l'intention est remplie.  
Type : objet [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-fulfillmentActivity"></a>
Si elle est définie dans l'intention, Amazon Lex invoque cette fonction Lambda pour répondre à l'intention une fois que l'utilisateur a fourni toutes les informations requises par l'intention.  
Type : objet [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-inputContexts"></a>
Tableau d'`InputContext`objets répertoriant les contextes qui doivent être actifs pour qu'Amazon Lex puisse choisir l'intention d'une conversation avec l'utilisateur.  
Type : tableau d’objets [InputContext](API_InputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 5 éléments.

 ** [kendraConfiguration](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-kendraConfiguration"></a>
Les informations de configuration, le cas échéant, sont requises pour se connecter à un index Amazon Kendra et utiliser l'`AMAZON.KendraSearchIntent`intention.  
Type : objet [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-lastUpdatedDate"></a>
Date à laquelle l'intention a été mise à jour. Lorsque vous créez une ressource, la date de création et la date de dernière mise à jour sont identiques.  
Type : Timestamp

 ** [name](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-name"></a>
Nom de l'intention.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-outputContexts"></a>
Tableau d'`OutputContext`objets répertoriant les contextes que l'intention active lorsqu'elle est réalisée.  
Type : tableau d’objets [OutputContext](API_OutputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

 ** [parentIntentSignature](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-parentIntentSignature"></a>
Identifiant unique de l'intention intégrée sur laquelle cette intention est basée.  
Type : Chaîne

 ** [rejectionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-rejectionStatement"></a>
Si l'utilisateur répond « non » à la question définie dans `confirmationPrompt` Amazon Lex, celui-ci répond par cette déclaration pour confirmer que l'intention a été annulée.   
Type : objet [Statement](API_Statement.md)

 ** [sampleUtterances](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-sampleUtterances"></a>
 Un ensemble d'exemples d'énoncés configurés en fonction de l'intention.   
Type : tableau de chaînes  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 500 articles.  
Contraintes de longueur : longueur minimale de 1. Longueur maximum de 200.

 ** [slots](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-slots"></a>
Un ensemble de créneaux d'intention configurés en fonction de l'intention.  
Type : tableau d’objets [Slot](API_Slot.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 100 éléments.

 ** [version](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-version"></a>
Version de l'intention. Pour une nouvelle intention, 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]+` 

## Erreurs
<a name="API_PutIntent_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** PreconditionFailedException **   
 La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.  
Code d’état HTTP : 412

## Voir aussi
<a name="API_PutIntent_SeeAlso"></a>

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/PutIntent) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutIntent) 

# PutSlotType
<a name="API_PutSlotType"></a>

Crée un type d'option personnalisé ou remplace un type d'option personnalisé existant.

Pour créer un type d'emplacement personnalisé, spécifiez un nom pour le type d'emplacement et un ensemble de valeurs d'énumération, qui sont les valeurs qu'un emplacement de ce type peut prendre. Pour de plus amples informations, veuillez consulter [Amazon Lex : comment ça marche](how-it-works.md).

Si vous spécifiez le nom d'un type de slot existant, les champs de la demande remplacent les valeurs existantes dans la `$LATEST` version du type de slot. Amazon Lex supprime les champs que vous ne fournissez pas dans la demande. Si vous ne spécifiez pas de champs obligatoires, Amazon Lex génère une exception. Lorsque vous mettez à jour la `$LATEST` version d'un type d'emplacement, si un bot utilise la `$LATEST` version d'une intention qui contient le type d'emplacement, le `status` champ du bot est défini sur`NOT_BUILT`.

Cette opération exige des autorisations pour l’action `lex:PutSlotType`.

## Syntaxe de la demande
<a name="API_PutSlotType_RequestSyntax"></a>

```
PUT /slottypes/name/versions/$LATEST HTTP/1.1
Content-type: application/json

{
   "checksum": "string",
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string"
}
```

## Paramètres de demande URI
<a name="API_PutSlotType_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-uri-name"></a>
Nom du type d'option. Le nom *ne distingue pas les majuscules* et minuscules.   
Le nom ne peut pas correspondre à un nom de type d'emplacement intégré ou à un nom de type d'emplacement intégré avec « AMAZON ». supprimé. Par exemple, étant donné qu'il existe un type d'emplacement intégré appelé`AMAZON.DATE`, vous ne pouvez pas créer un type d'emplacement personnalisé appelé`DATE`.  
Pour obtenir la liste des types d'emplacements intégrés, consultez la section [Référence des types d'emplacements](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) dans le *kit Alexa Skills*.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_PutSlotType_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [checksum](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-checksum"></a>
Identifie une révision spécifique de la `$LATEST` version.  
Lorsque vous créez un nouveau type d'emplacement, laissez le `checksum` champ vide. Si vous spécifiez un checksum, vous obtenez une `BadRequestException` exception.  
Lorsque vous souhaitez mettre à jour un type d'emplacement, définissez le `checksum` champ sur la somme de contrôle de la dernière révision de la `$LATEST` version. Si vous ne spécifiez pas le ` checksum` champ, ou si la somme de contrôle ne correspond pas à la `$LATEST` version, vous obtenez une `PreconditionFailedException` exception.  
Type : chaîne  
Obligatoire : non

 ** [createVersion](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-createVersion"></a>
Lorsqu'il est réglé sur `true` une nouvelle version numérotée du type de slot est créée. Cela revient à appeler l'`CreateSlotTypeVersion`opération. Si vous ne le spécifiez pas`createVersion`, la valeur par défaut est`false`.  
Type : booléen  
Obligatoire : non

 ** [description](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-description"></a>
Une description du type d'emplacement.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** [enumerationValues](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-enumerationValues"></a>
Liste d'`EnumerationValue`objets qui définit les valeurs que le type de slot peut prendre. Chaque valeur peut comporter une liste de `synonyms` valeurs supplémentaires qui aident à former le modèle d'apprentissage automatique aux valeurs qu'il résout pour un créneau.   
Un type de slot d'expression régulière ne nécessite pas de valeurs d'énumération. Tous les autres types d'emplacements nécessitent une liste de valeurs d'énumération.  
Lorsqu'Amazon Lex résout la valeur d'un emplacement, il génère une liste de résolutions contenant jusqu'à cinq valeurs possibles pour l'emplacement. Si vous utilisez une fonction Lambda, cette liste de résolutions est transmise à la fonction. Si vous n'utilisez pas de fonction Lambda, vous pouvez choisir de renvoyer la valeur saisie par l'utilisateur ou la première valeur de la liste de résolutions en tant que valeur d'intervalle. Le `valueSelectionStrategy` champ indique l'option à utiliser.   
Type : tableau d’objets [EnumerationValue](API_EnumerationValue.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 000 articles.  
Obligatoire : non

 ** [parentSlotTypeSignature](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-parentSlotTypeSignature"></a>
Type d'emplacement intégré utilisé comme parent du type d'emplacement. Lorsque vous définissez un type d'emplacement parent, le nouveau type d'emplacement possède la même configuration que le parent.  
Seule la clause `AMAZON.AlphaNumeric` est prise en charge.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^((AMAZON\.)_?|[A-Za-z]_?)+`   
Obligatoire : non

 ** [slotTypeConfigurations](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-slotTypeConfigurations"></a>
Informations de configuration qui étendent le type de slot intégré du parent. La configuration est ajoutée aux paramètres du type de slot parent.  
Type : tableau d’objets [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.  
Obligatoire : non

 ** [valueSelectionStrategy](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-valueSelectionStrategy"></a>
Détermine la stratégie de résolution des emplacements qu'Amazon Lex utilise pour renvoyer les valeurs des types d'emplacements. Le champ peut être défini sur l'une des valeurs suivantes :  
+  `ORIGINAL_VALUE`- Renvoie la valeur saisie par l'utilisateur, si la valeur utilisateur est similaire à la valeur du slot.
+  `TOP_RESOLUTION`- S'il existe une liste de résolutions pour le slot, renvoyez la première valeur de la liste de résolutions comme valeur du type de slot. S'il n'existe pas de liste de résolution, la valeur null (nulle) est renvoyée.
Si vous ne le spécifiez pas`valueSelectionStrategy`, la valeur par défaut est`ORIGINAL_VALUE`.  
Type : Chaîne  
Valeurs valides : `ORIGINAL_VALUE | TOP_RESOLUTION`   
Obligatoire : non

## Syntaxe de la réponse
<a name="API_PutSlotType_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "createdDate": number,
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "lastUpdatedDate": number,
   "name": "string",
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string",
   "version": "string"
}
```

## Eléments de réponse
<a name="API_PutSlotType_ResponseElements"></a>

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.

 ** [checksum](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-checksum"></a>
Somme de contrôle de la `$LATEST` version du type de slot.  
Type : Chaîne

 ** [createdDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createdDate"></a>
Date à laquelle le type de slot a été créé.  
Type : Timestamp

 ** [createVersion](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createVersion"></a>
 `True`si une nouvelle version du type de slot a été créée. Si le `createVersion` champ n'a pas été spécifié dans la demande, le `createVersion` champ est défini sur false dans la réponse.  
Type : Boolean

 ** [description](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-description"></a>
Une description du type d'emplacement.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [enumerationValues](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-enumerationValues"></a>
Liste d'`EnumerationValue`objets qui définit les valeurs que le type de slot peut prendre.  
Type : tableau d’objets [EnumerationValue](API_EnumerationValue.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 000 articles.

 ** [lastUpdatedDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-lastUpdatedDate"></a>
Date à laquelle le type de slot a été mis à jour. Lorsque vous créez un type de slot, la date de création et la date de dernière mise à jour sont identiques.  
Type : Timestamp

 ** [name](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-name"></a>
Nom du type d'option.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-parentSlotTypeSignature"></a>
Type d'emplacement intégré utilisé comme parent du type d'emplacement.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-slotTypeConfigurations"></a>
Informations de configuration qui étendent le type de slot intégré du parent.  
Type : tableau d’objets [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

 ** [valueSelectionStrategy](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-valueSelectionStrategy"></a>
Stratégie de résolution d'emplacement utilisée par Amazon Lex pour déterminer la valeur de l'emplacement. Pour de plus amples informations, veuillez consulter [PutSlotType](#API_PutSlotType).  
Type : Chaîne  
Valeurs valides : `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-version"></a>
Version du type de slot. Pour un nouveau type de slot, 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]+` 

## Erreurs
<a name="API_PutSlotType_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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

 ** PreconditionFailedException **   
 La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.  
Code d’état HTTP : 412

## Voir aussi
<a name="API_PutSlotType_SeeAlso"></a>

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/PutSlotType) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutSlotType) 

# StartImport
<a name="API_StartImport"></a>

Démarre une tâche pour importer une ressource dans Amazon Lex.

## Syntaxe de la demande
<a name="API_StartImport_RequestSyntax"></a>

```
POST /imports/ HTTP/1.1
Content-type: application/json

{
   "mergeStrategy": "string",
   "payload": blob,
   "resourceType": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Paramètres de demande URI
<a name="API_StartImport_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_StartImport_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [mergeStrategy](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-mergeStrategy"></a>
Spécifie l'action que l'`StartImport`opération doit effectuer lorsqu'il existe une ressource portant le même nom.  
+ FAIL\$1ON\$1CONFLICT - L'opération d'importation est arrêtée lors du premier conflit entre une ressource du fichier d'importation et une ressource existante. Le nom de la ressource à l'origine du conflit se trouve dans le `failureReason` champ de réponse à l'`GetImport`opération.

  OVERWRITE\$1LATEST - L'opération d'importation se poursuit même en cas de conflit avec une ressource existante. La version \$1LASTEST de la ressource existante est remplacée par les données du fichier d'importation.
Type : Chaîne  
Valeurs valides : `OVERWRITE_LATEST | FAIL_ON_CONFLICT`   
Obligatoire : oui

 ** [payload](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-payload"></a>
Une archive zip au format binaire. L'archive doit contenir un fichier, un fichier JSON contenant la ressource à importer. La ressource doit correspondre au type indiqué dans le `resourceType` champ.  
Type : objet de données binaires encodées en base64  
Obligatoire : oui

 ** [resourceType](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-resourceType"></a>
Spécifie le type de ressource à exporter. Chaque ressource exporte également toutes les ressources dont elle dépend.   
+ Un bot exporte des intentions dépendantes.
+ Une intention exporte les types d'emplacements dépendants.
Type : Chaîne  
Valeurs valides : `BOT | INTENT | SLOT_TYPE`   
Obligatoire : oui

 ** [tags](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-tags"></a>
Liste des balises à ajouter au bot importé. Vous ne pouvez ajouter des balises que lorsque vous importez un bot, vous ne pouvez pas ajouter de balises à une intention ou à un type d'emplacement.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_StartImport_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "createdDate": number,
   "importId": "string",
   "importStatus": "string",
   "mergeStrategy": "string",
   "name": "string",
   "resourceType": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_StartImport_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [createdDate](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-createdDate"></a>
Horodatage de la date et de l'heure auxquelles la tâche d'importation a été demandée.  
Type : Timestamp

 ** [importId](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importId"></a>
Identifiant de la tâche d'importation spécifique.  
Type : Chaîne

 ** [importStatus](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importStatus"></a>
État de la tâche d'importation. Si le statut est le cas`FAILED`, vous pouvez obtenir la raison de l'échec à l'aide de l'`GetImport`opération.  
Type : Chaîne  
Valeurs valides : `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-mergeStrategy"></a>
L'action à entreprendre en cas de conflit de fusion.  
Type : Chaîne  
Valeurs valides : `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-name"></a>
Le nom donné à la tâche d'importation.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `[a-zA-Z_]+` 

 ** [resourceType](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-resourceType"></a>
Type de ressource à importer.  
Type : Chaîne  
Valeurs valides : `BOT | INTENT | SLOT_TYPE` 

 ** [tags](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-tags"></a>
Liste des balises ajoutées au bot importé.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

## Erreurs
<a name="API_StartImport_Errors"></a>

 ** 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

## Voir aussi
<a name="API_StartImport_SeeAlso"></a>

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/StartImport) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartImport) 

# StartMigration
<a name="API_StartMigration"></a>

Lance la migration d'un bot d'Amazon Lex V1 vers Amazon Lex V2. Migrez votre bot lorsque vous souhaitez profiter des nouvelles fonctionnalités d'Amazon Lex V2.

Pour plus d'informations, consultez la section [Migration d'un bot](https://docs.aws.amazon.com/lex/latest/dg/migrate.html) dans le *guide du développeur Amazon Lex*.

## Syntaxe de la demande
<a name="API_StartMigration_RequestSyntax"></a>

```
POST /migrations HTTP/1.1
Content-type: application/json

{
   "migrationStrategy": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotName": "string",
   "v2BotRole": "string"
}
```

## Paramètres de demande URI
<a name="API_StartMigration_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_StartMigration_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [migrationStrategy](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-migrationStrategy"></a>
La stratégie utilisée pour effectuer la migration.  
+  `CREATE_NEW`- Crée un nouveau bot Amazon Lex V2 et migre le bot Amazon Lex V1 vers le nouveau bot.
+  `UPDATE_EXISTING`- Remplace les métadonnées du bot Amazon Lex V2 existantes et les paramètres régionaux en cours de migration. Cela ne change aucune autre localisation dans le bot Amazon Lex V2. Si les paramètres régionaux n'existent pas, un nouveau paramètre régional est créé dans le bot Amazon Lex V2.
Type : Chaîne  
Valeurs valides : `CREATE_NEW | UPDATE_EXISTING`   
Obligatoire : oui

 ** [v1BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotName"></a>
Nom du bot Amazon Lex V1 que vous êtes en train de migrer vers Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [v1BotVersion](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotVersion"></a>
Version du bot à migrer vers Amazon Lex V2. Vous pouvez migrer la `$LATEST` version ainsi que toute version numérotée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : oui

 ** [v2BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotName"></a>
Nom du bot Amazon Lex V2 vers lequel vous migrez le bot Amazon Lex V1.   
+ Si le bot Amazon Lex V2 n'existe pas, vous devez utiliser la stratégie de `CREATE_NEW` migration.
+ Si le bot Amazon Lex V2 existe, vous devez utiliser la stratégie de `UPDATE_EXISTING` migration pour modifier le contenu du bot Amazon Lex V2.
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([0-9a-zA-Z][_-]?)+$`   
Obligatoire : oui

 ** [v2BotRole](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotRole"></a>
Rôle IAM utilisé par Amazon Lex pour exécuter le bot Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_StartMigration_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "migrationId": "string",
   "migrationStrategy": "string",
   "migrationTimestamp": number,
   "v1BotLocale": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotId": "string",
   "v2BotRole": "string"
}
```

## Eléments de réponse
<a name="API_StartMigration_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 202.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [migrationId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationId"></a>
Identifiant unique attribué par Amazon Lex à la migration.  
Type : Chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$` 

 ** [migrationStrategy](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationStrategy"></a>
La stratégie utilisée pour effectuer la migration.  
Type : Chaîne  
Valeurs valides : `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationTimestamp"></a>
Date et heure du début de la migration.  
Type : Timestamp

 ** [v1BotLocale](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotLocale"></a>
Les paramètres régionaux utilisés pour le bot Amazon Lex V1.   
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` 

 ** [v1BotName](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotName"></a>
Nom du bot Amazon Lex V1 que vous êtes en train de migrer vers Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotVersion"></a>
Version du bot à migrer vers Amazon Lex V2.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotId"></a>
Identifiant unique du bot Amazon Lex V2.   
Type : Chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotRole"></a>
Rôle IAM utilisé par Amazon Lex pour exécuter le bot Amazon Lex V2.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

## Erreurs
<a name="API_StartMigration_Errors"></a>

 ** AccessDeniedException **   
Votre utilisateur ou rôle IAM n'est pas autorisé à appeler l'Amazon Lex V2 APIs requis pour migrer votre bot.  
Code d’état HTTP : 403

 ** 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
<a name="API_StartMigration_SeeAlso"></a>

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/StartMigration) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartMigration) 

# TagResource
<a name="API_TagResource"></a>

Ajoute les balises spécifiées à la ressource spécifiée. Si une clé de balise existe déjà, la valeur existante est remplacée par la nouvelle valeur.

## Syntaxe de la demande
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Paramètres de demande URI
<a name="API_TagResource_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-uri-resourceArn"></a>
Le nom de ressource Amazon (ARN) du bot, de l'alias du bot ou du canal du bot à étiqueter.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1011.  
Obligatoire : oui

## Corps de la demande
<a name="API_TagResource_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [tags](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-tags"></a>
Liste des clés de balise à ajouter à la ressource. Si une clé de balise existe déjà, la valeur existante est remplacée par la nouvelle valeur.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_TagResource_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_TagResource_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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
<a name="API_TagResource_SeeAlso"></a>

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/TagResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/TagResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/TagResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/TagResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Supprime les balises d'un bot, d'un alias de bot ou d'un canal de bot.

## Syntaxe de la demande
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /tags/resourceArn?tagKeys=tagKeys HTTP/1.1
```

## Paramètres de demande URI
<a name="API_UntagResource_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-resourceArn"></a>
Le nom de ressource Amazon (ARN) de la ressource dont les balises doivent être supprimées.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1011.  
Obligatoire : oui

 ** [tagKeys](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-tagKeys"></a>
Liste des clés de balise à supprimer de la ressource. Si aucune clé de balise n'existe sur la ressource, elle est ignorée.  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128.  
Obligatoire : oui

## Corps de la demande
<a name="API_UntagResource_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Eléments de réponse
<a name="API_UntagResource_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 204 avec un corps HTTP vide.

## Erreurs
<a name="API_UntagResource_Errors"></a>

 ** 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

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** 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
<a name="API_UntagResource_SeeAlso"></a>

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/UntagResource) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UntagResource) 

# Service d'exécution Amazon Lex
<a name="API_Operations_Amazon_Lex_Runtime_Service"></a>

Les actions suivantes sont prises en charge par Amazon Lex Runtime Service :
+  [DeleteSession](API_runtime_DeleteSession.md) 
+  [GetSession](API_runtime_GetSession.md) 
+  [PostContent](API_runtime_PostContent.md) 
+  [PostText](API_runtime_PostText.md) 
+  [PutSession](API_runtime_PutSession.md) 

# DeleteSession
<a name="API_runtime_DeleteSession"></a>

Supprime les informations de session pour un bot, un alias et un ID utilisateur spécifiés. 

## Syntaxe de la demande
<a name="API_runtime_DeleteSession_RequestSyntax"></a>

```
DELETE /bot/botName/alias/botAlias/user/userId/session HTTP/1.1
```

## Paramètres de demande URI
<a name="API_runtime_DeleteSession_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [botAlias](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-botAlias"></a>
Alias utilisé pour le bot qui contient les données de session.  
Obligatoire : oui

 ** [botName](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-botName"></a>
Le nom du bot qui contient les données de session.  
Obligatoire : oui

 ** [userId](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-userId"></a>
Identifiant de l'utilisateur associé aux données de session.  
Contraintes de longueur : longueur minimale de 2. Longueur maximum de 100.  
Modèle : `[0-9a-zA-Z._:-]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_runtime_DeleteSession_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_runtime_DeleteSession_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "botAlias": "string",
   "botName": "string",
   "sessionId": "string",
   "userId": "string"
}
```

## Eléments de réponse
<a name="API_runtime_DeleteSession_ResponseElements"></a>

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.

 ** [botAlias](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botAlias"></a>
Alias utilisé pour le bot associé aux données de session.  
Type : Chaîne

 ** [botName](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botName"></a>
Nom du bot associé aux données de session.  
Type : Chaîne

 ** [sessionId](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-sessionId"></a>
Identifiant unique de la session.  
Type : Chaîne

 ** [userId](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-userId"></a>
ID de l'utilisateur de l'application cliente.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximum de 100.  
Modèle : `[0-9a-zA-Z._:-]+` 

## Erreurs
<a name="API_runtime_DeleteSession_Errors"></a>

 ** BadRequestException **   
 La validation de la demande a échoué, il n'y a aucun message utilisable dans le contexte, ou la création du bot a échoué, est toujours en cours ou contient des modifications non intégrées.   
Code d’état HTTP : 400

 ** ConflictException **   
 Deux clients utilisent le même compte AWS, le même bot Amazon Lex et le même ID utilisateur.   
Code d’état HTTP : 409

 ** InternalFailureException **   
Erreur de service interne. Réessayez l'appel.  
Code d’état HTTP : 500

 ** LimitExceededException **   
Dépassement d'une limite.  
Code d’état HTTP : 429

 ** NotFoundException **   
La ressource (telle que le bot Amazon Lex ou un alias) à laquelle il est fait référence est introuvable.  
Code d’état HTTP :404

## Voir aussi
<a name="API_runtime_DeleteSession_SeeAlso"></a>

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/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/DeleteSession) 

# GetSession
<a name="API_runtime_GetSession"></a>

Renvoie les informations de session pour un robot, un alias et un ID utilisateur spécifiés.

## Syntaxe de la demande
<a name="API_runtime_GetSession_RequestSyntax"></a>

```
GET /bot/botName/alias/botAlias/user/userId/session/?checkpointLabelFilter=checkpointLabelFilter HTTP/1.1
```

## Paramètres de demande URI
<a name="API_runtime_GetSession_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [botAlias](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botAlias"></a>
Alias utilisé pour le bot qui contient les données de session.  
Obligatoire : oui

 ** [botName](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botName"></a>
Nom du bot qui contient les données de session.  
Obligatoire : oui

 ** [checkpointLabelFilter](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-checkpointLabelFilter"></a>
Chaîne utilisée pour filtrer les intentions renvoyées dans la `recentIntentSummaryView` structure.   
Lorsque vous spécifiez un filtre, seules les intentions dont `checkpointLabel` le champ est défini sur cette chaîne sont renvoyées.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 255 caractères.  
Modèle : `[a-zA-Z0-9-]+` 

 ** [userId](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-userId"></a>
ID de l'utilisateur de l'application cliente. Amazon Lex l'utilise pour identifier la conversation d'un utilisateur avec votre bot.   
Contraintes de longueur : longueur minimale de 2. Longueur maximum de 100.  
Modèle : `[0-9a-zA-Z._:-]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_runtime_GetSession_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_runtime_GetSession_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "activeContexts": [ 
      { 
         "name": "string",
         "parameters": { 
            "string" : "string" 
         },
         "timeToLive": { 
            "timeToLiveInSeconds": number,
            "turnsToLive": number
         }
      }
   ],
   "dialogAction": { 
      "fulfillmentState": "string",
      "intentName": "string",
      "message": "string",
      "messageFormat": "string",
      "slots": { 
         "string" : "string" 
      },
      "slotToElicit": "string",
      "type": "string"
   },
   "recentIntentSummaryView": [ 
      { 
         "checkpointLabel": "string",
         "confirmationStatus": "string",
         "dialogActionType": "string",
         "fulfillmentState": "string",
         "intentName": "string",
         "slots": { 
            "string" : "string" 
         },
         "slotToElicit": "string"
      }
   ],
   "sessionAttributes": { 
      "string" : "string" 
   },
   "sessionId": "string"
}
```

## Eléments de réponse
<a name="API_runtime_GetSession_ResponseElements"></a>

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.

 ** [activeContexts](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-activeContexts"></a>
Liste des contextes actifs pour la session. Un contexte peut être défini lorsqu'une intention est remplie ou en appelant l'`PutSession`opération `PostContent``PostText`, ou.  
Vous pouvez utiliser un contexte pour contrôler les intentions qui peuvent suivre une intention ou pour modifier le fonctionnement de votre application.  
Type : tableau d’objets [ActiveContext](API_runtime_ActiveContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 20 éléments.

 ** [dialogAction](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-dialogAction"></a>
Décrit l'état actuel du bot.  
Type : objet [DialogAction](API_runtime_DialogAction.md)

 ** [recentIntentSummaryView](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-recentIntentSummaryView"></a>
Un ensemble d'informations sur les intentions utilisées au cours de la session. Le tableau peut contenir au maximum trois résumés. Si plus de trois intentions sont utilisées au cours de la session, l'`recentIntentSummaryView`opération contient des informations sur les trois dernières intentions utilisées.  
Si vous définissez le `checkpointLabelFilter` paramètre dans la demande, le tableau contient uniquement les intentions portant l'étiquette spécifiée.  
Type : tableau d’objets [IntentSummary](API_runtime_IntentSummary.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 3 articles.

 ** [sessionAttributes](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionAttributes"></a>
Carte des key/value paires représentant les informations contextuelles spécifiques à la session. Il contient les informations d'application transmises entre Amazon Lex et une application cliente.  
Type : mappage chaîne/chaîne

 ** [sessionId](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionId"></a>
Identifiant unique de la session.  
Type : Chaîne

## Erreurs
<a name="API_runtime_GetSession_Errors"></a>

 ** BadRequestException **   
 La validation de la demande a échoué, il n'y a aucun message utilisable dans le contexte, ou la création du bot a échoué, est toujours en cours ou contient des modifications non intégrées.   
Code d’état HTTP : 400

 ** InternalFailureException **   
Erreur de service interne. Réessayez l'appel.  
Code d’état HTTP : 500

 ** LimitExceededException **   
Dépassement d'une limite.  
Code d’état HTTP : 429

 ** NotFoundException **   
La ressource (telle que le bot Amazon Lex ou un alias) à laquelle il est fait référence est introuvable.  
Code d’état HTTP :404

## Voir aussi
<a name="API_runtime_GetSession_SeeAlso"></a>

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/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/GetSession) 

# PostContent
<a name="API_runtime_PostContent"></a>

 Envoie l'entrée utilisateur (texte ou voix) à Amazon Lex. Les clients utilisent cette API pour envoyer des requêtes texte et audio à Amazon Lex lors de l'exécution. Amazon Lex interprète les données saisies par l'utilisateur à l'aide du modèle d'apprentissage automatique qu'il a conçu pour le bot. 

Le `PostContent` fonctionnement prend en charge l'entrée audio à 8 kHz et 16 kHz. Vous pouvez utiliser le son 8 kHz pour obtenir une meilleure précision de reconnaissance vocale dans les applications audio téléphoniques. 

 En réponse, Amazon Lex renvoie le message suivant à transmettre à l'utilisateur. Examinez les exemples de messages suivants : 
+  Lorsqu'un utilisateur saisit « Je voudrais une pizza », Amazon Lex peut renvoyer une réponse avec un message demandant les données du créneau (par exemple,`PizzaSize`) : « Quelle taille de pizza souhaitez-vous ? ». 
+  Une fois que l'utilisateur a fourni toutes les informations relatives à la commande de pizza, Amazon Lex peut renvoyer une réponse contenant un message pour obtenir la confirmation de l'utilisateur : « Vous commandez la pizza ? ». 
+  Une fois que l'utilisateur a répondu « Oui » à l'invite de confirmation, Amazon Lex peut renvoyer une déclaration de conclusion : « Merci, votre pizza au fromage a été commandée. ». 

 Tous les messages Amazon Lex ne nécessitent pas de réponse de la part de l'utilisateur. Par exemple, les énoncés de conclusion ne nécessitent pas de réponse. Certains messages ne nécessitent qu'une réponse par oui ou par non. En outre`message`, Amazon Lex fournit un contexte supplémentaire sur le message dans la réponse, que vous pouvez utiliser pour améliorer le comportement des clients, par exemple en affichant l'interface utilisateur client appropriée. Considérez les exemples suivants : 
+  Si le message vise à obtenir des données d'emplacement, Amazon Lex renvoie les informations contextuelles suivantes : 
  +  `x-amz-lex-dialog-state`en-tête défini sur `ElicitSlot` 
  +  `x-amz-lex-intent-name`en-tête défini sur le nom de l'intention dans le contexte actuel 
  +  `x-amz-lex-slot-to-elicit`en-tête défini sur le nom du slot pour lequel le `message` cherche à obtenir des informations 
  +  `x-amz-lex-slots`en-tête défini sur une carte des emplacements configurés pour l'intention avec leurs valeurs actuelles 
+  Si le message est une invite de confirmation, l'`x-amz-lex-dialog-state`en-tête est défini sur `Confirmation` et l'`x-amz-lex-slot-to-elicit`en-tête est omis. 
+  Si le message est une invite de clarification configurée pour l'intention, indiquant que l'intention de l'utilisateur n'est pas comprise, l'`x-amz-dialog-state`en-tête est défini sur `ElicitIntent` et l'`x-amz-slot-to-elicit`en-tête est omis. 

 En outre, Amazon Lex renvoie également des informations spécifiques à votre application`sessionAttributes`. Pour plus d'informations, consultez [la section Gestion du contexte de conversation](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html). 

## Syntaxe de la demande
<a name="API_runtime_PostContent_RequestSyntax"></a>

```
POST /bot/botName/alias/botAlias/user/userId/content HTTP/1.1
x-amz-lex-session-attributes: sessionAttributes
x-amz-lex-request-attributes: requestAttributes
Content-Type: contentType
Accept: accept
x-amz-lex-active-contexts: activeContexts

inputStream
```

## Paramètres de demande URI
<a name="API_runtime_PostContent_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [accept](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-accept"></a>
 Vous transmettez cette valeur comme en-tête `Accept` HTTP.   
 Le message renvoyé par Amazon Lex dans la réponse peut être texte ou vocal en fonction de la valeur d'en-tête `Accept` HTTP de la demande.   
+  Si la valeur est égale à cette valeur`text/plain; charset=utf-8`, Amazon Lex renvoie du texte dans la réponse. 
+  Si la valeur commence par`audio/`, Amazon Lex renvoie un message vocal dans la réponse. Amazon Lex utilise Amazon Polly pour générer le discours (en utilisant la configuration que vous avez spécifiée dans l'`Accept`en-tête). Par exemple, si vous spécifiez `audio/mpeg` comme valeur, Amazon Lex renvoie la parole au format MPEG.
+ Si la valeur est`audio/pcm`, le discours renvoyé est `audio/pcm` au format Little Endian 16 bits. 
+ Les valeurs acceptées sont les suivantes :
  + audio/mpeg
  + audio/ogg
  + audio/PCM
  + texte/clair ; jeu de caractères = utf-8
  + audio/\$1 (mpeg par défaut)

 ** [activeContexts](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-activeContexts"></a>
Liste des contextes actifs pour la demande. Un contexte peut être activé lorsqu'une intention précédente est satisfaite, ou en incluant le contexte dans la demande,  
Si vous ne spécifiez pas de liste de contextes, Amazon Lex utilisera la liste actuelle des contextes pour la session. Si vous spécifiez une liste vide, tous les contextes de la session sont effacés.

 ** [botAlias](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botAlias"></a>
Alias du bot Amazon Lex.  
Obligatoire : oui

 ** [botName](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botName"></a>
Nom du bot Amazon Lex.  
Obligatoire : oui

 ** [contentType](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-contentType"></a>
 Vous transmettez cette valeur comme en-tête `Content-Type` HTTP.   
 Indique le format audio ou le texte. La valeur de l'en-tête doit commencer par l'un des préfixes suivants :   
+ Format PCM, les données audio doivent être dans l'ordre des octets de l'ordre des petits et dians.
  + audio/l16 ; débit = 16 000 ; canaux = 1
  + audio/x-l16 ; fréquence d'échantillonnage = 16 000 ; nombre de canaux = 1
  + audio/lpcm ; fréquence d'échantillonnage = 8 000 ; = 16 ; nombre de canaux = 1 ; = faux sample-size-bits is-big-endian 
+ Format Opus
  + audio/ x-cbr-opus-with -preamble ; taille du préambule = 0 ; débit = 256000 ; =4 frame-size-milliseconds
+ Format texte
  + texte/clair ; jeu de caractères = utf-8
Obligatoire : oui

 ** [requestAttributes](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-requestAttributes"></a>
Vous transmettez cette valeur comme en-tête `x-amz-lex-request-attributes` HTTP.  
Informations spécifiques à la demande transmises entre Amazon Lex et une application cliente. La valeur doit être une carte sérialisée JSON et codée en base64 avec des clés et des valeurs de chaîne. La taille totale des `sessionAttributes` en-têtes `requestAttributes` et est limitée à 12 Ko.  
L'espace de noms `x-amz-lex:` est réservé aux attributs spéciaux. Ne créez aucun attribut de demande avec le préfixe`x-amz-lex:`.  
Pour plus d'informations, consultez la section [Définition des attributs de demande](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs).

 ** [sessionAttributes](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-sessionAttributes"></a>
Vous transmettez cette valeur comme en-tête `x-amz-lex-session-attributes` HTTP.  
Informations spécifiques à l'application transmises entre Amazon Lex et une application cliente. La valeur doit être une carte sérialisée JSON et codée en base64 avec des clés et des valeurs de chaîne. La taille totale des `requestAttributes` en-têtes `sessionAttributes` et est limitée à 12 Ko.  
Pour plus d'informations, consultez la section [Définition des attributs de session](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs).

 ** [userId](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-userId"></a>
ID de l'utilisateur de l'application cliente. Amazon Lex l'utilise pour identifier la conversation d'un utilisateur avec votre bot. Au moment de l'exécution, chaque demande doit contenir le `userID` champ.  
Pour décider de l'ID utilisateur à utiliser pour votre application, tenez compte des facteurs suivants.  
+ Le `userID` champ ne doit contenir aucune information personnellement identifiable de l'utilisateur, par exemple son nom, son numéro d'identification personnel ou toute autre information personnelle de l'utilisateur final.
+ Si vous souhaitez qu'un utilisateur entame une conversation sur un appareil et la poursuive sur un autre, utilisez un identifiant spécifique à l'utilisateur.
+ Si vous souhaitez que le même utilisateur puisse avoir deux conversations indépendantes sur deux appareils différents, choisissez un identifiant spécifique à l'appareil.
+ Un utilisateur ne peut pas avoir deux conversations indépendantes avec deux versions différentes du même bot. Par exemple, un utilisateur ne peut pas avoir de conversation avec les versions PROD et BETA du même bot. Si vous pensez qu'un utilisateur devra avoir une conversation avec deux versions différentes, par exemple pendant le test, incluez l'alias du bot dans l'ID utilisateur pour séparer les deux conversations.
Contraintes de longueur : longueur minimale de 2. Longueur maximum de 100.  
Modèle : `[0-9a-zA-Z._:-]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_runtime_PostContent_RequestBody"></a>

La demande accepte les données binaires suivantes.

 ** [inputStream](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-inputStream"></a>
 Entrée utilisateur au format audio PCM ou Opus ou au format texte, comme décrit dans l'en-tête `Content-Type` HTTP.   
Vous pouvez diffuser des données audio vers Amazon Lex ou créer une mémoire tampon locale qui capture toutes les données audio avant de les envoyer. En général, vous obtiendrez de meilleures performances si vous diffusez des données audio plutôt que de les mettre en mémoire tampon localement.  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_runtime_PostContent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: contentType
x-amz-lex-intent-name: intentName
x-amz-lex-nlu-intent-confidence: nluIntentConfidence
x-amz-lex-alternative-intents: alternativeIntents
x-amz-lex-slots: slots
x-amz-lex-session-attributes: sessionAttributes
x-amz-lex-sentiment: sentimentResponse
x-amz-lex-message: message
x-amz-lex-encoded-message: encodedMessage
x-amz-lex-message-format: messageFormat
x-amz-lex-dialog-state: dialogState
x-amz-lex-slot-to-elicit: slotToElicit
x-amz-lex-input-transcript: inputTranscript
x-amz-lex-encoded-input-transcript: encodedInputTranscript
x-amz-lex-bot-version: botVersion
x-amz-lex-session-id: sessionId
x-amz-lex-active-contexts: activeContexts

audioStream
```

## Eléments de réponse
<a name="API_runtime_PostContent_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

La réponse renvoie les en-têtes HTTP suivants.

 ** [activeContexts](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-activeContexts"></a>
Liste des contextes actifs pour la session. Un contexte peut être défini lorsqu'une intention est satisfaite ou en appelant l'`PutSession`opération `PostContent``PostText`, ou.  
Vous pouvez utiliser un contexte pour contrôler les intentions qui peuvent donner suite à une intention ou pour modifier le fonctionnement de votre application.

 ** [alternativeIntents](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-alternativeIntents"></a>
Une à quatre intentions alternatives qui peuvent être applicables à l'intention de l'utilisateur.  
Chaque alternative inclut un score qui indique dans quelle mesure Amazon Lex est sûr que l'intention correspond à celle de l'utilisateur. Les intentions sont triées en fonction du score de confiance.

 ** [botVersion](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-botVersion"></a>
Version du bot qui a répondu à la conversation. Vous pouvez utiliser ces informations pour déterminer si une version d'un bot est plus performante qu'une autre.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[0-9]+|\$LATEST` 

 ** [contentType](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-contentType"></a>
Type de contenu tel que spécifié dans l'en-tête `Accept` HTTP de la demande.

 ** [dialogState](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-dialogState"></a>
Identifie l'état actuel de l'interaction de l'utilisateur. Amazon Lex renvoie l'une des valeurs suivantes sous la forme`dialogState`. Le client peut éventuellement utiliser ces informations pour personnaliser l'interface utilisateur.   
+  `ElicitIntent`- Amazon Lex souhaite connaître l'intention de l'utilisateur. Considérez les exemples suivants : 

   Par exemple, un utilisateur peut exprimer une intention (« Je veux commander une pizza »). Si Amazon Lex ne parvient pas à déduire l'intention de l'utilisateur à partir de cet énoncé, il renverra cet état de dialogue. 
+  `ConfirmIntent`- Amazon Lex attend une réponse « oui » ou « non ». 

  Par exemple, Amazon Lex souhaite obtenir la confirmation de l'utilisateur avant de réaliser une intention. Au lieu d'une simple réponse « oui » ou « non », un utilisateur peut répondre en fournissant des informations supplémentaires. Par exemple, « oui, mais fais-en une pizza à croûte épaisse » ou « Non, je veux commander un verre ». Amazon Lex peut traiter ces informations supplémentaires (dans ces exemples, mettre à jour l'emplacement du type de croûte ou modifier l'intention de OrderPizza à OrderDrink). 
+  `ElicitSlot`- Amazon Lex attend la valeur d'un emplacement pour l'objectif actuel. 

   Supposons, par exemple, qu'Amazon Lex envoie le message suivant dans sa réponse : « Quelle taille de pizza aimeriez-vous ? ». Un utilisateur peut répondre en indiquant la valeur de l'emplacement (par exemple, « moyen »). L'utilisateur peut également fournir des informations supplémentaires dans la réponse (par exemple, « pizza à croûte moyenne épaisse »). Amazon Lex peut traiter ces informations supplémentaires de manière appropriée. 
+  `Fulfilled`- Indique que la fonction Lambda a répondu avec succès à l'intention. 
+  `ReadyForFulfillment`- Indique que le client doit répondre à la demande. 
+  `Failed`- Indique que la conversation avec l'utilisateur a échoué. 

   Cela peut se produire pour diverses raisons, notamment parce que l'utilisateur ne fournit pas de réponse appropriée aux demandes du service (vous pouvez configurer le nombre de fois où Amazon Lex peut demander à un utilisateur des informations spécifiques) ou si la fonction Lambda ne répond pas à son objectif. 
Valeurs valides : `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedInputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedInputTranscript"></a>
Le texte utilisé pour traiter la demande.  
Si l'entrée correspond à un flux audio, le champ `encodedInputTranscript` contient le texte extraite du flux audio. Il s'agit du texte qui est réellement traité pour reconnaître les intentions et les valeurs d'option. Vous pouvez utiliser ces informations pour déterminer si Amazon Lex traite correctement le son que vous envoyez.  
Le `encodedInputTranscript` champ est codé en base 64. Vous devez décoder le champ avant de pouvoir utiliser la valeur.

 ** [encodedMessage](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedMessage"></a>
Le message à transmettre à l'utilisateur. Le message peut provenir de la configuration du bot ou d'une fonction Lambda.  
Si l'intention n'est pas configurée avec une fonction Lambda, ou si la fonction Lambda renvoie la valeur « `Delegate` the » `dialogAction.type` dans sa réponse, Amazon Lex décide de la marche à suivre et sélectionne un message approprié dans la configuration du bot en fonction du contexte d'interaction actuel. Par exemple, si Amazon Lex n'est pas en mesure de comprendre les informations saisies par les utilisateurs, il envoie un message de demande de clarification.  
Lorsque vous créez une intention, vous pouvez attribuer des messages à des groupes. Lorsque des messages sont affectés à des groupes, Amazon Lex renvoie un message de chaque groupe dans la réponse. Le champ de message est une chaîne JSON échappée contenant les messages. Pour plus d'informations sur la structure de la chaîne JSON renvoyée, consultez[Formats de message pris en charge](howitworks-manage-prompts.md#msg-prompts-formats).  
Si la fonction Lambda renvoie un message, Amazon Lex le transmet au client dans sa réponse.  
Le `encodedMessage` champ est codé en base 64. Vous devez décoder le champ avant de pouvoir utiliser la valeur.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1366.

 ** [inputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-inputTranscript"></a>
 *Cet en-tête est devenu obsolète.*   
Le texte utilisé pour traiter la demande.  
Vous ne pouvez utiliser ce champ que dans les paramètres régionaux de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR et it-IT. Dans tous les autres paramètres régionaux, le `inputTranscript` champ est nul. Vous devriez plutôt utiliser le `encodedInputTranscript` champ.  
Si l'entrée correspond à un flux audio, le champ `inputTranscript` contient le texte extraite du flux audio. Il s'agit du texte qui est réellement traité pour reconnaître les intentions et les valeurs d'option. Vous pouvez utiliser ces informations pour déterminer si Amazon Lex traite correctement le son que vous envoyez.

 ** [intentName](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-intentName"></a>
Intention actuelle de l'utilisateur dont Amazon Lex est au courant.

 ** [message](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-message"></a>
 *Cet en-tête est devenu obsolète.*   
Vous ne pouvez utiliser ce champ que dans les paramètres régionaux de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR et it-IT. Dans tous les autres paramètres régionaux, le `message` champ est nul. Vous devriez plutôt utiliser le `encodedMessage` champ.  
Le message à transmettre à l'utilisateur. Le message peut provenir de la configuration du bot ou d'une fonction Lambda.  
Si l'intention n'est pas configurée avec une fonction Lambda, ou si la fonction Lambda renvoie la valeur « `Delegate` the » `dialogAction.type` dans sa réponse, Amazon Lex décide de la marche à suivre et sélectionne un message approprié dans la configuration du bot en fonction du contexte d'interaction actuel. Par exemple, si Amazon Lex n'est pas en mesure de comprendre les informations saisies par les utilisateurs, il envoie un message de demande de clarification.  
Lorsque vous créez une intention, vous pouvez attribuer des messages à des groupes. Lorsque des messages sont affectés à des groupes, Amazon Lex renvoie un message de chaque groupe dans la réponse. Le champ de message est une chaîne JSON échappée contenant les messages. Pour plus d'informations sur la structure de la chaîne JSON renvoyée, consultez[Formats de message pris en charge](howitworks-manage-prompts.md#msg-prompts-formats).  
Si la fonction Lambda renvoie un message, Amazon Lex le transmet au client dans sa réponse.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1024.

 ** [messageFormat](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-messageFormat"></a>
Format du message de réponse. L’une des valeurs suivantes :  
+  `PlainText`- Le message contient du texte UTF-8 brut.
+  `CustomPayload`- Le message est un format personnalisé pour le client.
+  `SSML`- Le message contient du texte formaté pour la sortie vocale.
+  `Composite`- Le message contient un objet JSON échappé contenant un ou plusieurs messages provenant des groupes auxquels les messages ont été affectés lors de la création de l'intention.
Valeurs valides : `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-nluIntentConfidence"></a>
Fournit un score qui indique dans quelle mesure Amazon Lex est sûr que l'intention renvoyée correspond à l'intention de l'utilisateur. Le score est compris entre 0,0 et 1,0.  
Le score est un score relatif et non un score absolu. Le score peut changer en fonction des améliorations apportées à Amazon Lex. 

 ** [sentimentResponse](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sentimentResponse"></a>
Le sentiment exprimé dans un énoncé.  
Lorsque le bot est configuré pour envoyer des énoncés à Amazon Comprehend à des fins d'analyse des sentiments, ce champ contient le résultat de l'analyse.

 ** [sessionAttributes](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionAttributes"></a>
 Carte des key/value paires représentant les informations contextuelles spécifiques à la session. 

 ** [sessionId](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionId"></a>
Identifiant unique de la session.

 ** [slots](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slots"></a>
Carte de zéro ou plusieurs créneaux d'intention (paires nom/valeur) détectés par Amazon Lex à partir des données saisies par l'utilisateur au cours de la conversation. Le champ est codé en base 64.  
Amazon Lex crée une liste de résolutions contenant les valeurs probables pour un emplacement. La valeur renvoyée est déterminée par la valeur `valueSelectionStrategy` sélectionnée lors de la création ou de la mise à jour du type d'emplacement. S'il `valueSelectionStrategy` est défini sur`ORIGINAL_VALUE`, la valeur fournie par l'utilisateur est renvoyée, si la valeur utilisateur est similaire aux valeurs des emplacements. Si la valeur `valueSelectionStrategy` est définie `TOP_RESOLUTION` sur Amazon Lex, elle renvoie la première valeur de la liste de résolutions ou, en l'absence de liste de résolutions, la valeur nulle. Si vous ne spécifiez pas de`valueSelectionStrategy`, la valeur par défaut est`ORIGINAL_VALUE`.

 ** [slotToElicit](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slotToElicit"></a>
 Si la `dialogState` valeur est`ElicitSlot`, renvoie le nom de l'emplacement pour lequel Amazon Lex demande une valeur. 

La réponse renvoie ce qui suit en tant que corps HTTP.

 ** [audioStream](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-audioStream"></a>
L'invite (ou déclaration) à transmettre à l'utilisateur. Ceci est basé sur la configuration et le contexte du bot. Par exemple, si Amazon Lex n'a pas compris l'intention de l'utilisateur, il envoie le `clarificationPrompt` fichier configuré pour le bot. Si l'intention nécessite une confirmation avant d'effectuer l'action d'exécution, elle envoie le`confirmationPrompt`. Autre exemple : supposons que la fonction Lambda ait répondu avec succès à l'intention et ait envoyé un message à transmettre à l'utilisateur. Amazon Lex envoie ensuite ce message dans la réponse. 

## Erreurs
<a name="API_runtime_PostContent_Errors"></a>

 ** BadGatewayException **   
Soit le bot Amazon Lex est toujours en cours de création, soit l'un des services dépendants (Amazon Polly, AWS Lambda) a échoué en raison d'une erreur de service interne.  
Code d’état HTTP : 502

 ** BadRequestException **   
 La validation de la demande a échoué, il n'y a aucun message utilisable dans le contexte, ou la création du bot a échoué, est toujours en cours ou contient des modifications non intégrées.   
Code d’état HTTP : 400

 ** ConflictException **   
 Deux clients utilisent le même compte AWS, le même bot Amazon Lex et le même ID utilisateur.   
Code d’état HTTP : 409

 ** DependencyFailedException **   
 L'une des dépendances, telle qu'AWS Lambda ou Amazon Polly, a généré une exception. Par exemple,   
+ Si Amazon Lex ne dispose pas des autorisations suffisantes pour appeler une fonction Lambda.
+ Si l'exécution d'une fonction Lambda prend plus de 30 secondes.
+ Si une fonction Lambda d'exécution renvoie une action de `Delegate` dialogue sans supprimer aucune valeur d'intervalle.
Code d'état HTTP : 424

 ** InternalFailureException **   
Erreur de service interne. Réessayez l'appel.  
Code d’état HTTP : 500

 ** LimitExceededException **   
Dépassement d'une limite.  
Code d’état HTTP : 429

 ** LoopDetectedException **   
Cette exception n'est pas utilisée.  
Code d'état HTTP : 508

 ** NotAcceptableException **   
L'en-tête d'acceptation de la demande n'a pas de valeur valide.  
Code d'état HTTP : 406

 ** NotFoundException **   
La ressource (telle que le bot Amazon Lex ou un alias) à laquelle il est fait référence est introuvable.  
Code d’état HTTP :404

 ** RequestTimeoutException **   
Le discours d'entrée est trop long.  
Code d’état HTTP : 408

 ** UnsupportedMediaTypeException **   
La valeur de l'en-tête Content-Type (`PostContent`API) n'est pas valide.   
Code d’état HTTP : 415

## Exemples
<a name="API_runtime_PostContent_Examples"></a>

### Exemple 1
<a name="API_runtime_PostContent_Example_1"></a>

 Dans cette demande, l'URI identifie un bot (Traffic), une version du bot (\$1LATEST) et un nom d'utilisateur final (someuser). L'`Content-Type`en-tête identifie le format de l'audio dans le corps. Amazon Lex prend également en charge d'autres formats. Pour convertir l'audio d'un format à un autre, vous pouvez utiliser le logiciel open source SoX si nécessaire. Vous spécifiez le format dans lequel vous souhaitez obtenir la réponse en ajoutant l'en-tête `Accept` HTTP. 

 Dans la réponse, l'`x-amz-lex-message`en-tête indique la réponse renvoyée par Amazon Lex. Le client peut ensuite envoyer cette réponse à l'utilisateur. Le même message est envoyé sous audio/MPEG forme de codage fragmenté (comme demandé). 

#### Exemple de demande
<a name="API_runtime_PostContent_Example_1_Request"></a>

```
"POST /bot/Traffic/alias/$LATEST/user/someuser/content HTTP/1.1[\r][\n]"
"x-amz-lex-session-attributes: eyJ1c2VyTmFtZSI6IkJvYiJ9[\r][\n]"
"Content-Type: audio/x-l16; channel-count=1; sample-rate=16000f[\r][\n]"
"Accept: audio/mpeg[\r][\n]"
"Host: runtime.lex.us-east-1.amazonaws.com[\r][\n]"
"Authorization: AWS4-HMAC-SHA256 Credential=BLANKED_OUT/20161230/us-east-1/lex/aws4_request, 
SignedHeaders=accept;content-type;host;x-amz-content-sha256;x-amz-date;x-amz-lex-session-attributes, Signature=78ca5b54ea3f64a17ff7522de02cd90a9acd2365b45a9ce9b96ea105bb1c7ec2[\r][\n]"
"X-Amz-Date: 20161230T181426Z[\r][\n]"
"X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855[\r][\n]"
"Transfer-Encoding: chunked[\r][\n]"
"Connection: Keep-Alive[\r][\n]"
"User-Agent: Apache-HttpClient/4.5.x (Java/1.8.0_112)[\r][\n]"
"Accept-Encoding: gzip,deflate[\r][\n]"
"[\r][\n]"
"1000[\r][\n]"
"[0x7][0x0][0x7][0x0][\n]"
"[0x0][0x7][0x0][0xfc][0xff][\n]"
"[0x0][\n]"
…
```

#### Exemple de réponse
<a name="API_runtime_PostContent_Example_1_Response"></a>

```
"HTTP/1.1 200 OK[\r][\n]"
"x-amzn-RequestId: cc8b34af-cebb-11e6-a35c-55f3a992f28d[\r][\n]"
"x-amz-lex-message: Sorry, can you repeat that?[\r][\n]"
"x-amz-lex-dialog-state: ElicitIntent[\r][\n]"
"x-amz-lex-session-attributes: eyJ1c2VyTmFtZSI6IkJvYiJ9[\r][\n]"
"Content-Type: audio/mpeg[\r][\n]"
"Transfer-Encoding: chunked[\r][\n]"
"Date: Fri, 30 Dec 2016 18:14:28 GMT[\r][\n]"
"[\r][\n]"               
"2000[\r][\n]"
"ID3[0x4][0x0][0x0][0x0][0x0][0x0]#TSSE[0x0][0x0][0x0][0xf][0x0][0x0][0x3]Lavf57.41.100[0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0x0][0xff][0xf3]`[0xc4][0x0][0x1b]{[0x8d][0xe8][0x1]C[0x18][0x1][0x0]J[0xe0]`b[0xdd][0xd1][0xb][0xfd][0x11][0xdf][0xfe]";[0xbb][0xbb][0x9f][0xee][0xee][0xee][0xee]|DDD/[0xff][0xff][0xff][0xff]www?D[0xf7]w^?[0xff][0xfa]h[0x88][0x85][0xfe][0x88][0x88][0x88][[0xa2]'[0xff][0xfa]"{[0x9f][0xe8][0x88]]D[0xeb][0xbb][0xbb][0xa2]!u[0xfd][0xdd][0xdf][0x88][0x94][0x0]F[0xef][0xa1]8[0x0][0x82]w[0x88]N[0x0][0x0][0x9b][0xbb][0xe8][0xe
…
```

## consultez aussi
<a name="API_runtime_PostContent_SeeAlso"></a>

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/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostContent) 

# PostText
<a name="API_runtime_PostText"></a>

Envoie les données de l'utilisateur à Amazon Lex. Les applications clientes peuvent utiliser cette API pour envoyer des demandes à Amazon Lex lors de l'exécution. Amazon Lex interprète ensuite les entrées de l'utilisateur à l'aide du modèle d'apprentissage automatique qu'il a conçu pour le bot. 

 En réponse, Amazon Lex renvoie le suivant `message` pour indiquer à l'utilisateur un affichage facultatif`responseCard`. Examinez les exemples de messages suivants : 
+  Lorsqu'un utilisateur saisit « Je voudrais une pizza », Amazon Lex peut renvoyer une réponse contenant un message demandant des informations sur le créneau (par exemple, PizzaSize) : « Quelle taille de pizza souhaitez-vous ? » 
+  Une fois que l'utilisateur a fourni toutes les informations relatives à la commande de pizza, Amazon Lex peut renvoyer une réponse contenant un message pour obtenir la confirmation de l'utilisateur « Poursuivre la commande de pizza ? ». 
+  Une fois que l'utilisateur a répondu « oui » à une invite de confirmation, Amazon Lex peut renvoyer une déclaration de conclusion : « Merci, votre pizza au fromage a été commandée ». 

 Tous les messages Amazon Lex ne nécessitent pas de réponse de l'utilisateur. Par exemple, une déclaration de conclusion ne nécessite pas de réponse. Certains messages nécessitent uniquement une réponse « oui » ou « non » de l'utilisateur. En outre`message`, Amazon Lex fournit un contexte supplémentaire sur le message contenu dans la réponse, que vous pouvez utiliser pour améliorer le comportement des clients, par exemple pour afficher l'interface utilisateur client appropriée. Il s'agit des `slots` champs `slotToElicit` `dialogState``intentName`,, et de la réponse. Considérez les exemples suivants : 
+ Si le message vise à obtenir des données d'emplacement, Amazon Lex renvoie les informations contextuelles suivantes :
  +  `dialogState`réglé sur ElicitSlot 
  +  `intentName`défini sur le nom de l'intention dans le contexte actuel 
  +  `slotToElicit`défini sur le nom du slot pour lequel `message` il demande des informations 
  +  `slots`défini sur une carte de slots, configurée en fonction de l'intention, avec des valeurs actuellement connues 
+  Si le message est une invite de confirmation, le `dialogState` est défini sur ConfirmIntent et `SlotToElicit` est défini sur null. 
+ Si le message est une demande de clarification (configurée en fonction de l'intention) qui indique que l'intention de l'utilisateur n'est pas comprise, le paramètre `dialogState` est défini sur ElicitIntent et `slotToElicit` est défini sur null. 

 En outre, Amazon Lex renvoie également des informations spécifiques à votre application`sessionAttributes`. Pour plus d'informations, consultez [la section Gestion du contexte de conversation](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html). 

## Syntaxe de la demande
<a name="API_runtime_PostText_RequestSyntax"></a>

```
POST /bot/botName/alias/botAlias/user/userId/text HTTP/1.1
Content-type: application/json

{
   "activeContexts": [ 
      { 
         "name": "string",
         "parameters": { 
            "string" : "string" 
         },
         "timeToLive": { 
            "timeToLiveInSeconds": number,
            "turnsToLive": number
         }
      }
   ],
   "inputText": "string",
   "requestAttributes": { 
      "string" : "string" 
   },
   "sessionAttributes": { 
      "string" : "string" 
   }
}
```

## Paramètres de demande URI
<a name="API_runtime_PostText_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [botAlias](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botAlias"></a>
Alias du bot Amazon Lex.  
Obligatoire : oui

 ** [botName](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botName"></a>
Nom du bot Amazon Lex.  
Obligatoire : oui

 ** [userId](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-userId"></a>
ID de l'utilisateur de l'application cliente. Amazon Lex l'utilise pour identifier la conversation d'un utilisateur avec votre bot. Au moment de l'exécution, chaque demande doit contenir le `userID` champ.  
Pour décider de l'ID utilisateur à utiliser pour votre application, tenez compte des facteurs suivants.  
+ Le `userID` champ ne doit contenir aucune information personnellement identifiable de l'utilisateur, par exemple son nom, son numéro d'identification personnel ou toute autre information personnelle de l'utilisateur final.
+ Si vous souhaitez qu'un utilisateur entame une conversation sur un appareil et la poursuive sur un autre, utilisez un identifiant spécifique à l'utilisateur.
+ Si vous souhaitez que le même utilisateur puisse avoir deux conversations indépendantes sur deux appareils différents, choisissez un identifiant spécifique à l'appareil.
+ Un utilisateur ne peut pas avoir deux conversations indépendantes avec deux versions différentes du même bot. Par exemple, un utilisateur ne peut pas avoir de conversation avec les versions PROD et BETA du même bot. Si vous pensez qu'un utilisateur devra avoir une conversation avec deux versions différentes, par exemple pendant le test, incluez l'alias du bot dans l'ID utilisateur pour séparer les deux conversations.
Contraintes de longueur : longueur minimale de 2. Longueur maximum de 100.  
Modèle : `[0-9a-zA-Z._:-]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_runtime_PostText_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [activeContexts](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-activeContexts"></a>
Liste des contextes actifs pour la demande. Un contexte peut être activé lorsqu'une intention précédente est satisfaite, ou en incluant le contexte dans la demande,  
Si vous ne spécifiez pas de liste de contextes, Amazon Lex utilisera la liste actuelle des contextes pour la session. Si vous spécifiez une liste vide, tous les contextes de la session sont effacés.  
Type : tableau d’objets [ActiveContext](API_runtime_ActiveContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 20 éléments.  
Obligatoire : non

 ** [inputText](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-inputText"></a>
Le texte saisi par l'utilisateur (Amazon Lex interprète ce texte).  
Lorsque vous utilisez l'AWS CLI, vous ne pouvez pas transmettre d'URL dans le `--input-text` paramètre. Passez plutôt l'URL en utilisant le `--cli-input-json` paramètre.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 1024.  
Obligatoire : oui

 ** [requestAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-requestAttributes"></a>
Informations spécifiques à la demande transmises entre Amazon Lex et une application cliente.  
L'espace de noms `x-amz-lex:` est réservé aux attributs spéciaux. Ne créez aucun attribut de demande avec le préfixe`x-amz-lex:`.  
Pour plus d'informations, consultez la section [Définition des attributs de demande](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs).  
Type : mappage chaîne/chaîne  
Obligatoire : non

 ** [sessionAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-sessionAttributes"></a>
Informations spécifiques à l'application transmises entre Amazon Lex et une application cliente.  
Pour plus d'informations, consultez la section [Définition des attributs de session](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs).  
Type : mappage chaîne/chaîne  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_runtime_PostText_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "activeContexts": [ 
      { 
         "name": "string",
         "parameters": { 
            "string" : "string" 
         },
         "timeToLive": { 
            "timeToLiveInSeconds": number,
            "turnsToLive": number
         }
      }
   ],
   "alternativeIntents": [ 
      { 
         "intentName": "string",
         "nluIntentConfidence": { 
            "score": number
         },
         "slots": { 
            "string" : "string" 
         }
      }
   ],
   "botVersion": "string",
   "dialogState": "string",
   "intentName": "string",
   "message": "string",
   "messageFormat": "string",
   "nluIntentConfidence": { 
      "score": number
   },
   "responseCard": { 
      "contentType": "string",
      "genericAttachments": [ 
         { 
            "attachmentLinkUrl": "string",
            "buttons": [ 
               { 
                  "text": "string",
                  "value": "string"
               }
            ],
            "imageUrl": "string",
            "subTitle": "string",
            "title": "string"
         }
      ],
      "version": "string"
   },
   "sentimentResponse": { 
      "sentimentLabel": "string",
      "sentimentScore": "string"
   },
   "sessionAttributes": { 
      "string" : "string" 
   },
   "sessionId": "string",
   "slots": { 
      "string" : "string" 
   },
   "slotToElicit": "string"
}
```

## Eléments de réponse
<a name="API_runtime_PostText_ResponseElements"></a>

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.

 ** [activeContexts](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-activeContexts"></a>
Liste des contextes actifs pour la session. Un contexte peut être défini lorsqu'une intention est satisfaite ou en appelant l'`PutSession`opération `PostContent``PostText`, ou.  
Vous pouvez utiliser un contexte pour contrôler les intentions qui peuvent donner suite à une intention ou pour modifier le fonctionnement de votre application.  
Type : tableau d’objets [ActiveContext](API_runtime_ActiveContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 20 éléments.

 ** [alternativeIntents](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-alternativeIntents"></a>
Une à quatre intentions alternatives qui peuvent être applicables à l'intention de l'utilisateur.  
Chaque alternative inclut un score qui indique dans quelle mesure Amazon Lex est sûr que l'intention correspond à celle de l'utilisateur. Les intentions sont triées en fonction du score de confiance.  
Type : tableau d’objets [PredictedIntent](API_runtime_PredictedIntent.md)  
Membres du tableau : nombre maximum de 4 éléments.

 ** [botVersion](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-botVersion"></a>
Version du bot qui a répondu à la conversation. Vous pouvez utiliser ces informations pour déterminer si une version d'un bot est plus performante qu'une autre.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `[0-9]+|\$LATEST` 

 ** [dialogState](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-dialogState"></a>
 Identifie l'état actuel de l'interaction de l'utilisateur. Amazon Lex renvoie l'une des valeurs suivantes sous la forme`dialogState`. Le client peut éventuellement utiliser ces informations pour personnaliser l'interface utilisateur.   
+  `ElicitIntent`- Amazon Lex souhaite obtenir l'intention des utilisateurs. 

  Par exemple, un utilisateur peut exprimer une intention (« Je veux commander une pizza »). Si Amazon Lex ne parvient pas à déduire l'intention de l'utilisateur à partir de cet énoncé, il renverra ce DialogState.
+  `ConfirmIntent`- Amazon Lex attend une réponse « oui » ou « non ». 

   Par exemple, Amazon Lex souhaite obtenir la confirmation de l'utilisateur avant de réaliser une intention. 

  Au lieu d'un simple « oui » ou « non », un utilisateur peut répondre en fournissant des informations supplémentaires. Par exemple, « oui, mais fais-en une pizza à croûte épaisse » ou « Non, je veux commander un verre ». Amazon Lex peut traiter ces informations supplémentaires (dans ces exemples, mettre à jour la valeur de l'emplacement du type de croûte ou modifier l'intention de OrderPizza à OrderDrink).
+  `ElicitSlot`- Amazon Lex attend une valeur de créneau correspondant à l'intention actuelle. 

  Supposons, par exemple, qu'Amazon Lex envoie le message suivant dans sa réponse : « Quelle taille de pizza aimeriez-vous ? ». Un utilisateur peut répondre en indiquant la valeur de l'emplacement (par exemple, « moyen »). L'utilisateur peut également fournir des informations supplémentaires dans la réponse (par exemple, « pizza à croûte moyenne épaisse »). Amazon Lex peut traiter ces informations supplémentaires de manière appropriée. 
+  `Fulfilled`- Indique que la fonction Lambda configurée pour l'intention a répondu avec succès à l'intention. 
+  `ReadyForFulfillment`- Indique que le client doit réaliser son intention. 
+  `Failed`- Indique que la conversation avec l'utilisateur a échoué. 

   Cela peut se produire pour diverses raisons, notamment le fait que l'utilisateur n'a pas répondu de manière appropriée aux demandes du service (vous pouvez configurer le nombre de fois qu'Amazon Lex peut demander à un utilisateur des informations spécifiques) ou que la fonction Lambda n'a pas répondu à son intention. 
Type : Chaîne  
Valeurs valides : `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [intentName](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-intentName"></a>
L'intention actuelle de l'utilisateur dont Amazon Lex a connaissance.  
Type : Chaîne

 ** [message](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-message"></a>
Le message à transmettre à l'utilisateur. Le message peut provenir de la configuration du bot ou d'une fonction Lambda.  
Si l'intention n'est pas configurée avec une fonction Lambda, ou si la fonction Lambda est renvoyée `Delegate` comme réponse, Amazon Lex décide de la marche à suivre et sélectionne un message approprié dans la configuration du bot en fonction du contexte d'interaction actuel. `dialogAction.type` Par exemple, si Amazon Lex n'est pas en mesure de comprendre les informations saisies par les utilisateurs, il envoie un message de demande de clarification.  
Lorsque vous créez une intention, vous pouvez attribuer des messages à des groupes. Lorsque des messages sont affectés à des groupes, Amazon Lex renvoie un message de chaque groupe dans la réponse. Le champ de message est une chaîne JSON échappée contenant les messages. Pour plus d'informations sur la structure de la chaîne JSON renvoyée, consultez[Formats de message pris en charge](howitworks-manage-prompts.md#msg-prompts-formats).  
Si la fonction Lambda renvoie un message, Amazon Lex le transmet au client dans sa réponse.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 1024.

 ** [messageFormat](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-messageFormat"></a>
Format du message de réponse. L’une des valeurs suivantes :  
+  `PlainText`- Le message contient du texte UTF-8 brut.
+  `CustomPayload`- Le message est un format personnalisé défini par la fonction Lambda.
+  `SSML`- Le message contient du texte formaté pour la sortie vocale.
+  `Composite`- Le message contient un objet JSON échappé contenant un ou plusieurs messages provenant des groupes auxquels les messages ont été affectés lors de la création de l'intention.
Type : Chaîne  
Valeurs valides : `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-nluIntentConfidence"></a>
Fournit un score qui indique dans quelle mesure Amazon Lex est sûr que l'intention renvoyée correspond à l'intention de l'utilisateur. Le score est compris entre 0,0 et 1,0. Pour plus d'informations, consultez la section [Scores de confiance](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html).  
Le score est un score relatif et non un score absolu. Le score peut changer en fonction des améliorations apportées à Amazon Lex.  
Type : objet [IntentConfidence](API_runtime_IntentConfidence.md)

 ** [responseCard](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-responseCard"></a>
Représente les options dont dispose l'utilisateur pour répondre à l'invite en cours. La carte de réponse peut provenir de la configuration du bot (dans la console Amazon Lex, cliquez sur le bouton de configuration à côté d'un emplacement) ou d'un crochet de code (fonction Lambda).   
Type : objet [ResponseCard](API_runtime_ResponseCard.md)

 ** [sentimentResponse](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sentimentResponse"></a>
Le sentiment exprimé dans et dans l'énoncé.  
Lorsque le bot est configuré pour envoyer des énoncés à Amazon Comprehend à des fins d'analyse des sentiments, ce champ contient le résultat de l'analyse.  
Type : objet [SentimentResponse](API_runtime_SentimentResponse.md)

 ** [sessionAttributes](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sessionAttributes"></a>
Une carte de paires clé-valeur représentant les informations contextuelles spécifiques à la session.  
Type : mappage chaîne/chaîne

 ** [sessionId](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sessionId"></a>
Identifiant unique de la session.  
Type : Chaîne

 ** [slots](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slots"></a>
 Les créneaux d'intention détectés par Amazon Lex à partir des données saisies par l'utilisateur dans la conversation.   
Amazon Lex crée une liste de résolutions contenant les valeurs probables pour un emplacement. La valeur renvoyée est déterminée par la valeur `valueSelectionStrategy` sélectionnée lors de la création ou de la mise à jour du type d'emplacement. S'il `valueSelectionStrategy` est défini sur`ORIGINAL_VALUE`, la valeur fournie par l'utilisateur est renvoyée, si la valeur utilisateur est similaire aux valeurs des emplacements. Si la valeur `valueSelectionStrategy` est définie `TOP_RESOLUTION` sur Amazon Lex, elle renvoie la première valeur de la liste de résolutions ou, en l'absence de liste de résolutions, la valeur nulle. Si vous ne spécifiez pas de`valueSelectionStrategy`, la valeur par défaut est`ORIGINAL_VALUE`.  
Type : mappage chaîne/chaîne

 ** [slotToElicit](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slotToElicit"></a>
Si la `dialogState` valeur est`ElicitSlot`, renvoie le nom de l'emplacement pour lequel Amazon Lex demande une valeur.   
Type : Chaîne

## Erreurs
<a name="API_runtime_PostText_Errors"></a>

 ** BadGatewayException **   
Soit le bot Amazon Lex est toujours en cours de création, soit l'un des services dépendants (Amazon Polly, AWS Lambda) a échoué en raison d'une erreur de service interne.  
Code d’état HTTP : 502

 ** BadRequestException **   
 La validation de la demande a échoué, il n'y a aucun message utilisable dans le contexte, ou la création du bot a échoué, est toujours en cours ou contient des modifications non intégrées.   
Code d’état HTTP : 400

 ** ConflictException **   
 Deux clients utilisent le même compte AWS, le même bot Amazon Lex et le même ID utilisateur.   
Code d’état HTTP : 409

 ** DependencyFailedException **   
 L'une des dépendances, telle qu'AWS Lambda ou Amazon Polly, a généré une exception. Par exemple,   
+ Si Amazon Lex ne dispose pas des autorisations suffisantes pour appeler une fonction Lambda.
+ Si l'exécution d'une fonction Lambda prend plus de 30 secondes.
+ Si une fonction Lambda d'exécution renvoie une action de `Delegate` dialogue sans supprimer aucune valeur d'intervalle.
Code d'état HTTP : 424

 ** InternalFailureException **   
Erreur de service interne. Réessayez l'appel.  
Code d’état HTTP : 500

 ** LimitExceededException **   
Dépassement d'une limite.  
Code d’état HTTP : 429

 ** LoopDetectedException **   
Cette exception n'est pas utilisée.  
Code d'état HTTP : 508

 ** NotFoundException **   
La ressource (telle que le bot Amazon Lex ou un alias) à laquelle il est fait référence est introuvable.  
Code d’état HTTP :404

## Voir aussi
<a name="API_runtime_PostText_SeeAlso"></a>

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/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostText) 

# PutSession
<a name="API_runtime_PutSession"></a>

Crée une nouvelle session ou modifie une session existante avec un robot Amazon Lex. Utilisez cette opération pour permettre à votre application de définir l'état du bot.

Pour plus d'informations, consultez [Gestion des sessions](https://docs.aws.amazon.com/lex/latest/dg/how-session-api.html).

## Syntaxe de la demande
<a name="API_runtime_PutSession_RequestSyntax"></a>

```
POST /bot/botName/alias/botAlias/user/userId/session HTTP/1.1
Accept: accept
Content-type: application/json

{
   "activeContexts": [ 
      { 
         "name": "string",
         "parameters": { 
            "string" : "string" 
         },
         "timeToLive": { 
            "timeToLiveInSeconds": number,
            "turnsToLive": number
         }
      }
   ],
   "dialogAction": { 
      "fulfillmentState": "string",
      "intentName": "string",
      "message": "string",
      "messageFormat": "string",
      "slots": { 
         "string" : "string" 
      },
      "slotToElicit": "string",
      "type": "string"
   },
   "recentIntentSummaryView": [ 
      { 
         "checkpointLabel": "string",
         "confirmationStatus": "string",
         "dialogActionType": "string",
         "fulfillmentState": "string",
         "intentName": "string",
         "slots": { 
            "string" : "string" 
         },
         "slotToElicit": "string"
      }
   ],
   "sessionAttributes": { 
      "string" : "string" 
   }
}
```

## Paramètres de demande URI
<a name="API_runtime_PutSession_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [accept](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-accept"></a>
Le message renvoyé par Amazon Lex dans la réponse peut être textuel ou vocal en fonction de la valeur de ce champ.  
+ Si la valeur est égale à cette valeur`text/plain; charset=utf-8`, Amazon Lex renvoie du texte dans la réponse.
+ Si la valeur commence par`audio/`, Amazon Lex renvoie un message vocal dans la réponse. Amazon Lex utilise Amazon Polly pour générer le discours dans la configuration que vous spécifiez. Par exemple, si vous spécifiez `audio/mpeg` comme valeur, Amazon Lex renvoie la parole au format MPEG.
+ Si la valeur est`audio/pcm`, le discours est renvoyé `audio/pcm` au format Little Endian 16 bits.
+ Les valeurs acceptées sont les suivantes :
  +  `audio/mpeg` 
  +  `audio/ogg` 
  +  `audio/pcm` 
  +  `audio/*`(mpeg par défaut)
  +  `text/plain; charset=utf-8` 

 ** [botAlias](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-botAlias"></a>
Alias utilisé pour le bot qui contient les données de session.  
Obligatoire : oui

 ** [botName](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-botName"></a>
Le nom du bot qui contient les données de session.  
Obligatoire : oui

 ** [userId](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-userId"></a>
ID de l'utilisateur de l'application cliente. Amazon Lex l'utilise pour identifier la conversation d'un utilisateur avec votre bot.   
Contraintes de longueur : longueur minimale de 2. Longueur maximum de 100.  
Modèle : `[0-9a-zA-Z._:-]+`   
Obligatoire : oui

## Corps de la demande
<a name="API_runtime_PutSession_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [activeContexts](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-activeContexts"></a>
Liste des contextes actifs pour la demande. Un contexte peut être activé lorsqu'une intention précédente est satisfaite, ou en incluant le contexte dans la demande,  
Si vous ne spécifiez pas de liste de contextes, Amazon Lex utilisera la liste actuelle des contextes pour la session. Si vous spécifiez une liste vide, tous les contextes de la session sont effacés.  
Type : tableau d’objets [ActiveContext](API_runtime_ActiveContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 20 éléments.  
Obligatoire : non

 ** [dialogAction](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-dialogAction"></a>
Définit l'action suivante que le bot doit effectuer pour mener à bien la conversation.  
Type : objet [DialogAction](API_runtime_DialogAction.md)  
Obligatoire : non

 ** [recentIntentSummaryView](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-recentIntentSummaryView"></a>
Un résumé des récentes intentions concernant le bot. Vous pouvez utiliser la vue récapitulative des intentions pour définir une étiquette de point de contrôle sur une intention et modifier les attributs des intentions. Vous pouvez également l'utiliser pour supprimer ou ajouter des objets de synthèse des intentions à la liste.  
L'intention que vous modifiez ou ajoutez à la liste doit être logique pour le bot. Par exemple, le nom de l'intention doit être valide pour le bot. Vous devez fournir des valeurs valides pour :  
+  `intentName` 
+ noms de machines à sous
+  `slotToElict` 
Si vous envoyez le `recentIntentSummaryView` paramètre dans une `PutSession` demande, le contenu de la nouvelle vue récapitulative remplace l'ancienne vue récapitulative. Par exemple, si une `GetSession` demande renvoie trois intentions dans la vue récapitulative et que vous appelez `PutSession` avec une intention dans la vue récapitulative, l'appel suivant ne `GetSession` renverra qu'une seule intention.  
Type : tableau d’objets [IntentSummary](API_runtime_IntentSummary.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 3 articles.  
Obligatoire : non

 ** [sessionAttributes](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-sessionAttributes"></a>
Carte des key/value paires représentant les informations contextuelles spécifiques à la session. Il contient les informations d'application transmises entre Amazon Lex et une application cliente.  
Type : mappage chaîne/chaîne  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_runtime_PutSession_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: contentType
x-amz-lex-intent-name: intentName
x-amz-lex-slots: slots
x-amz-lex-session-attributes: sessionAttributes
x-amz-lex-message: message
x-amz-lex-encoded-message: encodedMessage
x-amz-lex-message-format: messageFormat
x-amz-lex-dialog-state: dialogState
x-amz-lex-slot-to-elicit: slotToElicit
x-amz-lex-session-id: sessionId
x-amz-lex-active-contexts: activeContexts

audioStream
```

## Eléments de réponse
<a name="API_runtime_PutSession_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

La réponse renvoie les en-têtes HTTP suivants.

 ** [activeContexts](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-activeContexts"></a>
Liste des contextes actifs pour la session.

 ** [contentType](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-contentType"></a>
Type de contenu tel que spécifié dans l'en-tête `Accept` HTTP de la demande.

 ** [dialogState](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-dialogState"></a>
  
+  `ConfirmIntent`- Amazon Lex attend une réponse « oui » ou « non » pour confirmer l'intention avant de la réaliser.
+  `ElicitIntent`- Amazon Lex souhaite connaître l'intention de l'utilisateur.
+  `ElicitSlot`- Amazon Lex attend la valeur d'un emplacement pour l'objectif actuel.
+  `Failed`- Indique que la conversation avec l'utilisateur a échoué. Cela peut se produire pour diverses raisons, notamment si l'utilisateur ne fournit pas de réponse appropriée aux demandes du service ou si la fonction Lambda ne répond pas à l'intention.
+  `Fulfilled`- Indique que la fonction Lambda a répondu avec succès à l'intention.
+  `ReadyForFulfillment`- Indique que le client doit réaliser son intention.
Valeurs valides : `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedMessage](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-encodedMessage"></a>
Le message suivant qui doit être présenté à l'utilisateur.  
Le `encodedMessage` champ est codé en base 64. Vous devez décoder le champ avant de pouvoir utiliser la valeur.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1366.

 ** [intentName](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-intentName"></a>
Le nom de l'intention actuelle.

 ** [message](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-message"></a>
 *Cet en-tête est devenu obsolète.*   
Le message suivant qui doit être présenté à l'utilisateur.  
Vous ne pouvez utiliser ce champ que dans les paramètres régionaux de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR et it-IT. Dans tous les autres paramètres régionaux, le `message` champ est nul. Vous devriez plutôt utiliser le `encodedMessage` champ.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 1024.

 ** [messageFormat](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-messageFormat"></a>
Format du message de réponse. L’une des valeurs suivantes :  
+  `PlainText`- Le message contient du texte UTF-8 brut.
+  `CustomPayload`- Le message est un format personnalisé pour le client.
+  `SSML`- Le message contient du texte formaté pour la sortie vocale.
+  `Composite`- Le message contient un objet JSON échappé contenant un ou plusieurs messages provenant des groupes auxquels les messages ont été affectés lors de la création de l'intention.
Valeurs valides : `PlainText | CustomPayload | SSML | Composite` 

 ** [sessionAttributes](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionAttributes"></a>
Carte des key/value paires représentant les informations contextuelles spécifiques à la session.

 ** [sessionId](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionId"></a>
Identifiant unique de la session.

 ** [slots](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slots"></a>
Carte de zéro ou plusieurs créneaux d'intention détectés par Amazon Lex à partir des informations saisies par l'utilisateur au cours de la conversation.  
Amazon Lex crée une liste de résolutions contenant les valeurs probables pour un emplacement. La valeur renvoyée est déterminée par la valeur `valueSelectionStrategy` sélectionnée lors de la création ou de la mise à jour du type d'emplacement. S'il `valueSelectionStrategy` est défini sur`ORIGINAL_VALUE`, la valeur fournie par l'utilisateur est renvoyée, si la valeur utilisateur est similaire aux valeurs des emplacements. Si la valeur `valueSelectionStrategy` est définie `TOP_RESOLUTION` sur Amazon Lex, elle renvoie la première valeur de la liste de résolutions ou, en l'absence de liste de résolutions, la valeur nulle. Si vous ne spécifiez pas de, `valueSelectionStrategy` la valeur par défaut est`ORIGINAL_VALUE`. 

 ** [slotToElicit](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slotToElicit"></a>
Si tel `dialogState` est le cas`ElicitSlot`, renvoie le nom de l'emplacement pour lequel Amazon Lex demande une valeur.

La réponse renvoie ce qui suit en tant que corps HTTP.

 ** [audioStream](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-audioStream"></a>
Version audio du message à transmettre à l'utilisateur.

## Erreurs
<a name="API_runtime_PutSession_Errors"></a>

 ** BadGatewayException **   
Soit le bot Amazon Lex est toujours en cours de création, soit l'un des services dépendants (Amazon Polly, AWS Lambda) a échoué en raison d'une erreur de service interne.  
Code d’état HTTP : 502

 ** BadRequestException **   
 La validation de la demande a échoué, il n'y a aucun message utilisable dans le contexte, ou la création du bot a échoué, est toujours en cours ou contient des modifications non intégrées.   
Code d’état HTTP : 400

 ** ConflictException **   
 Deux clients utilisent le même compte AWS, le même bot Amazon Lex et le même ID utilisateur.   
Code d’état HTTP : 409

 ** DependencyFailedException **   
 L'une des dépendances, telle qu'AWS Lambda ou Amazon Polly, a généré une exception. Par exemple,   
+ Si Amazon Lex ne dispose pas des autorisations suffisantes pour appeler une fonction Lambda.
+ Si l'exécution d'une fonction Lambda prend plus de 30 secondes.
+ Si une fonction Lambda d'exécution renvoie une action de `Delegate` dialogue sans supprimer aucune valeur d'intervalle.
Code d'état HTTP : 424

 ** InternalFailureException **   
Erreur de service interne. Réessayez l'appel.  
Code d’état HTTP : 500

 ** LimitExceededException **   
Dépassement d'une limite.  
Code d’état HTTP : 429

 ** NotAcceptableException **   
L'en-tête d'acceptation de la demande n'a pas de valeur valide.  
Code d'état HTTP : 406

 ** NotFoundException **   
La ressource (telle que le bot Amazon Lex ou un alias) à laquelle il est fait référence est introuvable.  
Code d’état HTTP :404

## Voir aussi
<a name="API_runtime_PutSession_SeeAlso"></a>

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/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PutSession) 

# Types de données
<a name="API_Types"></a>

Les types de données suivants sont pris en charge par Amazon Lex Model Building Service :
+  [BotAliasMetadata](API_BotAliasMetadata.md) 
+  [BotChannelAssociation](API_BotChannelAssociation.md) 
+  [BotMetadata](API_BotMetadata.md) 
+  [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md) 
+  [BuiltinIntentSlot](API_BuiltinIntentSlot.md) 
+  [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md) 
+  [CodeHook](API_CodeHook.md) 
+  [ConversationLogsRequest](API_ConversationLogsRequest.md) 
+  [ConversationLogsResponse](API_ConversationLogsResponse.md) 
+  [EnumerationValue](API_EnumerationValue.md) 
+  [FollowUpPrompt](API_FollowUpPrompt.md) 
+  [FulfillmentActivity](API_FulfillmentActivity.md) 
+  [InputContext](API_InputContext.md) 
+  [Intent](API_Intent.md) 
+  [IntentMetadata](API_IntentMetadata.md) 
+  [KendraConfiguration](API_KendraConfiguration.md) 
+  [LogSettingsRequest](API_LogSettingsRequest.md) 
+  [LogSettingsResponse](API_LogSettingsResponse.md) 
+  [Message](API_Message.md) 
+  [MigrationAlert](API_MigrationAlert.md) 
+  [MigrationSummary](API_MigrationSummary.md) 
+  [OutputContext](API_OutputContext.md) 
+  [Prompt](API_Prompt.md) 
+  [ResourceReference](API_ResourceReference.md) 
+  [Slot](API_Slot.md) 
+  [SlotDefaultValue](API_SlotDefaultValue.md) 
+  [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md) 
+  [SlotTypeConfiguration](API_SlotTypeConfiguration.md) 
+  [SlotTypeMetadata](API_SlotTypeMetadata.md) 
+  [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md) 
+  [Statement](API_Statement.md) 
+  [Tag](API_Tag.md) 
+  [UtteranceData](API_UtteranceData.md) 
+  [UtteranceList](API_UtteranceList.md) 

Les types de données suivants sont pris en charge par Amazon Lex Runtime Service :
+  [ActiveContext](API_runtime_ActiveContext.md) 
+  [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md) 
+  [Button](API_runtime_Button.md) 
+  [DialogAction](API_runtime_DialogAction.md) 
+  [GenericAttachment](API_runtime_GenericAttachment.md) 
+  [IntentConfidence](API_runtime_IntentConfidence.md) 
+  [IntentSummary](API_runtime_IntentSummary.md) 
+  [PredictedIntent](API_runtime_PredictedIntent.md) 
+  [ResponseCard](API_runtime_ResponseCard.md) 
+  [SentimentResponse](API_runtime_SentimentResponse.md) 

# Service de modélisme Amazon Lex
<a name="API_Types_Amazon_Lex_Model_Building_Service"></a>

Les types de données suivants sont pris en charge par Amazon Lex Model Building Service :
+  [BotAliasMetadata](API_BotAliasMetadata.md) 
+  [BotChannelAssociation](API_BotChannelAssociation.md) 
+  [BotMetadata](API_BotMetadata.md) 
+  [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md) 
+  [BuiltinIntentSlot](API_BuiltinIntentSlot.md) 
+  [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md) 
+  [CodeHook](API_CodeHook.md) 
+  [ConversationLogsRequest](API_ConversationLogsRequest.md) 
+  [ConversationLogsResponse](API_ConversationLogsResponse.md) 
+  [EnumerationValue](API_EnumerationValue.md) 
+  [FollowUpPrompt](API_FollowUpPrompt.md) 
+  [FulfillmentActivity](API_FulfillmentActivity.md) 
+  [InputContext](API_InputContext.md) 
+  [Intent](API_Intent.md) 
+  [IntentMetadata](API_IntentMetadata.md) 
+  [KendraConfiguration](API_KendraConfiguration.md) 
+  [LogSettingsRequest](API_LogSettingsRequest.md) 
+  [LogSettingsResponse](API_LogSettingsResponse.md) 
+  [Message](API_Message.md) 
+  [MigrationAlert](API_MigrationAlert.md) 
+  [MigrationSummary](API_MigrationSummary.md) 
+  [OutputContext](API_OutputContext.md) 
+  [Prompt](API_Prompt.md) 
+  [ResourceReference](API_ResourceReference.md) 
+  [Slot](API_Slot.md) 
+  [SlotDefaultValue](API_SlotDefaultValue.md) 
+  [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md) 
+  [SlotTypeConfiguration](API_SlotTypeConfiguration.md) 
+  [SlotTypeMetadata](API_SlotTypeMetadata.md) 
+  [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md) 
+  [Statement](API_Statement.md) 
+  [Tag](API_Tag.md) 
+  [UtteranceData](API_UtteranceData.md) 
+  [UtteranceList](API_UtteranceList.md) 

# BotAliasMetadata
<a name="API_BotAliasMetadata"></a>

Fournit des informations sur l'alias d'un bot.

## Table des matières
<a name="API_BotAliasMetadata_Contents"></a>

 ** botName **   <a name="lex-Type-BotAliasMetadata-botName"></a>
Nom du robot sur lequel l'alias pointe.  
Type : chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : non

 ** botVersion **   <a name="lex-Type-BotAliasMetadata-botVersion"></a>
Version du bot Amazon Lex vers laquelle pointe l'alias.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : non

 ** checksum **   <a name="lex-Type-BotAliasMetadata-checksum"></a>
Somme de contrôle de l'alias du bot.  
Type : chaîne  
Obligatoire : non

 ** conversationLogs **   <a name="lex-Type-BotAliasMetadata-conversationLogs"></a>
Paramètres qui déterminent la manière dont Amazon Lex utilise les journaux de conversation pour l'alias.  
Type : objet [ConversationLogsResponse](API_ConversationLogsResponse.md)  
Obligatoire : non

 ** createdDate **   <a name="lex-Type-BotAliasMetadata-createdDate"></a>
Date à laquelle l'alias du bot a été créé.  
Type : Timestamp  
Obligatoire : non

 ** description **   <a name="lex-Type-BotAliasMetadata-description"></a>
Description de l'alias du bot.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** lastUpdatedDate **   <a name="lex-Type-BotAliasMetadata-lastUpdatedDate"></a>
Date à laquelle l'alias du 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  
Obligatoire : non

 ** name **   <a name="lex-Type-BotAliasMetadata-name"></a>
Le nom de l'alias du bot.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : non

## consultez aussi
<a name="API_BotAliasMetadata_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotAliasMetadata) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/BotAliasMetadata) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotAliasMetadata) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotAliasMetadata) 

# BotChannelAssociation
<a name="API_BotChannelAssociation"></a>

Représente une association entre un bot Amazon Lex et une plateforme de messagerie externe.

## Table des matières
<a name="API_BotChannelAssociation_Contents"></a>

 ** botAlias **   <a name="lex-Type-BotChannelAssociation-botAlias"></a>
Alias pointant vers la version spécifique du bot Amazon Lex avec laquelle cette association est établie.   
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : non

 ** botConfiguration **   <a name="lex-Type-BotChannelAssociation-botConfiguration"></a>
Fournit les informations nécessaires pour communiquer avec la plateforme de messagerie.   
Type : mappage chaîne/chaîne  
Entrées cartographiques : nombre maximum de 10 éléments.  
Obligatoire : non

 ** botName **   <a name="lex-Type-BotChannelAssociation-botName"></a>
Nom du bot Amazon Lex avec lequel cette association est établie.   
Amazon Lex soutient actuellement les associations avec Facebook, Slack et Twilio.
Type : chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : non

 ** createdDate **   <a name="lex-Type-BotChannelAssociation-createdDate"></a>
Date à laquelle l'association entre le bot Amazon Lex et le canal a été créée.   
Type : Timestamp  
Obligatoire : non

 ** description **   <a name="lex-Type-BotChannelAssociation-description"></a>
Description textuelle de l'association que vous créez.   
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** failureReason **   <a name="lex-Type-BotChannelAssociation-failureReason"></a>
Dans `status` l'affirmative`FAILED`, Amazon Lex fournit la raison pour laquelle il n'a pas réussi à créer l'association.  
Type : chaîne  
Obligatoire : non

 ** name **   <a name="lex-Type-BotChannelAssociation-name"></a>
Nom de l'association entre le bot et le canal.   
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : non

 ** status **   <a name="lex-Type-BotChannelAssociation-status"></a>
État du canal du bot.   
+  `CREATED`- La chaîne a été créée et est prête à être utilisée.
+  `IN_PROGRESS`- La création de la chaîne est en cours.
+  `FAILED`- Une erreur s'est produite lors de la création de la chaîne. Pour plus d'informations sur la raison de l'échec, consultez le `failureReason` champ.
Type : chaîne  
Valeurs valides : `IN_PROGRESS | CREATED | FAILED`   
Obligatoire : non

 ** type **   <a name="lex-Type-BotChannelAssociation-type"></a>
Spécifie le type d'association en indiquant le type de canal établi entre le bot Amazon Lex et la plateforme de messagerie externe.  
Type : chaîne  
Valeurs valides : `Facebook | Slack | Twilio-Sms | Kik`   
Obligatoire : non

## consultez aussi
<a name="API_BotChannelAssociation_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotChannelAssociation) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/BotChannelAssociation) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotChannelAssociation) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotChannelAssociation) 

# BotMetadata
<a name="API_BotMetadata"></a>

Fournit des informations sur un bot.

## Table des matières
<a name="API_BotMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-BotMetadata-createdDate"></a>
Date de création du bot.  
Type : Timestamp  
Obligatoire : non

 ** description **   <a name="lex-Type-BotMetadata-description"></a>
Description du bot.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** lastUpdatedDate **   <a name="lex-Type-BotMetadata-lastUpdatedDate"></a>
Date à laquelle le bot a été mis à jour. Lorsque vous créez un bot, la date de création et la date de dernière mise à jour sont identiques.   
Type : Timestamp  
Obligatoire : non

 ** name **   <a name="lex-Type-BotMetadata-name"></a>
Le nom du bot.   
Type : chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : non

 ** status **   <a name="lex-Type-BotMetadata-status"></a>
État du bot.  
Type : chaîne  
Valeurs valides : `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT`   
Obligatoire : non

 ** version **   <a name="lex-Type-BotMetadata-version"></a>
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.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : non

## consultez aussi
<a name="API_BotMetadata_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BotMetadata) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/BotMetadata) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BotMetadata) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BotMetadata) 

# BuiltinIntentMetadata
<a name="API_BuiltinIntentMetadata"></a>

Fournit des métadonnées pour une intention intégrée.

## Table des matières
<a name="API_BuiltinIntentMetadata_Contents"></a>

 ** signature **   <a name="lex-Type-BuiltinIntentMetadata-signature"></a>
Identifiant unique pour l'intention intégrée. Pour trouver la signature d'une intention, consultez la section [Intentions intégrées standard dans](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) le *kit de compétences Alexa*.  
Type : chaîne  
Obligatoire : non

 ** supportedLocales **   <a name="lex-Type-BuiltinIntentMetadata-supportedLocales"></a>
Une liste d'identifiants pour les paramètres régionaux pris en charge par l'intention.  
Type : tableau de chaînes  
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`   
Obligatoire : non

## consultez aussi
<a name="API_BuiltinIntentMetadata_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinIntentMetadata) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/BuiltinIntentMetadata) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinIntentMetadata) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinIntentMetadata) 

# BuiltinIntentSlot
<a name="API_BuiltinIntentSlot"></a>

Fournit des informations sur un emplacement utilisé dans une intention intégrée.

## Table des matières
<a name="API_BuiltinIntentSlot_Contents"></a>

 ** name **   <a name="lex-Type-BuiltinIntentSlot-name"></a>
Liste des emplacements définis pour l'intention.  
Type : chaîne  
Obligatoire : non

## consultez aussi
<a name="API_BuiltinIntentSlot_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinIntentSlot) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/BuiltinIntentSlot) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinIntentSlot) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinIntentSlot) 

# BuiltinSlotTypeMetadata
<a name="API_BuiltinSlotTypeMetadata"></a>

Fournit des informations sur un type de slot intégré.

## Table des matières
<a name="API_BuiltinSlotTypeMetadata_Contents"></a>

 ** signature **   <a name="lex-Type-BuiltinSlotTypeMetadata-signature"></a>
Identifiant unique pour le type de slot intégré. Pour trouver la signature d'un type d'emplacement, consultez la section [Référence du type d'emplacement](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) dans le *kit de compétences Alexa*.  
Type : chaîne  
Obligatoire : non

 ** supportedLocales **   <a name="lex-Type-BuiltinSlotTypeMetadata-supportedLocales"></a>
Liste des paramètres régionaux cibles pour le slot.   
Type : tableau de chaînes  
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`   
Obligatoire : non

## consultez aussi
<a name="API_BuiltinSlotTypeMetadata_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/BuiltinSlotTypeMetadata) 

# CodeHook
<a name="API_CodeHook"></a>

Spécifie une fonction Lambda qui vérifie les demandes adressées à un bot ou répond à la demande de l'utilisateur à un bot.

## Table des matières
<a name="API_CodeHook_Contents"></a>

 ** messageVersion **   <a name="lex-Type-CodeHook-messageVersion"></a>
Version de la demande-réponse que vous souhaitez qu'Amazon Lex utilise pour appeler votre fonction Lambda. Pour de plus amples informations, veuillez consulter [Utilisation des fonctions Lambda](using-lambda.md).  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 5.  
Obligatoire : oui

 ** uri **   <a name="lex-Type-CodeHook-uri"></a>
L'Amazon Resource Name (ARN) de la fonction  Lambda.  
Type : chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `arn:aws[a-zA-Z-]*:lambda:[a-z]+-[a-z]+(-[a-z]+)*-[0-9]:[0-9]{12}:function:[a-zA-Z0-9-_]+(\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})?(:[a-zA-Z0-9-_]+)?`   
Obligatoire : oui

## consultez aussi
<a name="API_CodeHook_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CodeHook) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/CodeHook) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CodeHook) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CodeHook) 

# ConversationLogsRequest
<a name="API_ConversationLogsRequest"></a>

Fournit les paramètres nécessaires pour les journaux de conversation.

## Table des matières
<a name="API_ConversationLogsRequest_Contents"></a>

 ** iamRoleArn **   <a name="lex-Type-ConversationLogsRequest-iamRoleArn"></a>
Le nom de ressource Amazon (ARN) d'un rôle IAM autorisé à écrire dans vos CloudWatch journaux pour les journaux texte et dans votre compartiment S3 pour les journaux audio. Si le chiffrement audio est activé, ce rôle fournit également l'autorisation d'accès à la clé AWS KMS utilisée pour chiffrer les journaux audio. Pour plus d'informations, consultez [Création d'un rôle IAM et d'une politique pour les journaux de conversation](https://docs.aws.amazon.com/lex/latest/dg/conversation-logs-role-and-policy.html).  
Type : chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obligatoire : oui

 ** logSettings **   <a name="lex-Type-ConversationLogsRequest-logSettings"></a>
Les paramètres de vos journaux de conversation. Vous pouvez enregistrer le texte ou l'audio de la conversation, ou les deux.  
Type : tableau d’objets [LogSettingsRequest](API_LogSettingsRequest.md)  
Obligatoire : oui

## consultez aussi
<a name="API_ConversationLogsRequest_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ConversationLogsRequest) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/ConversationLogsRequest) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ConversationLogsRequest) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ConversationLogsRequest) 

# ConversationLogsResponse
<a name="API_ConversationLogsResponse"></a>

Contient des informations sur les paramètres du journal des conversations.

## Table des matières
<a name="API_ConversationLogsResponse_Contents"></a>

 ** iamRoleArn **   <a name="lex-Type-ConversationLogsResponse-iamRoleArn"></a>
Le nom de ressource Amazon (ARN) du rôle IAM utilisé pour écrire vos journaux dans Logs ou dans un compartiment S3. CloudWatch   
Type : chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obligatoire : non

 ** logSettings **   <a name="lex-Type-ConversationLogsResponse-logSettings"></a>
Les paramètres de vos journaux de conversation. Vous pouvez enregistrer du texte, du son ou les deux.  
Type : tableau d’objets [LogSettingsResponse](API_LogSettingsResponse.md)  
Obligatoire : non

## consultez aussi
<a name="API_ConversationLogsResponse_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ConversationLogsResponse) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/ConversationLogsResponse) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ConversationLogsResponse) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ConversationLogsResponse) 

# EnumerationValue
<a name="API_EnumerationValue"></a>

Chaque type d'emplacement peut avoir un ensemble de valeurs. Chaque valeur d'énumération représente une valeur que le type de slot peut prendre. 

Par exemple, un robot de commande de pizzas peut avoir un type de machine à sous qui spécifie le type de croûte que la pizza doit avoir. Le type de slot peut inclure les valeurs 
+ épaisse
+ thin
+ farcies

## Table des matières
<a name="API_EnumerationValue_Contents"></a>

 ** value **   <a name="lex-Type-EnumerationValue-value"></a>
La valeur du type de slot.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 140.  
Obligatoire : oui

 ** synonyms **   <a name="lex-Type-EnumerationValue-synonyms"></a>
Valeurs supplémentaires liées à la valeur du type de slot.  
Type : tableau de chaînes  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 140.  
Obligatoire : non

## consultez aussi
<a name="API_EnumerationValue_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/EnumerationValue) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/EnumerationValue) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/EnumerationValue) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/EnumerationValue) 

# FollowUpPrompt
<a name="API_FollowUpPrompt"></a>

Invite à effectuer une activité supplémentaire une fois qu'une intention a été remplie. Par exemple, une fois l'`OrderPizza`intention remplie, vous pouvez demander à l'utilisateur de savoir s'il souhaite commander des boissons.

## Table des matières
<a name="API_FollowUpPrompt_Contents"></a>

 ** prompt **   <a name="lex-Type-FollowUpPrompt-prompt"></a>
Demande des informations à l'utilisateur.   
Type : objet [Prompt](API_Prompt.md)  
Obligatoire : oui

 ** rejectionStatement **   <a name="lex-Type-FollowUpPrompt-rejectionStatement"></a>
Si l'utilisateur répond « non » à la question définie dans le `prompt` champ, Amazon Lex répond par cette déclaration pour confirmer que l'intention a été annulée.   
Type : objet [Statement](API_Statement.md)  
Obligatoire : oui

## consultez aussi
<a name="API_FollowUpPrompt_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/FollowUpPrompt) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/FollowUpPrompt) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/FollowUpPrompt) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/FollowUpPrompt) 

# FulfillmentActivity
<a name="API_FulfillmentActivity"></a>

 Décrit comment l'intention est réalisée une fois que l'utilisateur a fourni toutes les informations requises pour l'intention. Vous pouvez fournir une fonction Lambda pour traiter l'intention, ou vous pouvez renvoyer les informations d'intention à l'application cliente. Nous vous recommandons d'utiliser une fonction Lambda afin que la logique pertinente réside dans le Cloud et de limiter le code côté client principalement à la présentation. Si vous devez mettre à jour la logique, vous ne mettez à jour que la fonction Lambda ; vous n'avez pas besoin de mettre à niveau votre application client. 

Considérez les exemples suivants :
+ Dans une application de commande de pizzas, une fois que l'utilisateur a fourni toutes les informations nécessaires pour passer une commande, vous utilisez une fonction Lambda pour passer une commande auprès d'une pizzeria. 
+ Dans une application de jeu, lorsqu'un utilisateur dit « ramasse une pierre », ces informations doivent être renvoyées à l'application cliente afin qu'elle puisse effectuer l'opération et mettre à jour les graphismes. Dans ce cas, vous souhaitez qu'Amazon Lex renvoie les données d'intention au client. 

## Table des matières
<a name="API_FulfillmentActivity_Contents"></a>

 ** type **   <a name="lex-Type-FulfillmentActivity-type"></a>
 Comment l'intention doit être remplie, soit en exécutant une fonction Lambda, soit en renvoyant les données du slot à l'application cliente.   
Type : chaîne  
Valeurs valides : `ReturnIntent | CodeHook`   
Obligatoire : oui

 ** codeHook **   <a name="lex-Type-FulfillmentActivity-codeHook"></a>
 Description de la fonction Lambda exécutée pour répondre à l'intention.   
Type : objet [CodeHook](API_CodeHook.md)  
Obligatoire : non

## consultez aussi
<a name="API_FulfillmentActivity_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/FulfillmentActivity) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/FulfillmentActivity) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/FulfillmentActivity) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/FulfillmentActivity) 

# InputContext
<a name="API_InputContext"></a>

Le nom d'un contexte qui doit être actif pour qu'une intention soit sélectionnée par Amazon Lex.

## Table des matières
<a name="API_InputContext_Contents"></a>

 ** name **   <a name="lex-Type-InputContext-name"></a>
Le nom du contexte.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## consultez aussi
<a name="API_InputContext_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/InputContext) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/InputContext) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/InputContext) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/InputContext) 

# Intent
<a name="API_Intent"></a>

Identifie la version spécifique d'une intention.

## Table des matières
<a name="API_Intent_Contents"></a>

 ** intentName **   <a name="lex-Type-Intent-intentName"></a>
Nom de l'intention.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** intentVersion **   <a name="lex-Type-Intent-intentVersion"></a>
Version de l'intention.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : oui

## consultez aussi
<a name="API_Intent_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Intent) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/Intent) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Intent) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Intent) 

# IntentMetadata
<a name="API_IntentMetadata"></a>

Fournit des informations sur une intention.

## Table des matières
<a name="API_IntentMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-IntentMetadata-createdDate"></a>
Date à laquelle l'intention a été créée.  
Type : Timestamp  
Obligatoire : non

 ** description **   <a name="lex-Type-IntentMetadata-description"></a>
Une description de l'intention.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** lastUpdatedDate **   <a name="lex-Type-IntentMetadata-lastUpdatedDate"></a>
Date à laquelle l'intention a été mise à jour. Lorsque vous créez une intention, la date de création et la date de dernière mise à jour sont identiques.  
Type : Timestamp  
Obligatoire : non

 ** name **   <a name="lex-Type-IntentMetadata-name"></a>
Nom de l'intention.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : non

 ** version **   <a name="lex-Type-IntentMetadata-version"></a>
Version de l'intention.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : non

## consultez aussi
<a name="API_IntentMetadata_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/IntentMetadata) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/IntentMetadata) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/IntentMetadata) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/IntentMetadata) 

# KendraConfiguration
<a name="API_KendraConfiguration"></a>

Fournit des informations de configuration pour l'AMAZON. KendraSearchIntentintention. Lorsque vous utilisez cette intention, Amazon Lex recherche l'index Amazon Kendra spécifié et renvoie les documents de l'index qui correspondent à l'énoncé de l'utilisateur. Pour plus d'informations, consultez [AMAZON. KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html).

## Table des matières
<a name="API_KendraConfiguration_Contents"></a>

 ** kendraIndex **   <a name="lex-Type-KendraConfiguration-kendraIndex"></a>
Le nom de ressource Amazon (ARN) de l'index Amazon Kendra que vous souhaitez voir apparaître sur AMAZON. KendraSearchIntent intention de fouiller. L'index doit se trouver dans le même compte et dans la même région que le bot Amazon Lex. Si l'index Amazon Kendra n'existe pas, vous obtenez une exception lorsque vous appelez l'`PutIntent`opération.  
Type : chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `arn:aws:kendra:[a-z]+-[a-z]+-[0-9]:[0-9]{12}:index\/[a-zA-Z0-9][a-zA-Z0-9_-]*`   
Obligatoire : oui

 ** role **   <a name="lex-Type-KendraConfiguration-role"></a>
Le nom de ressource Amazon (ARN) d'un rôle IAM autorisé à effectuer des recherches dans l'index Amazon Kendra. Le rôle doit appartenir au même compte et à la même région que le bot Amazon Lex. Si le rôle n'existe pas, vous obtenez une exception lorsque vous appelez l'`PutIntent`opération.  
Type : chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `arn:aws:iam::[0-9]{12}:role/.*`   
Obligatoire : oui

 ** queryFilterString **   <a name="lex-Type-KendraConfiguration-queryFilterString"></a>
Un filtre de requête qu'Amazon Lex envoie à Amazon Kendra pour filtrer la réponse de la requête. Le filtre est au format défini par Amazon Kendra. Pour plus d'informations, consultez la section [Filtrage des requêtes](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html).  
Vous pouvez remplacer cette chaîne de filtre par une nouvelle chaîne de filtre lors de l'exécution.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0.  
Obligatoire : non

## consultez aussi
<a name="API_KendraConfiguration_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/KendraConfiguration) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/KendraConfiguration) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/KendraConfiguration) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/KendraConfiguration) 

# LogSettingsRequest
<a name="API_LogSettingsRequest"></a>

Paramètres utilisés pour configurer le mode de livraison et la destination des journaux de conversation.

## Table des matières
<a name="API_LogSettingsRequest_Contents"></a>

 ** destination **   <a name="lex-Type-LogSettingsRequest-destination"></a>
Où les journaux seront livrés. Les journaux de texte sont envoyés à un groupe de CloudWatch journaux de journaux. Les journaux audio sont envoyés dans un compartiment S3.  
Type : chaîne  
Valeurs valides : `CLOUDWATCH_LOGS | S3`   
Obligatoire : oui

 ** logType **   <a name="lex-Type-LogSettingsRequest-logType"></a>
Type de journalisation à activer. Les journaux de texte sont envoyés à un groupe de CloudWatch journaux de journaux. Les journaux audio sont envoyés dans un compartiment S3.  
Type : chaîne  
Valeurs valides : `AUDIO | TEXT`   
Obligatoire : oui

 ** resourceArn **   <a name="lex-Type-LogSettingsRequest-resourceArn"></a>
Le nom de ressource Amazon (ARN) du groupe de CloudWatch journaux ou du compartiment S3 dans lequel les journaux doivent être fournis.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:(?:logs:[\w\-]+:[\d]{12}:log-group:[\.\-_/#A-Za-z0-9]{1,512}(?::\*)?|s3:::[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9])$`   
Obligatoire : oui

 ** kmsKeyArn **   <a name="lex-Type-LogSettingsRequest-kmsKeyArn"></a>
Le nom de ressource Amazon (ARN) de la clé gérée par le client AWS KMS pour chiffrer les journaux audio transmis à un compartiment S3. La clé ne s'applique pas aux CloudWatch journaux et est facultative pour les compartiments S3.  
Type : chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:kms:[\w\-]+:[\d]{12}:(?:key\/[\w\-]+|alias\/[a-zA-Z0-9:\/_\-]{1,256})$`   
Obligatoire : non

## consultez aussi
<a name="API_LogSettingsRequest_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/LogSettingsRequest) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/LogSettingsRequest) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/LogSettingsRequest) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/LogSettingsRequest) 

# LogSettingsResponse
<a name="API_LogSettingsResponse"></a>

Les paramètres des journaux de conversation.

## Table des matières
<a name="API_LogSettingsResponse_Contents"></a>

 ** destination **   <a name="lex-Type-LogSettingsResponse-destination"></a>
Destination où les journaux sont livrés.  
Type : chaîne  
Valeurs valides : `CLOUDWATCH_LOGS | S3`   
Obligatoire : non

 ** kmsKeyArn **   <a name="lex-Type-LogSettingsResponse-kmsKeyArn"></a>
L'Amazon Resource Name (ARN) de la clé utilisée pour chiffrer les journaux audio dans un compartiment S3.  
Type : chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:kms:[\w\-]+:[\d]{12}:(?:key\/[\w\-]+|alias\/[a-zA-Z0-9:\/_\-]{1,256})$`   
Obligatoire : non

 ** logType **   <a name="lex-Type-LogSettingsResponse-logType"></a>
Type de journalisation activé.  
Type : chaîne  
Valeurs valides : `AUDIO | TEXT`   
Obligatoire : non

 ** resourceArn **   <a name="lex-Type-LogSettingsResponse-resourceArn"></a>
Le nom de ressource Amazon (ARN) du groupe de CloudWatch journaux ou du compartiment S3 dans lequel les journaux sont livrés.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:(?:logs:[\w\-]+:[\d]{12}:log-group:[\.\-_/#A-Za-z0-9]{1,512}(?::\*)?|s3:::[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9])$`   
Obligatoire : non

 ** resourcePrefix **   <a name="lex-Type-LogSettingsResponse-resourcePrefix"></a>
Le préfixe de ressource est la première partie de la clé d'objet S3 dans le compartiment S3 que vous avez spécifié pour contenir les journaux audio. Pour les CloudWatch journaux, il s'agit du préfixe du nom du flux de journaux au sein du groupe de journaux que vous avez spécifié.   
Type : chaîne  
Contraintes de longueur : longueur maximum de 1 024.  
Obligatoire : non

## consultez aussi
<a name="API_LogSettingsResponse_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/LogSettingsResponse) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/LogSettingsResponse) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/LogSettingsResponse) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/LogSettingsResponse) 

# Message
<a name="API_Message"></a>

L'objet du message qui fournit le texte du message et son type.

## Table des matières
<a name="API_Message_Contents"></a>

 ** content **   <a name="lex-Type-Message-content"></a>
Le texte du message.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 1 000.  
Obligatoire : oui

 ** contentType **   <a name="lex-Type-Message-contentType"></a>
Type de contenu de la chaîne de message.  
Type : chaîne  
Valeurs valides : `PlainText | SSML | CustomPayload`   
Obligatoire : oui

 ** groupNumber **   <a name="lex-Type-Message-groupNumber"></a>
Identifie le groupe de messages auquel appartient le message. Lorsqu'un message est attribué à un groupe, Amazon Lex renvoie un message de chaque groupe dans la réponse.  
Type : entier  
Plage valide : valeur minimum de 1. Valeur maximale de 5.  
Obligatoire : non

## consultez aussi
<a name="API_Message_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Message) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/Message) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Message) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Message) 

# MigrationAlert
<a name="API_MigrationAlert"></a>

Fournit des informations sur les alertes et les avertissements envoyés par Amazon Lex lors d'une migration. Les alertes incluent des informations sur la manière de résoudre le problème.

## Table des matières
<a name="API_MigrationAlert_Contents"></a>

 ** details **   <a name="lex-Type-MigrationAlert-details"></a>
Informations supplémentaires sur l'alerte.  
Type : tableau de chaînes  
Obligatoire : non

 ** message **   <a name="lex-Type-MigrationAlert-message"></a>
Un message qui décrit la raison pour laquelle l'alerte a été émise.  
Type : chaîne  
Obligatoire : non

 ** referenceURLs **   <a name="lex-Type-MigrationAlert-referenceURLs"></a>
Lien vers la documentation Amazon Lex qui décrit comment résoudre l'alerte.  
Type : tableau de chaînes  
Obligatoire : non

 ** type **   <a name="lex-Type-MigrationAlert-type"></a>
Type d'alerte. Il existe deux types d'alertes :  
+  `ERROR`- Un problème n'a pas pu être résolu lors de la migration. La migration s'arrête.
+  `WARN`- Un problème lié à la migration nécessite des modifications manuelles du nouveau bot Amazon Lex V2. La migration se poursuit.
Type : chaîne  
Valeurs valides : `ERROR | WARN`   
Obligatoire : non

## consultez aussi
<a name="API_MigrationAlert_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/MigrationAlert) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/MigrationAlert) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/MigrationAlert) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/MigrationAlert) 

# MigrationSummary
<a name="API_MigrationSummary"></a>

Fournit des informations sur la migration d'un bot d'Amazon Lex V1 vers Amazon Lex V2.

## Table des matières
<a name="API_MigrationSummary_Contents"></a>

 ** migrationId **   <a name="lex-Type-MigrationSummary-migrationId"></a>
Identifiant unique attribué par Amazon Lex à la migration.  
Type : chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$`   
Obligatoire : non

 ** migrationStatus **   <a name="lex-Type-MigrationSummary-migrationStatus"></a>
L'état de l'opération. Lorsque le statut est défini, `COMPLETE` le bot est disponible dans Amazon Lex V2. Certaines alertes et avertissements doivent peut-être être résolus pour terminer la migration.  
Type : chaîne  
Valeurs valides : `IN_PROGRESS | COMPLETED | FAILED`   
Obligatoire : non

 ** migrationStrategy **   <a name="lex-Type-MigrationSummary-migrationStrategy"></a>
La stratégie utilisée pour effectuer la migration.  
Type : chaîne  
Valeurs valides : `CREATE_NEW | UPDATE_EXISTING`   
Obligatoire : non

 ** migrationTimestamp **   <a name="lex-Type-MigrationSummary-migrationTimestamp"></a>
Date et heure du début de la migration.  
Type : Timestamp  
Obligatoire : non

 ** v1BotLocale **   <a name="lex-Type-MigrationSummary-v1BotLocale"></a>
Les paramètres régionaux du bot Amazon Lex V1 à l'origine de la migration.  
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`   
Obligatoire : non

 ** v1BotName **   <a name="lex-Type-MigrationSummary-v1BotName"></a>
Nom du bot Amazon Lex V1 à l'origine de la migration.  
Type : chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : non

 ** v1BotVersion **   <a name="lex-Type-MigrationSummary-v1BotVersion"></a>
Version du bot Amazon Lex V1 à l'origine de la migration.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : non

 ** v2BotId **   <a name="lex-Type-MigrationSummary-v2BotId"></a>
L'identifiant unique de l'Amazon Lex V2 qui est la destination de la migration.  
Type : chaîne  
Contraintes de longueur : longueur fixe de 10.  
Modèle : `^[0-9a-zA-Z]+$`   
Obligatoire : non

 ** v2BotRole **   <a name="lex-Type-MigrationSummary-v2BotRole"></a>
Rôle IAM utilisé par Amazon Lex pour exécuter le bot Amazon Lex V2.  
Type : chaîne  
Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.  
Modèle : `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obligatoire : non

## consultez aussi
<a name="API_MigrationSummary_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/MigrationSummary) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/MigrationSummary) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/MigrationSummary) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/MigrationSummary) 

# OutputContext
<a name="API_OutputContext"></a>

Spécification d'un contexte de sortie défini lorsqu'une intention est satisfaite.

## Table des matières
<a name="API_OutputContext_Contents"></a>

 ** name **   <a name="lex-Type-OutputContext-name"></a>
Le nom du contexte.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** timeToLiveInSeconds **   <a name="lex-Type-OutputContext-timeToLiveInSeconds"></a>
Le nombre de secondes pendant lesquelles le contexte doit être actif après avoir été envoyé pour la première fois dans une `PostText` réponse `PostContent` ou. Vous pouvez définir une valeur comprise entre 5 et 86 400 secondes (24 heures).  
Type : entier  
Plage valide : valeur minimale de 5. Valeur maximum de 86 400.  
Obligatoire : oui

 ** turnsToLive **   <a name="lex-Type-OutputContext-turnsToLive"></a>
Le nombre de conversations indiquant que le contexte doit être actif. Une conversation prend la forme d'une `PostContent` `PostText` demande et de la réponse correspondante de la part d'Amazon Lex.  
Type : entier  
Plage valide : valeur minimum de 1. Valeur maximale de 20.  
Obligatoire : oui

## consultez aussi
<a name="API_OutputContext_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/OutputContext) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/OutputContext) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/OutputContext) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/OutputContext) 

# Prompt
<a name="API_Prompt"></a>

Obtient des informations auprès de l'utilisateur. Pour définir une invite, fournissez un ou plusieurs messages et spécifiez le nombre de tentatives d'obtention d'informations auprès de l'utilisateur. Si vous fournissez plusieurs messages, Amazon Lex choisit l'un des messages à utiliser pour inviter l'utilisateur. Pour de plus amples informations, veuillez consulter [Amazon Lex : comment ça marche](how-it-works.md).

## Table des matières
<a name="API_Prompt_Contents"></a>

 ** maxAttempts **   <a name="lex-Type-Prompt-maxAttempts"></a>
Le nombre de fois où l'utilisateur est invité à fournir des informations.  
Type : entier  
Plage valide : valeur minimum de 1. Valeur maximale de 5.  
Obligatoire : oui

 ** messages **   <a name="lex-Type-Prompt-messages"></a>
Tableau d'objets dont chacun fournit une chaîne de message et son type. Vous pouvez spécifier la chaîne du message en texte brut ou en langage SSML (Speech Synthesis Markup Language).  
Type : tableau d’objets [Message](API_Message.md)  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 15 articles.  
Obligatoire : oui

 ** responseCard **   <a name="lex-Type-Prompt-responseCard"></a>
Une carte-réponse. Amazon Lex utilise cette invite lors de l'exécution, dans la réponse de l'`PostText`API. Il remplace les attributs de session et les valeurs des créneaux par des espaces réservés dans la carte-réponse. Pour de plus amples informations, veuillez consulter [Utilisation d'une carte-réponse](ex-resp-card.md).   
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50 000  
Obligatoire : non

## consultez aussi
<a name="API_Prompt_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Prompt) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/Prompt) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Prompt) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Prompt) 

# ResourceReference
<a name="API_ResourceReference"></a>

Décrit la ressource qui fait référence à la ressource que vous essayez de supprimer. Cet objet est renvoyé dans le cadre de l'`ResourceInUseException`exception. 

## Table des matières
<a name="API_ResourceReference_Contents"></a>

 ** name **   <a name="lex-Type-ResourceReference-name"></a>
Nom de la ressource qui utilise la ressource que vous essayez de supprimer.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `[a-zA-Z_]+`   
Obligatoire : non

 ** version **   <a name="lex-Type-ResourceReference-version"></a>
Version de la ressource qui utilise la ressource que vous essayez de supprimer.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : non

## consultez aussi
<a name="API_ResourceReference_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ResourceReference) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/ResourceReference) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ResourceReference) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ResourceReference) 

# Slot
<a name="API_Slot"></a>

Identifie la version d'un slot spécifique.

## Table des matières
<a name="API_Slot_Contents"></a>

 ** name **   <a name="lex-Type-Slot-name"></a>
Le nom de l'emplacement.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z](-|_|.)?)+$`   
Obligatoire : oui

 ** slotConstraint **   <a name="lex-Type-Slot-slotConstraint"></a>
Spécifie si l'emplacement est obligatoire ou facultatif.   
Type : chaîne  
Valeurs valides : `Required | Optional`   
Obligatoire : oui

 ** defaultValueSpec **   <a name="lex-Type-Slot-defaultValueSpec"></a>
Liste des valeurs par défaut pour le slot. Les valeurs par défaut sont utilisées lorsqu'Amazon Lex n'a pas déterminé de valeur pour un emplacement. Vous pouvez spécifier des valeurs par défaut à partir de variables de contexte, d'attributs de session et de valeurs définies.  
Type : objet [SlotDefaultValueSpec](API_SlotDefaultValueSpec.md)  
Obligatoire : non

 ** description **   <a name="lex-Type-Slot-description"></a>
Description de l'emplacement.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** obfuscationSetting **   <a name="lex-Type-Slot-obfuscationSetting"></a>
Détermine si un emplacement est masqué dans les journaux de conversation et les énoncés enregistrés. Lorsque vous masquez un emplacement, la valeur est remplacée par le nom de l'emplacement entre accolades (\$1\$1). Par exemple, si le nom du slot est « full\$1name », les valeurs masquées sont remplacées par « \$1full\$1name\$1 ». Pour plus d'informations, consultez la section [Slot Obfuscation](https://docs.aws.amazon.com/lex/latest/dg/how-obfuscate.html).   
Type : chaîne  
Valeurs valides : `NONE | DEFAULT_OBFUSCATION`   
Obligatoire : non

 ** priority **   <a name="lex-Type-Slot-priority"></a>
 Indique à Amazon Lex l'ordre dans lequel il doit obtenir cette valeur d'emplacement auprès de l'utilisateur. Par exemple, si l'intention comporte deux emplacements de priorité 1 et 2, AWS Amazon Lex obtient d'abord une valeur pour l'emplacement de priorité 1.  
Si plusieurs emplacements partagent la même priorité, l'ordre dans lequel Amazon Lex obtient les valeurs est arbitraire.  
Type : entier  
Plage valide : Valeur minimum de 0. Valeur maximale fixée à 100.  
Obligatoire : non

 ** responseCard **   <a name="lex-Type-Slot-responseCard"></a>
 Un ensemble de réponses possibles pour le type de slot utilisé par les clients basés sur du texte. Un utilisateur choisit une option dans la carte-réponse, au lieu d'utiliser du texte pour répondre.   
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50 000.  
Obligatoire : non

 ** sampleUtterances **   <a name="lex-Type-Slot-sampleUtterances"></a>
 Si vous connaissez un schéma spécifique selon lequel les utilisateurs peuvent répondre à une demande Amazon Lex concernant une valeur de créneau, vous pouvez fournir ces énoncés pour améliorer la précision. Ce nom est facultatif. Dans la plupart des cas, Amazon Lex est capable de comprendre les énoncés des utilisateurs.   
Type : tableau de chaînes  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.  
Contraintes de longueur : longueur minimale de 1. Longueur maximum de 200.  
Obligatoire : non

 ** slotType **   <a name="lex-Type-Slot-slotType"></a>
Le type d'emplacement, qu'il s'agisse d'un type d'emplacement personnalisé que vous avez défini ou de l'un des types d'emplacement intégrés.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^((AMAZON\.)_?|[A-Za-z]_?)+`   
Obligatoire : non

 ** slotTypeVersion **   <a name="lex-Type-Slot-slotTypeVersion"></a>
Version du type de slot.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : non

 ** valueElicitationPrompt **   <a name="lex-Type-Slot-valueElicitationPrompt"></a>
L'invite qu'Amazon Lex utilise pour obtenir la valeur de l'emplacement auprès de l'utilisateur.  
Type : objet [Prompt](API_Prompt.md)  
Obligatoire : non

## consultez aussi
<a name="API_Slot_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Slot) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/Slot) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Slot) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Slot) 

# SlotDefaultValue
<a name="API_SlotDefaultValue"></a>

Valeur par défaut pour un emplacement.

## Table des matières
<a name="API_SlotDefaultValue_Contents"></a>

 ** defaultValue **   <a name="lex-Type-SlotDefaultValue-defaultValue"></a>
La valeur par défaut de l'emplacement. Vous pouvez spécifier l'une des options suivantes :  
+  `#context-name.slot-name`- La valeur du slot « slot-name » dans le contexte « context-name ».
+  `{attribute}`- La valeur de l'emplacement de l'attribut de session « attribute ».
+  `'value'`- La valeur discrète « valeur ».
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 202  
Obligatoire : oui

## consultez aussi
<a name="API_SlotDefaultValue_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotDefaultValue) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/SlotDefaultValue) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotDefaultValue) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotDefaultValue) 

# SlotDefaultValueSpec
<a name="API_SlotDefaultValueSpec"></a>

Contient les valeurs par défaut d'un emplacement. Les valeurs par défaut sont utilisées lorsqu'Amazon Lex n'a pas déterminé de valeur pour un emplacement.

## Table des matières
<a name="API_SlotDefaultValueSpec_Contents"></a>

 ** defaultValueList **   <a name="lex-Type-SlotDefaultValueSpec-defaultValueList"></a>
Les valeurs par défaut d'un emplacement. Vous pouvez spécifier plusieurs valeurs par défaut. Par exemple, vous pouvez spécifier une valeur par défaut à utiliser à partir d'une variable de contexte correspondante, d'un attribut de session ou d'une valeur fixe.  
La valeur par défaut choisie est sélectionnée en fonction de l'ordre dans lequel vous les spécifiez dans la liste. Par exemple, si vous spécifiez une variable de contexte et une valeur fixe dans cet ordre, Amazon Lex utilise la variable de contexte si elle est disponible, sinon il utilise la valeur fixe.  
Type : tableau d’objets [SlotDefaultValue](API_SlotDefaultValue.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.  
Obligatoire : oui

## consultez aussi
<a name="API_SlotDefaultValueSpec_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotDefaultValueSpec) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/SlotDefaultValueSpec) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotDefaultValueSpec) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotDefaultValueSpec) 

# SlotTypeConfiguration
<a name="API_SlotTypeConfiguration"></a>

Fournit des informations de configuration pour un type de slot.

## Table des matières
<a name="API_SlotTypeConfiguration_Contents"></a>

 ** regexConfiguration **   <a name="lex-Type-SlotTypeConfiguration-regexConfiguration"></a>
Une expression régulière utilisée pour valider la valeur d'un emplacement.  
Type : objet [SlotTypeRegexConfiguration](API_SlotTypeRegexConfiguration.md)  
Obligatoire : non

## consultez aussi
<a name="API_SlotTypeConfiguration_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeConfiguration) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/SlotTypeConfiguration) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeConfiguration) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeConfiguration) 

# SlotTypeMetadata
<a name="API_SlotTypeMetadata"></a>

Fournit des informations sur un type de slot.

## Table des matières
<a name="API_SlotTypeMetadata_Contents"></a>

 ** createdDate **   <a name="lex-Type-SlotTypeMetadata-createdDate"></a>
Date à laquelle le type de slot a été créé.  
Type : Timestamp  
Obligatoire : non

 ** description **   <a name="lex-Type-SlotTypeMetadata-description"></a>
Une description du type d'emplacement.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** lastUpdatedDate **   <a name="lex-Type-SlotTypeMetadata-lastUpdatedDate"></a>
Date à laquelle le type de slot 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  
Obligatoire : non

 ** name **   <a name="lex-Type-SlotTypeMetadata-name"></a>
Nom du type d'option.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : non

 ** version **   <a name="lex-Type-SlotTypeMetadata-version"></a>
Version du type de slot.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : non

## consultez aussi
<a name="API_SlotTypeMetadata_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeMetadata) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/SlotTypeMetadata) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeMetadata) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeMetadata) 

# SlotTypeRegexConfiguration
<a name="API_SlotTypeRegexConfiguration"></a>

Fournit une expression régulière utilisée pour valider la valeur de l'emplacement.

## Table des matières
<a name="API_SlotTypeRegexConfiguration_Contents"></a>

 ** pattern **   <a name="lex-Type-SlotTypeRegexConfiguration-pattern"></a>
Une expression régulière utilisée pour valider la valeur d'un emplacement.   
Utilisez une expression régulière standard. Amazon Lex prend en charge les caractères suivants dans l'expression régulière :  
+ A-Z, a-z
+ 0-9
+ Caractères Unicode (« \$1 u <Unicode>»)
Représentez les caractères Unicode à quatre chiffres, par exemple « \$1 u0041 » ou « \$1 u005a ».  
Les opérateurs d'expression régulière suivants ne sont pas pris en charge :  
+ Répéteurs infinis :\$1, \$1 ou \$1x,\$1 sans limite supérieure.
+ Caractère générique (.)
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Obligatoire : oui

## consultez aussi
<a name="API_SlotTypeRegexConfiguration_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/SlotTypeRegexConfiguration) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/SlotTypeRegexConfiguration) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/SlotTypeRegexConfiguration) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/SlotTypeRegexConfiguration) 

# Statement
<a name="API_Statement"></a>

Ensemble de messages qui transmettent des informations à l'utilisateur. Au moment de l'exécution, Amazon Lex sélectionne le message à transmettre. 

## Table des matières
<a name="API_Statement_Contents"></a>

 ** messages **   <a name="lex-Type-Statement-messages"></a>
Collection d'objets de message.  
Type : tableau d’objets [Message](API_Message.md)  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 15 articles.  
Obligatoire : oui

 ** responseCard **   <a name="lex-Type-Statement-responseCard"></a>
 Au moment de l'exécution, si le client utilise l'[PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)API, Amazon Lex inclut la carte de réponse dans la réponse. Il remplace tous les attributs de session et les valeurs des créneaux par des espaces réservés dans la carte-réponse.   
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50 000.  
Obligatoire : non

## consultez aussi
<a name="API_Statement_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Statement) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/Statement) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Statement) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Statement) 

# Tag
<a name="API_Tag"></a>

Liste de paires clé/valeur identifiant un bot, un alias de bot ou un canal de bot. Les clés et les valeurs des balises peuvent être composées de lettres Unicode, de chiffres, d'espaces blancs et de l'un des symboles suivants : \$1. :/= \$1 - @. 

## Table des matières
<a name="API_Tag_Contents"></a>

 ** key **   <a name="lex-Type-Tag-key"></a>
La clé du tag. Les clés ne distinguent pas les majuscules des minuscules et doivent être uniques.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 128.  
Obligatoire : oui

 ** value **   <a name="lex-Type-Tag-value"></a>
La valeur associée à une clé. La valeur peut être une chaîne vide, mais elle ne peut pas être nulle.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256.  
Obligatoire : oui

## consultez aussi
<a name="API_Tag_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/Tag) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/Tag) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/Tag) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/Tag) 

# UtteranceData
<a name="API_UtteranceData"></a>

Fournit des informations sur un seul énoncé adressé à votre bot. 

## Table des matières
<a name="API_UtteranceData_Contents"></a>

 ** count **   <a name="lex-Type-UtteranceData-count"></a>
Le nombre de fois que l'énoncé a été traité.  
Type : entier  
Obligatoire : non

 ** distinctUsers **   <a name="lex-Type-UtteranceData-distinctUsers"></a>
Le nombre total de personnes qui ont utilisé l'énoncé.  
Type : entier  
Obligatoire : non

 ** firstUtteredDate **   <a name="lex-Type-UtteranceData-firstUtteredDate"></a>
Date à laquelle l'énoncé a été enregistré pour la première fois.  
Type : Timestamp  
Obligatoire : non

 ** lastUtteredDate **   <a name="lex-Type-UtteranceData-lastUtteredDate"></a>
Date à laquelle l'énoncé a été enregistré pour la dernière fois.  
Type : Timestamp  
Obligatoire : non

 ** utteranceString **   <a name="lex-Type-UtteranceData-utteranceString"></a>
Le texte saisi par l'utilisateur ou la représentation textuelle d'un clip audio.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Durée maximale de 2000.  
Obligatoire : non

## consultez aussi
<a name="API_UtteranceData_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UtteranceData) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/UtteranceData) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UtteranceData) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UtteranceData) 

# UtteranceList
<a name="API_UtteranceList"></a>

Fournit une liste des énoncés adressés à une version spécifique de votre bot. La liste contient un maximum de 100 énoncés.

## Table des matières
<a name="API_UtteranceList_Contents"></a>

 ** botVersion **   <a name="lex-Type-UtteranceList-botVersion"></a>
Version du bot qui a traité la liste.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.  
Modèle : `\$LATEST|[0-9]+`   
Obligatoire : non

 ** utterances **   <a name="lex-Type-UtteranceList-utterances"></a>
Un ou plusieurs [UtteranceData](API_UtteranceData.md) objets contenant des informations sur les énoncés adressés à un robot. Le nombre maximum d'objets est de 100.  
Type : tableau d’objets [UtteranceData](API_UtteranceData.md)  
Obligatoire : non

## consultez aussi
<a name="API_UtteranceList_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UtteranceList) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lex-models-2017-04-19/UtteranceList) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UtteranceList) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UtteranceList) 

# Service d'exécution Amazon Lex
<a name="API_Types_Amazon_Lex_Runtime_Service"></a>

Les types de données suivants sont pris en charge par Amazon Lex Runtime Service :
+  [ActiveContext](API_runtime_ActiveContext.md) 
+  [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md) 
+  [Button](API_runtime_Button.md) 
+  [DialogAction](API_runtime_DialogAction.md) 
+  [GenericAttachment](API_runtime_GenericAttachment.md) 
+  [IntentConfidence](API_runtime_IntentConfidence.md) 
+  [IntentSummary](API_runtime_IntentSummary.md) 
+  [PredictedIntent](API_runtime_PredictedIntent.md) 
+  [ResponseCard](API_runtime_ResponseCard.md) 
+  [SentimentResponse](API_runtime_SentimentResponse.md) 

# ActiveContext
<a name="API_runtime_ActiveContext"></a>

Un contexte est une variable qui contient des informations sur l'état actuel de la conversation entre un utilisateur et Amazon Lex. Le contexte peut être défini automatiquement par Amazon Lex lorsqu'une intention est satisfaite, ou il peut être défini lors de l'exécution à l'aide de l'`PutSession`opération `PutContent``PutText`, ou.

## Table des matières
<a name="API_runtime_ActiveContext_Contents"></a>

 ** name **   <a name="lex-Type-runtime_ActiveContext-name"></a>
Le nom du contexte.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** parameters **   <a name="lex-Type-runtime_ActiveContext-parameters"></a>
Variables d'état pour le contexte actuel. Vous pouvez utiliser ces valeurs comme valeurs par défaut pour les créneaux lors d'événements ultérieurs.  
Type : mappage chaîne/chaîne  
Entrées cartographiques : nombre minimum de 0 éléments. Nombre maximum de 10 éléments.  
Contraintes de longueur de clé : longueur minimale de 1. Longueur maximum de 100.  
Contraintes de longueur de valeur : longueur minimale de 1. Longueur maximum de 1024.  
Obligatoire : oui

 ** timeToLive **   <a name="lex-Type-runtime_ActiveContext-timeToLive"></a>
Durée ou nombre de tours pendant lesquels un contexte reste actif.  
Type : objet [ActiveContextTimeToLive](API_runtime_ActiveContextTimeToLive.md)  
Obligatoire : oui

## consultez aussi
<a name="API_runtime_ActiveContext_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ActiveContext) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/ActiveContext) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ActiveContext) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ActiveContext) 

# ActiveContextTimeToLive
<a name="API_runtime_ActiveContextTimeToLive"></a>

Durée ou nombre de tours pendant lesquels un contexte reste actif.

## Table des matières
<a name="API_runtime_ActiveContextTimeToLive_Contents"></a>

 ** timeToLiveInSeconds **   <a name="lex-Type-runtime_ActiveContextTimeToLive-timeToLiveInSeconds"></a>
Le nombre de secondes pendant lesquelles le contexte doit être actif après avoir été envoyé pour la première fois dans une `PostText` réponse `PostContent` ou. Vous pouvez définir une valeur comprise entre 5 et 86 400 secondes (24 heures).  
Type : entier  
Plage valide : valeur minimale de 5. Valeur maximum de 86 400.  
Obligatoire : non

 ** turnsToLive **   <a name="lex-Type-runtime_ActiveContextTimeToLive-turnsToLive"></a>
Le nombre de conversations indiquant que le contexte doit être actif. Une conversation prend la forme `PostContent` d'une `PostText` demande et de la réponse correspondante d'Amazon Lex.  
Type : entier  
Plage valide : valeur minimum de 1. Valeur maximale de 20.  
Obligatoire : non

## consultez aussi
<a name="API_runtime_ActiveContextTimeToLive_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ActiveContextTimeToLive) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/ActiveContextTimeToLive) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ActiveContextTimeToLive) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ActiveContextTimeToLive) 

# Button
<a name="API_runtime_Button"></a>

Représente une option à afficher sur la plateforme client (Facebook, Slack, etc.)

## Table des matières
<a name="API_runtime_Button_Contents"></a>

 ** text **   <a name="lex-Type-runtime_Button-text"></a>
Texte visible par l'utilisateur sur le bouton.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 15.  
Obligatoire : oui

 ** value **   <a name="lex-Type-runtime_Button-value"></a>
La valeur envoyée à Amazon Lex lorsqu'un utilisateur clique sur le bouton. Par exemple, considérez le texte du bouton « NYC ». Lorsque l'utilisateur clique sur le bouton, la valeur envoyée peut être « New York City ».  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 1 000.  
Obligatoire : oui

## consultez aussi
<a name="API_runtime_Button_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/Button) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/Button) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/Button) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/Button) 

# DialogAction
<a name="API_runtime_DialogAction"></a>

Décrit la prochaine action que le bot doit effectuer lors de son interaction avec l'utilisateur et fournit des informations sur le contexte dans lequel l'action se déroule. Utilisez le type de `DialogAction` données pour définir un état spécifique pour l'interaction ou pour rétablir l'interaction à un état antérieur.

## Table des matières
<a name="API_runtime_DialogAction_Contents"></a>

 ** type **   <a name="lex-Type-runtime_DialogAction-type"></a>
L'action suivante que le bot doit effectuer lors de son interaction avec l'utilisateur. Les valeurs possibles sont :  
+  `ConfirmIntent`- L'action suivante consiste à demander à l'utilisateur si l'intention est complète et prête à être réalisée. Il s'agit d'une question par oui/non, du type « Passer la commande ? »
+  `Close`- Indique qu'il n'y aura pas de réponse de la part de l'utilisateur. Par exemple, la déclaration « Votre commande a été passée » ne nécessite pas de réponse.
+  `Delegate`- L'action suivante est déterminée par Amazon Lex.
+  `ElicitIntent`- L'action suivante consiste à déterminer l'intention que l'utilisateur souhaite atteindre.
+  `ElicitSlot`- L'action suivante consiste à obtenir une valeur d'emplacement auprès de l'utilisateur.
Type : chaîne  
Valeurs valides : `ElicitIntent | ConfirmIntent | ElicitSlot | Close | Delegate`   
Obligatoire : oui

 ** fulfillmentState **   <a name="lex-Type-runtime_DialogAction-fulfillmentState"></a>
État de réalisation de l'intention. Les valeurs possibles sont :  
+  `Failed`- La fonction Lambda associée à l'intention n'a pas atteint l'intention.
+  `Fulfilled`- L'intention a été remplie par la fonction Lambda associée à l'intention. 
+  `ReadyForFulfillment`- Toutes les informations nécessaires à l'intention sont présentes et l'intention est prête à être réalisée par l'application client.
Type : chaîne  
Valeurs valides : `Fulfilled | Failed | ReadyForFulfillment`   
Obligatoire : non

 ** intentName **   <a name="lex-Type-runtime_DialogAction-intentName"></a>
Nom de l'intention.  
Type : chaîne  
Obligatoire : non

 ** message **   <a name="lex-Type-runtime_DialogAction-message"></a>
Le message qui doit être affiché à l'utilisateur. Si vous ne spécifiez aucun message, Amazon Lex utilisera le message configuré en fonction de l'intention.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.  
Obligatoire : non

 ** messageFormat **   <a name="lex-Type-runtime_DialogAction-messageFormat"></a>
+  `PlainText`- Le message contient du texte UTF-8 brut.
+  `CustomPayload`- Le message est un format personnalisé pour le client.
+  `SSML`- Le message contient du texte formaté pour la sortie vocale.
+  `Composite`- Le message contient un objet JSON échappé contenant un ou plusieurs messages. Pour plus d'informations, consultez la section [Groupes de messages](https://docs.aws.amazon.com/lex/latest/dg/howitworks-manage-prompts.html). 
Type : chaîne  
Valeurs valides : `PlainText | CustomPayload | SSML | Composite`   
Obligatoire : non

 ** slots **   <a name="lex-Type-runtime_DialogAction-slots"></a>
Carte des machines à sous qui ont été collectées et de leurs valeurs.   
Type : mappage chaîne/chaîne  
Obligatoire : non

 ** slotToElicit **   <a name="lex-Type-runtime_DialogAction-slotToElicit"></a>
Le nom de l'emplacement qui doit être demandé à l'utilisateur.  
Type : chaîne  
Obligatoire : non

## consultez aussi
<a name="API_runtime_DialogAction_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/DialogAction) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/DialogAction) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/DialogAction) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/DialogAction) 

# GenericAttachment
<a name="API_runtime_GenericAttachment"></a>

Représente une option rendue à l'utilisateur lorsqu'une invite s'affiche. Il peut s'agir d'une image, d'un bouton, d'un lien ou d'un texte. 

## Table des matières
<a name="API_runtime_GenericAttachment_Contents"></a>

 ** attachmentLinkUrl **   <a name="lex-Type-runtime_GenericAttachment-attachmentLinkUrl"></a>
URL d'une pièce jointe à la carte-réponse.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : non

 ** buttons **   <a name="lex-Type-runtime_GenericAttachment-buttons"></a>
La liste des options à afficher à l'utilisateur.  
Type : tableau d’objets [Button](API_runtime_Button.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 5 éléments.  
Obligatoire : non

 ** imageUrl **   <a name="lex-Type-runtime_GenericAttachment-imageUrl"></a>
URL d'une image qui est affichée à l'utilisateur.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : non

 ** subTitle **   <a name="lex-Type-runtime_GenericAttachment-subTitle"></a>
Le sous-titre affiché sous le titre.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 80.  
Obligatoire : non

 ** title **   <a name="lex-Type-runtime_GenericAttachment-title"></a>
Titre de l'option.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 80.  
Obligatoire : non

## consultez aussi
<a name="API_runtime_GenericAttachment_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/GenericAttachment) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/GenericAttachment) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GenericAttachment) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/GenericAttachment) 

# IntentConfidence
<a name="API_runtime_IntentConfidence"></a>

Fournit un score qui indique la confiance d'Amazon Lex quant au fait qu'une intention est celle qui répond à l'intention de l'utilisateur.

## Table des matières
<a name="API_runtime_IntentConfidence_Contents"></a>

 ** score **   <a name="lex-Type-runtime_IntentConfidence-score"></a>
Un score qui indique dans quelle mesure Amazon Lex est convaincu qu'une intention répond à l'intention de l'utilisateur. Varie entre 0,00 et 1,00. Des scores plus élevés indiquent une plus grande confiance.  
Type : double  
Obligatoire : non

## consultez aussi
<a name="API_runtime_IntentConfidence_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/IntentConfidence) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/IntentConfidence) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/IntentConfidence) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/IntentConfidence) 

# IntentSummary
<a name="API_runtime_IntentSummary"></a>

Fournit des informations sur l'état d'une intention. Vous pouvez utiliser ces informations pour obtenir l'état actuel d'une intention afin de pouvoir traiter l'intention ou de rétablir l'intention à son état antérieur.

## Table des matières
<a name="API_runtime_IntentSummary_Contents"></a>

 ** dialogActionType **   <a name="lex-Type-runtime_IntentSummary-dialogActionType"></a>
L'action suivante que le bot doit effectuer lors de son interaction avec l'utilisateur. Les valeurs possibles sont :  
+  `ConfirmIntent`- L'action suivante consiste à demander à l'utilisateur si l'intention est complète et prête à être réalisée. Il s'agit d'une question par oui/non, du type « Passer la commande ? »
+  `Close`- Indique qu'il n'y aura pas de réponse de la part de l'utilisateur. Par exemple, la déclaration « Votre commande a été passée » ne nécessite pas de réponse.
+  `ElicitIntent`- L'action suivante consiste à déterminer l'intention que l'utilisateur souhaite atteindre.
+  `ElicitSlot`- L'action suivante consiste à obtenir une valeur d'emplacement auprès de l'utilisateur.
Type : chaîne  
Valeurs valides : `ElicitIntent | ConfirmIntent | ElicitSlot | Close | Delegate`   
Obligatoire : oui

 ** checkpointLabel **   <a name="lex-Type-runtime_IntentSummary-checkpointLabel"></a>
Une étiquette définie par l'utilisateur qui identifie une intention particulière. Vous pouvez utiliser cette étiquette pour revenir à une intention précédente.   
Utilisez le `checkpointLabelFilter` paramètre de l'`GetSessionRequest`opération pour filtrer les intentions renvoyées par l'opération en fonction de celles portant uniquement l'étiquette spécifiée.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255.  
Modèle : `[a-zA-Z0-9-]+`   
Obligatoire : non

 ** confirmationStatus **   <a name="lex-Type-runtime_IntentSummary-confirmationStatus"></a>
État de l'intention une fois que l'utilisateur a répondu à l'invite de confirmation. Si l'utilisateur confirme son intention, Amazon Lex définit ce champ sur`Confirmed`. Si l'utilisateur nie l'intention, Amazon Lex définit cette valeur sur`Denied`. Les valeurs possibles sont :  
+  `Confirmed`- L'utilisateur a répondu « Oui » à l'invite de confirmation, confirmant que l'intention est complète et qu'elle est prête à être réalisée.
+  `Denied`- L'utilisateur a répondu « Non » à l'invite de confirmation.
+  `None`- L'utilisateur n'a jamais été invité à confirmer ; ou bien, l'utilisateur a été invité mais n'a ni confirmé ni infirmé l'invite.
Type : chaîne  
Valeurs valides : `None | Confirmed | Denied`   
Obligatoire : non

 ** fulfillmentState **   <a name="lex-Type-runtime_IntentSummary-fulfillmentState"></a>
État de réalisation de l'intention. Les valeurs possibles sont :  
+  `Failed`- La fonction Lambda associée à l'intention n'a pas atteint l'intention.
+  `Fulfilled`- L'intention a été remplie par la fonction Lambda associée à l'intention. 
+  `ReadyForFulfillment`- Toutes les informations nécessaires à l'intention sont présentes et l'intention est prête à être réalisée par l'application client.
Type : chaîne  
Valeurs valides : `Fulfilled | Failed | ReadyForFulfillment`   
Obligatoire : non

 ** intentName **   <a name="lex-Type-runtime_IntentSummary-intentName"></a>
Nom de l'intention.  
Type : chaîne  
Obligatoire : non

 ** slots **   <a name="lex-Type-runtime_IntentSummary-slots"></a>
Carte des machines à sous qui ont été collectées et de leurs valeurs.   
Type : mappage chaîne/chaîne  
Obligatoire : non

 ** slotToElicit **   <a name="lex-Type-runtime_IntentSummary-slotToElicit"></a>
L'emplacement suivant à obtenir auprès de l'utilisateur. S'il n'y a pas de créneau à sélectionner, le champ est vide.  
Type : chaîne  
Obligatoire : non

## consultez aussi
<a name="API_runtime_IntentSummary_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/IntentSummary) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/IntentSummary) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/IntentSummary) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/IntentSummary) 

# PredictedIntent
<a name="API_runtime_PredictedIntent"></a>

Une intention suggérée par Amazon Lex répond à l'intention de l'utilisateur. Inclut le nom de l'intention, la certitude d'Amazon Lex quant à la satisfaction de l'intention de l'utilisateur et les créneaux définis pour l'intention.

## Table des matières
<a name="API_runtime_PredictedIntent_Contents"></a>

 ** intentName **   <a name="lex-Type-runtime_PredictedIntent-intentName"></a>
Le nom de l'intention suggéré par Amazon Lex répond à l'intention de l'utilisateur.  
Type : chaîne  
Obligatoire : non

 ** nluIntentConfidence **   <a name="lex-Type-runtime_PredictedIntent-nluIntentConfidence"></a>
Indique dans quelle mesure Amazon Lex est sûr qu'une intention répond à l'intention de l'utilisateur.  
Type : objet [IntentConfidence](API_runtime_IntentConfidence.md)  
Obligatoire : non

 ** slots **   <a name="lex-Type-runtime_PredictedIntent-slots"></a>
Le créneau et les valeurs des créneaux associés à l'intention prévue.  
Type : mappage chaîne/chaîne  
Obligatoire : non

## consultez aussi
<a name="API_runtime_PredictedIntent_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PredictedIntent) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/PredictedIntent) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PredictedIntent) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PredictedIntent) 

# ResponseCard
<a name="API_runtime_ResponseCard"></a>

Si vous configurez une carte de réponse lors de la création de vos robots, Amazon Lex remplace les attributs de session et les valeurs d'emplacement disponibles, puis les renvoie. La carte-réponse peut également provenir d'une fonction Lambda (`dialogCodeHook`et `fulfillmentActivity` d'une intention).

## Table des matières
<a name="API_runtime_ResponseCard_Contents"></a>

 ** contentType **   <a name="lex-Type-runtime_ResponseCard-contentType"></a>
Type de contenu de la réponse.  
Type : chaîne  
Valeurs valides : `application/vnd.amazonaws.card.generic`   
Obligatoire : non

 ** genericAttachments **   <a name="lex-Type-runtime_ResponseCard-genericAttachments"></a>
Tableau d'objets de pièce jointe représentant des options.  
Type : tableau d’objets [GenericAttachment](API_runtime_GenericAttachment.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.  
Obligatoire : non

 ** version **   <a name="lex-Type-runtime_ResponseCard-version"></a>
Version du format de carte-réponse.  
Type : chaîne  
Obligatoire : non

## consultez aussi
<a name="API_runtime_ResponseCard_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/ResponseCard) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/ResponseCard) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/ResponseCard) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/ResponseCard) 

# SentimentResponse
<a name="API_runtime_SentimentResponse"></a>

Le sentiment exprimé dans un énoncé.

Lorsque le bot est configuré pour envoyer des énoncés à Amazon Comprehend à des fins d'analyse des sentiments, cette structure de champs contient le résultat de l'analyse.

## Table des matières
<a name="API_runtime_SentimentResponse_Contents"></a>

 ** sentimentLabel **   <a name="lex-Type-runtime_SentimentResponse-sentimentLabel"></a>
Le sentiment inféré dans lequel Amazon Comprehend a le plus haut niveau de confiance.  
Type : chaîne  
Obligatoire : non

 ** sentimentScore **   <a name="lex-Type-runtime_SentimentResponse-sentimentScore"></a>
Probabilité que le sentiment ait été correctement inféré.  
Type : chaîne  
Obligatoire : non

## consultez aussi
<a name="API_runtime_SentimentResponse_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/SentimentResponse) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/runtime.lex-2016-11-28/SentimentResponse) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/SentimentResponse) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/SentimentResponse)