Aviso de fin de soporte: el 15 de septiembre de 2025, AWS dejaremos de ofrecer soporte para Amazon Lex V1. Después del 15 de septiembre de 2025, ya no podrá acceder a la consola de Amazon Lex V1 ni a los recursos de Amazon Lex V1. Si utiliza Amazon Lex V2, consulte en su lugar la [guía Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

El Servicio de creación de modelos de Amazon Lex admite las siguientes acciones:
+  [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) 

El Servicio de tiempo de ejecución de Amazon Lex admite las siguientes acciones:
+  [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) 

# Servicio de creación de modelos de Amazon Lex
<a name="API_Operations_Amazon_Lex_Model_Building_Service"></a>

El Servicio de creación de modelos de Amazon Lex admite las siguientes acciones:
+  [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>

Crea una nueva versión del bot basada en la versión `$LATEST`. Si la versión `$LATEST` de este recurso no ha cambiado desde que creó la última versión, Amazon Lex no crea una nueva versión. Devuelve la última versión creada.

**nota**  
Puede actualizar únicamente la versión `$LATEST` del bot. No puede actualizar las versiones numeradas que ha creado con la operación `CreateBotVersion`.

 Al crear la primera versión de un bot, Amazon Lex establece la versión en 1. Las versiones subsiguientes se incrementan en 1. Para obtener más información, consulte [Control de versiones](versioning-aliases.md#versioning-intro). 

 Esta operación necesita permiso para la acción `lex:CreateBotVersion`. 

## Sintaxis de la solicitud
<a name="API_CreateBotVersion_RequestSyntax"></a>

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

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

## Parámetros de solicitud del URI
<a name="API_CreateBotVersion_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-uri-name"></a>
El nombre del bot a partir del cual desea crear una nueva versión. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_CreateBotVersion_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [checksum](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-checksum"></a>
Identifica una revisión especifica de la versión `$LATEST` del bot. Si especifica una suma de comprobación y la versión `$LATEST` del bot tiene una suma de comprobación diferente, se devuelve una excepción `PreconditionFailedException` y Amazon Lex no publica una nueva versión. Si no especifica una suma de comprobación, Amazon Lex publica la versión `$LATEST`.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_CreateBotVersion_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.

El servicio devuelve los datos siguientes en formato JSON.

 ** [abortStatement](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-abortStatement"></a>
El mensaje que Amazon Lex utiliza para cancelar una conversación. Para obtener más información, consulte [PutBot](API_PutBot.md).  
Tipo: objeto [Statement](API_Statement.md)

 ** [checksum](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-checksum"></a>
La suma de comprobación que identifica la versión del bot que se ha creado.  
Tipo: cadena

 ** [childDirected](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-childDirected"></a>
Para cada bot de Amazon Lex creado con el Servicio de creación de modelos de Amazon Lex, debe especificar si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que esté dirigido, total o parcialmente, a niños menores de 13 años y esté sujeto a la Ley de protección de la privacidad infantil en línea (COPPA, por sus siglas en inglés). Para ello, especifique `true` o `false` en el campo `childDirected`. Al especificar `true` en el campo `childDirected`, confirma que el uso de Amazon Lex **está** relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. Al especificar `false` en el campo `childDirected`, confirma que el uso de Amazon Lex **no está** relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. No puede especificar un valor predeterminado en el campo `childDirected` que no indique de forma precisa si el uso de Amazon Lex está relacionado o no con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA.  
Si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años, debe obtener un consentimiento parental verificable, obligatorio en virtud de la COPPA. Para obtener información acerca del uso de Amazon Lex con relación a sitios web, programas u otras aplicaciones dirigidos, total o parcialmente, a niños menores de 13 años, consulte las [Preguntas frecuentes de Amazon Lex](https://aws.amazon.com/lex/faqs#data-security).   
Tipo: Booleano

 ** [clarificationPrompt](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-clarificationPrompt"></a>
El mensaje que Amazon Lex utiliza cuando no comprende la solicitud del usuario. Para obtener más información, consulte [PutBot](API_PutBot.md).   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-createdDate"></a>
La fecha en que se creó la versión del bot.  
Tipo: marca temporal

 ** [description](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-description"></a>
La descripción del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [detectSentiment](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-detectSentiment"></a>
Indica si los enunciados que ha introducido el usuario deben enviarse a Amazon Comprehend con fines de análisis de opiniones.  
Tipo: Booleano

 ** [enableModelImprovements](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-enableModelImprovements"></a>
Indica si el bot utiliza mejoras en la precisión. `true` indica que el bot utiliza las mejoras y `false`, lo contrario.  
Tipo: Booleano

 ** [failureReason](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-failureReason"></a>
Si `status` es `FAILED`, Amazon Lex proporciona el motivo por el que no se ha podido crear el bot.  
Tipo: cadena

 ** [idleSessionTTLInSeconds](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-idleSessionTTLInSeconds"></a>
El tiempo máximo que Amazon Lex retiene los datos recopilados en una conversación, en segundos. Para obtener más información, consulte [PutBot](API_PutBot.md).  
Tipo: entero  
Rango válido: valor mínimo de 60. Valor máximo de 86 400.

 ** [intents](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-intents"></a>
Una matriz de objetos `Intent`. Para obtener más información, consulte [PutBot](API_PutBot.md).  
Tipo: matriz de objetos [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-lastUpdatedDate"></a>
La fecha en la que se actualizó la versión `$LATEST` de este bot.   
Tipo: marca temporal

 ** [locale](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-locale"></a>
 Especifica la configuración regional de destino para el bot.   
Tipo: cadena  
Valores válidos: `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>
El nombre del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [status](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-status"></a>
 Cuando envía una solicitud para crear o actualizar un bot, Amazon Lex establece el elemento de respuesta `status` en `BUILDING`. Una vez que Amazon Lex ha creado el bot, se establece `status` en `READY`. Si Amazon Lex no puede crear el bot, se establece `status` en `FAILED`. Amazon Lex devuelve el motivo del error en el elemento de respuesta `failureReason`.   
Tipo: cadena  
Valores válidos: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-version"></a>
La versión del bot.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-voiceId"></a>
El ID de voz de Amazon Polly que Amazon Lex utiliza para las interacciones de voz con el usuario.  
Tipo: cadena

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** PreconditionFailedException **   
 La suma de comprobación del recurso que intenta modificar no coincide con la suma de comprobación de la solicitud. Revise la suma de comprobación del recurso e inténtelo de nuevo.  
Código de estado HTTP: 412

## Véase también
<a name="API_CreateBotVersion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateBotVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateBotVersion) 

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

Crea una nueva versión de una intención basada en la versión `$LATEST` de la intención. Si la versión `$LATEST` de esta intención no ha cambiado desde que se actualizó por última vez, Amazon Lex no crea una nueva versión. Devuelve la última versión creada.

**nota**  
Puede actualizar únicamente la versión `$LATEST` de la intención. No puede actualizar las versiones numeradas que ha creado con la operación `CreateIntentVersion`.

 Al crear una versión de una intención, Amazon Lex establece la versión en 1. Las versiones subsiguientes se incrementan en 1. Para obtener más información, consulte [Control de versiones](versioning-aliases.md#versioning-intro). 

Esto operación requiere permisos para realizar la acción `lex:CreateIntentVersion`. 

## Sintaxis de la solicitud
<a name="API_CreateIntentVersion_RequestSyntax"></a>

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

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

## Parámetros de solicitud del URI
<a name="API_CreateIntentVersion_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-uri-name"></a>
El nombre de la intención a partir del cual desea crear una nueva versión. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_CreateIntentVersion_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [checksum](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-checksum"></a>
La suma de comprobación de la versión `$LATEST` de la intención que se debe utilizar para crear la nueva versión. Si especifica una suma de comprobación y la versión `$LATEST` de la intención tiene una suma de comprobación diferente, Amazon Lex devuelve una excepción `PreconditionFailedException` y no publica una nueva versión. Si no especifica una suma de comprobación, Amazon Lex publica la versión `$LATEST`.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_CreateIntentVersion_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.

El servicio devuelve los datos siguientes en formato JSON.

 ** [checksum](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-checksum"></a>
La suma de comprobación de la versión de la intención creada.  
Tipo: cadena

 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-conclusionStatement"></a>
Una vez que la función de Lambda especificada en el campo `fulfillmentActivity` cumple con la intención, Amazon Lex transmite esta afirmación al usuario.   
Tipo: objeto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-confirmationPrompt"></a>
Si se define, la solicitud que Amazon Lex utiliza para confirmar la intención del usuario antes de cumplirla.   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-createdDate"></a>
La fecha en que se creó la intención.  
Tipo: marca temporal

 ** [description](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-description"></a>
Una descripción de la intención.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-dialogCodeHook"></a>
Si está definida, Amazon Lex invoca esta función de Lambda para cada entrada del usuario.  
Tipo: objeto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-followUpPrompt"></a>
Si se define, Amazon Lex utiliza esta solicitud para solicitar actividad adicional del usuario una vez que se ha cumplido con la intención.   
Tipo: objeto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-fulfillmentActivity"></a>
 Describe cómo se cumple con la intención.   
Tipo: objeto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-inputContexts"></a>
Una matriz de objetos `InputContext` que enumera los contextos que deben estar activos para que Amazon Lex elija la intención en una conversación con el usuario.  
Tipo: matriz de objetos [InputContext](API_InputContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 5 artículos.

 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-kendraConfiguration"></a>
Información sobre la configuración necesaria, si procede, para conectar un índice de Amazon Kendra con la intención `AMAZON.KendraSearchIntent`.  
Tipo: objeto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-lastUpdatedDate"></a>
La fecha de actualización de la intención.   
Tipo: marca temporal

 ** [name](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-name"></a>
El nombre de la intención.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-outputContexts"></a>
Una matriz de objetos `OutputContext` que enumera los contextos en los que la intención se activa cuando esta se cumple.  
Tipo: matriz de objetos [OutputContext](API_OutputContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.

 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-parentIntentSignature"></a>
Un identificador único para una intención integrada.  
Tipo: cadena

 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-rejectionStatement"></a>
Si el usuario responde “no” a la pregunta definida en `confirmationPrompt`, Amazon Lex responde con esta afirmación para confirmar que la intención se ha cancelado.   
Tipo: objeto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-sampleUtterances"></a>
Una matriz de ejemplos de enunciados configurados para la intención.   
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 1500 elementos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.

 ** [slots](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-slots"></a>
Una matriz de tipos de ranura que define la información necesaria para cumplir con la intención.  
Tipo: matriz de objetos [Slot](API_Slot.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 100 artículos.

 ** [version](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-version"></a>
El número de versión asignado a la nueva versión de la intención.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** PreconditionFailedException **   
 La suma de comprobación del recurso que intenta modificar no coincide con la suma de comprobación de la solicitud. Revise la suma de comprobación del recurso e inténtelo de nuevo.  
Código de estado HTTP: 412

## Véase también
<a name="API_CreateIntentVersion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateIntentVersion) 

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

Crea una nueva versión de un tipo de ranura basada en la versión `$LATEST` del tipo de ranura especificado. Si la versión `$LATEST` de este recurso no ha cambiado desde que creó la última versión, Amazon Lex no crea una nueva versión. Devuelve la última versión creada. 

**nota**  
Solo puede actualizar la versión `$LATEST` de un tipo de ranura. No puede actualizar las versiones numeradas que ha creado con la operación `CreateSlotTypeVersion`.

Al crear una versión de un tipo de ranura, Amazon Lex establece la versión en 1. Las versiones subsiguientes se incrementan en 1. Para obtener más información, consulte [Control de versiones](versioning-aliases.md#versioning-intro). 

Esta operación necesita permisos para la acción `lex:CreateSlotTypeVersion`.

## Sintaxis de la solicitud
<a name="API_CreateSlotTypeVersion_RequestSyntax"></a>

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

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

## Parámetros de solicitud del URI
<a name="API_CreateSlotTypeVersion_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-uri-name"></a>
El nombre del tipo de ranura a partir del cual desea crear una nueva versión. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_CreateSlotTypeVersion_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [checksum](#API_CreateSlotTypeVersion_RequestSyntax) **   <a name="lex-CreateSlotTypeVersion-request-checksum"></a>
La suma de comprobación de la versión `$LATEST` del tipo de ranura que desea publicar. Si especifica una suma de comprobación y la versión `$LATEST` del tipo de ranura tiene una suma de comprobación diferente, Amazon Lex devuelve una excepción `PreconditionFailedException` y no publica la nueva versión. Si no especifica una suma de comprobación, Amazon Lex publica la versión `$LATEST`.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_CreateSlotTypeVersion_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.

El servicio devuelve los datos siguientes en formato JSON.

 ** [checksum](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-checksum"></a>
La suma de comprobación de la versión `$LATEST` del tipo de ranura.  
Tipo: cadena

 ** [createdDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-createdDate"></a>
La fecha de creación del tipo de ranura.  
Tipo: marca temporal

 ** [description](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-description"></a>
Una descripción del tipo de slot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [enumerationValues](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-enumerationValues"></a>
Una lista de objetos `EnumerationValue` que define los valores que puede tomar el tipo de ranura.  
Tipo: matriz de objetos [EnumerationValue](API_EnumerationValue.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 10 000 elementos.

 ** [lastUpdatedDate](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-lastUpdatedDate"></a>
La fecha de actualización del tipo de ranura. Cuando se crea un recurso, la fecha de creación y la fecha de la última actualización son la misma.  
Tipo: marca temporal

 ** [name](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-name"></a>
El nombre del tipo de slot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-parentSlotTypeSignature"></a>
El tipo de ranura integrado que se utiliza como principal para este tipo de ranura.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-slotTypeConfigurations"></a>
Información sobre la configuración que amplía el tipo de ranura integrado principal.  
Tipo: matriz de objetos [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.

 ** [valueSelectionStrategy](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-valueSelectionStrategy"></a>
La estrategia que Amazon Lex utiliza para determinar el valor de la ranura. Para obtener más información, consulte [PutSlotType](API_PutSlotType.md).  
Tipo: cadena  
Valores válidos: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_CreateSlotTypeVersion_ResponseSyntax) **   <a name="lex-CreateSlotTypeVersion-response-version"></a>
La versión asignada a la nueva versión del tipo de ranura.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** PreconditionFailedException **   
 La suma de comprobación del recurso que intenta modificar no coincide con la suma de comprobación de la solicitud. Revise la suma de comprobación del recurso e inténtelo de nuevo.  
Código de estado HTTP: 412

## Véase también
<a name="API_CreateSlotTypeVersion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateSlotTypeVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateSlotTypeVersion) 

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

Elimina todas las versiones del bot, incluida la versión `$LATEST`. Para eliminar una versión específica del bot, utilice la operación [DeleteBotVersion](API_DeleteBotVersion.md). La operación `DeleteBot` no elimina de inmediato el esquema de bots. Lo que hace es marcarlos para su eliminación y los elimina más adelante.

Amazon Lex almacena los enunciados de forma indefinida para mejorar la capacidad de respuesta a entradas del usuario del bot. Estos enunciados no se eliminan cuando se elimina el bot. Para eliminar los enunciados, utilice la operación [DeleteUtterances](API_DeleteUtterances.md).

Si un bot tiene un alias, no se puede eliminar. En su lugar, la operación `DeleteBot` devuelve una excepción `ResourceInUseException` que incluye una referencia al alias que, a su vez, hace referencia al bot. Para eliminar la referencia al bot, elimine el alias. Si vuelve a aparecer la misma excepción, elimine el alias de referencia hasta que la operación `DeleteBot` se realice correctamente.

Esta operación necesita permisos para la acción `lex:DeleteBot`.

## Sintaxis de la solicitud
<a name="API_DeleteBot_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteBot_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_DeleteBot_RequestSyntax) **   <a name="lex-DeleteBot-request-uri-name"></a>
El nombre del bot. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBot_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBot_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteBot_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** ResourceInUseException **   
Otro recurso hace referencia al recurso que intenta eliminar. Utilice esta información para eliminar referencias al recurso que intenta eliminar.  
El cuerpo de la excepción contiene un objeto JSON que describe el recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Describe el recurso que hace referencia al recurso que intenta eliminar. Este objeto se devuelve como parte de la excepción `ResourceInUseException`. 
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteBot_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBot) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBot) 

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

Elimina un alias para el bot especificado. 

No puede eliminar un alias que se utiliza en la asociación entre un bot y un canal de mensajería. Si se utiliza un alias en una asociación de canal, la operación `DeleteBot` devuelve una excepción `ResourceInUseException` que incluye una referencia a la asociación de canal que, a su vez, hace referencia al bot. Para eliminar la referencia al alias, elimine la asociación de canal. Si vuelve a aparecer la misma excepción, elimine la asociación de la referencia hasta que la operación `DeleteBotAlias` se realice correctamente.

## Sintaxis de la solicitud
<a name="API_DeleteBotAlias_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteBotAlias_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [botName](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-botName"></a>
El nombre del bot al que apunta el alias.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [name](#API_DeleteBotAlias_RequestSyntax) **   <a name="lex-DeleteBotAlias-request-uri-name"></a>
El nombre del alias que se va a eliminar. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBotAlias_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBotAlias_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteBotAlias_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** ResourceInUseException **   
Otro recurso hace referencia al recurso que intenta eliminar. Utilice esta información para eliminar referencias al recurso que intenta eliminar.  
El cuerpo de la excepción contiene un objeto JSON que describe el recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Describe el recurso que hace referencia al recurso que intenta eliminar. Este objeto se devuelve como parte de la excepción `ResourceInUseException`. 
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteBotAlias_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotAlias) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotAlias) 

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

Elimina la asociación entre un bot de Amazon Lex y una plataforma de mensajería.

Esta operación necesita permiso para la acción `lex:DeleteBotChannelAssociation`.

## Sintaxis de la solicitud
<a name="API_DeleteBotChannelAssociation_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteBotChannelAssociation_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [aliasName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botAlias"></a>
Un alias que apunta a la versión exacta del bot de Amazon Lex al que se vincula esta asociación.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [botName](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-botName"></a>
El nombre del bot de Amazon Lex.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [name](#API_DeleteBotChannelAssociation_RequestSyntax) **   <a name="lex-DeleteBotChannelAssociation-request-uri-name"></a>
El nombre de la asociación. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBotChannelAssociation_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBotChannelAssociation_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteBotChannelAssociation_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_DeleteBotChannelAssociation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotChannelAssociation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotChannelAssociation) 

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

Elimina una versión específica de un bot. Para eliminar todas las versiones de un bot, utilice la operación [DeleteBot](API_DeleteBot.md). 

Esta operación necesita permisos para la acción `lex:DeleteBotVersion`.

## Sintaxis de la solicitud
<a name="API_DeleteBotVersion_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteBotVersion_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-name"></a>
El nombre del bot.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [version](#API_DeleteBotVersion_RequestSyntax) **   <a name="lex-DeleteBotVersion-request-uri-version"></a>
La versión del bot que se va a eliminar. No puede eliminar la versión `$LATEST` del bot. Para eliminar la versión `$LATEST`, utilice la operación [DeleteBot](API_DeleteBot.md).  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[0-9]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBotVersion_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBotVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteBotVersion_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** ResourceInUseException **   
Otro recurso hace referencia al recurso que intenta eliminar. Utilice esta información para eliminar referencias al recurso que intenta eliminar.  
El cuerpo de la excepción contiene un objeto JSON que describe el recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Describe el recurso que hace referencia al recurso que intenta eliminar. Este objeto se devuelve como parte de la excepción `ResourceInUseException`. 
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteBotVersion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteBotVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteBotVersion) 

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

Elimina todas las versiones de la intención, incluida la versión `$LATEST`. Para eliminar una versión específica de la intención, utilice la operación [DeleteIntentVersion](API_DeleteIntentVersion.md).

 Puede eliminar una versión de una intención solo si no tiene referencias. Para eliminar una intención a la que se hace referencia en uno o más bots (consulte [Funcionamiento de Amazon Lex](how-it-works.md)), debe eliminar primero las referencias. 

**nota**  
 Si se muestra la excepción `ResourceInUseException`, proporciona un ejemplo de referencia que indica dónde se hace referencia a la intención. Para eliminar la referencia a la intención, actualice el bot o elimínelo. Si se muestra la misma excepción cuando intenta eliminar la intención, repita la acción hasta que la intención no tenga referencias y la llamada a `DeleteIntent` sea correcta. 

 Esta operación necesita permiso para la acción `lex:DeleteIntent`. 

## Sintaxis de la solicitud
<a name="API_DeleteIntent_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteIntent_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_DeleteIntent_RequestSyntax) **   <a name="lex-DeleteIntent-request-uri-name"></a>
El nombre de la intención. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteIntent_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteIntent_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteIntent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** ResourceInUseException **   
Otro recurso hace referencia al recurso que intenta eliminar. Utilice esta información para eliminar referencias al recurso que intenta eliminar.  
El cuerpo de la excepción contiene un objeto JSON que describe el recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Describe el recurso que hace referencia al recurso que intenta eliminar. Este objeto se devuelve como parte de la excepción `ResourceInUseException`. 
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteIntent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntent) 

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

Elimina una versión específica de una intención. Para eliminar todas las versiones de una intención, utilice la operación [DeleteIntent](API_DeleteIntent.md). 

Esta operación necesita permisos para la acción `lex:DeleteIntentVersion`.

## Sintaxis de la solicitud
<a name="API_DeleteIntentVersion_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteIntentVersion_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-name"></a>
El nombre de la intención.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [version](#API_DeleteIntentVersion_RequestSyntax) **   <a name="lex-DeleteIntentVersion-request-uri-version"></a>
La versión de la intención que se va a eliminar. No puede eliminar la versión `$LATEST` de la intención. Para eliminar la versión `$LATEST`, utilice la operación [DeleteIntent](API_DeleteIntent.md).  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[0-9]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteIntentVersion_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteIntentVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteIntentVersion_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** ResourceInUseException **   
Otro recurso hace referencia al recurso que intenta eliminar. Utilice esta información para eliminar referencias al recurso que intenta eliminar.  
El cuerpo de la excepción contiene un objeto JSON que describe el recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Describe el recurso que hace referencia al recurso que intenta eliminar. Este objeto se devuelve como parte de la excepción `ResourceInUseException`. 
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteIntentVersion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteIntentVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteIntentVersion) 

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

Elimina todas las versiones del tipo de ranura, incluida la versión `$LATEST`. Para eliminar una versión específica del tipo de ranura, utilice la operación [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md).

 Puede eliminar una versión de un tipo de ranura solo si no tiene referencias. Para eliminar un tipo de ranura al que se hace referencia en una o más intenciones, debe eliminar primero las referencias. 

**nota**  
 Si se muestra la excepción `ResourceInUseException`, la excepción proporciona un ejemplo de referencia que indica la intención en la que se hace referencia al tipo de ranura. Para eliminar la referencia al tipo de ranura, actualice la intención o elimínela. Si se muestra la misma excepción cuando intenta eliminar el tipo de ranura, repita la acción hasta que la intención no tenga referencias y la llamada a `DeleteSlotType` sea correcta. 

Esta operación necesita permiso para la acción `lex:DeleteSlotType`.

## Sintaxis de la solicitud
<a name="API_DeleteSlotType_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteSlotType_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_DeleteSlotType_RequestSyntax) **   <a name="lex-DeleteSlotType-request-uri-name"></a>
El nombre del tipo de slot. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteSlotType_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteSlotType_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteSlotType_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** ResourceInUseException **   
Otro recurso hace referencia al recurso que intenta eliminar. Utilice esta información para eliminar referencias al recurso que intenta eliminar.  
El cuerpo de la excepción contiene un objeto JSON que describe el recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Describe el recurso que hace referencia al recurso que intenta eliminar. Este objeto se devuelve como parte de la excepción `ResourceInUseException`. 
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteSlotType_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotType) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotType) 

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

Elimina una versión específica de un tipo de ranura. Para eliminar todas las versiones de un tipo de ranura, utilice la operación [DeleteSlotType](API_DeleteSlotType.md). 

Esta operación necesita permisos para la acción `lex:DeleteSlotTypeVersion`.

## Sintaxis de la solicitud
<a name="API_DeleteSlotTypeVersion_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteSlotTypeVersion_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-name"></a>
El nombre del tipo de slot.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [version](#API_DeleteSlotTypeVersion_RequestSyntax) **   <a name="lex-DeleteSlotTypeVersion-request-uri-version"></a>
La versión del tipo de ranura que se va a eliminar. No puede eliminar la versión `$LATEST` del tipo de ranura. Para eliminar la versión `$LATEST`, utilice la operación [DeleteSlotType](API_DeleteSlotType.md).  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[0-9]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteSlotTypeVersion_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteSlotTypeVersion_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteSlotTypeVersion_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

 ** ResourceInUseException **   
Otro recurso hace referencia al recurso que intenta eliminar. Utilice esta información para eliminar referencias al recurso que intenta eliminar.  
El cuerpo de la excepción contiene un objeto JSON que describe el recurso.  
 `{ "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT,`   
 `"resourceReference": {`   
 `"name": string, "version": string } }`     
 ** exampleReference **   
Describe el recurso que hace referencia al recurso que intenta eliminar. Este objeto se devuelve como parte de la excepción `ResourceInUseException`. 
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteSlotTypeVersion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteSlotTypeVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteSlotTypeVersion) 

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

Elimina los enunciados almacenados.

Amazon Lex almacena los enunciados que los usuarios envían al bot. Los enunciados se almacenan durante 15 días para su uso con la operación [GetUtterancesView](API_GetUtterancesView.md) y, a continuación, se almacenan indefinidamente con el fin de mejorar la capacidad del bot de responder a entradas del usuario.

Utilice la operación `DeleteUtterances` para eliminar manualmente los enunciados almacenados de un usuario específico. Al utilizar la operación `DeleteUtterances`, los enunciados almacenados con el fin de mejorar la capacidad del bot de responder a entradas del usuario se eliminan de inmediato. Los enunciados almacenados para su uso con la operación `GetUtterancesView` se eliminan una vez transcurridos 15 días.

Esta operación necesita permisos para la acción `lex:DeleteUtterances`.

## Sintaxis de la solicitud
<a name="API_DeleteUtterances_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteUtterances_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [botName](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-botName"></a>
El nombre del bot que ha almacenado los enunciados.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [userId](#API_DeleteUtterances_RequestSyntax) **   <a name="lex-DeleteUtterances-request-uri-userId"></a>
 El identificador único del usuario que ha hecho los enunciados. Este es el ID de usuario que se envió en la solicitud de [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)operación [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)o que contenía el enunciado.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 100 caracteres.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteUtterances_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteUtterances_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteUtterances_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_DeleteUtterances_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/DeleteUtterances) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/DeleteUtterances) 

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

Devuelve información sobre los metadatos de un bot específico. Debe proporcionar el nombre del bot y la versión del bot o el alias. 

 Esta operación necesita permisos para la acción `lex:GetBot`. 

## Sintaxis de la solicitud
<a name="API_GetBot_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBot_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-name"></a>
El nombre del bot. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [versionoralias](#API_GetBot_RequestSyntax) **   <a name="lex-GetBot-request-uri-versionOrAlias"></a>
La versión o el alias del bot.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetBot_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetBot_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [abortStatement](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-abortStatement"></a>
El mensaje que Amazon Lex devuelve cuando el usuario elige acabar con la conversación sin completarla. Para obtener más información, consulte [PutBot](API_PutBot.md).  
Tipo: objeto [Statement](API_Statement.md)

 ** [checksum](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-checksum"></a>
La suma de comprobación del bot que se utiliza para identificar una revisión específica de la versión `$LATEST` del bot.  
Tipo: cadena

 ** [childDirected](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-childDirected"></a>
Para cada bot de Amazon Lex creado con el Servicio de creación de modelos de Amazon Lex, debe especificar si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que esté dirigido, total o parcialmente, a niños menores de 13 años y esté sujeto a la Ley de protección de la privacidad infantil en línea (COPPA, por sus siglas en inglés). Para ello, especifique `true` o `false` en el campo `childDirected`. Al especificar `true` en el campo `childDirected`, confirma que el uso de Amazon Lex **está** relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. Al especificar `false` en el campo `childDirected`, confirma que el uso de Amazon Lex **no está** relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. No puede especificar un valor predeterminado en el campo `childDirected` que no indique de forma precisa si el uso de Amazon Lex está relacionado o no con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA.  
Si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años, debe obtener un consentimiento parental verificable, obligatorio en virtud de la COPPA. Para obtener información acerca del uso de Amazon Lex con relación a sitios web, programas u otras aplicaciones dirigidos, total o parcialmente, a niños menores de 13 años, consulte las [Preguntas frecuentes de Amazon Lex](https://aws.amazon.com/lex/faqs#data-security).   
Tipo: Booleano

 ** [clarificationPrompt](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-clarificationPrompt"></a>
El mensaje que utiliza Amazon Lex cuando no entiende la solicitud del usuario. Para obtener más información, consulte [PutBot](API_PutBot.md).   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-createdDate"></a>
La fecha de creación del bot.  
Tipo: marca temporal

 ** [description](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-description"></a>
La descripción del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [detectSentiment](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-detectSentiment"></a>
Indica si los enunciados del usuario deben enviarse a Amazon Comprehend con fines de análisis de opiniones.  
Tipo: Booleano

 ** [enableModelImprovements](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-enableModelImprovements"></a>
Indica si el bot utiliza mejoras en la precisión. `true` indica que el bot utiliza las mejoras y `false`, lo contrario.  
Tipo: Booleano

 ** [failureReason](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-failureReason"></a>
Si `status` es `FAILED`, Amazon Lex explica por qué no se ha podido crear el bot.  
Tipo: cadena

 ** [idleSessionTTLInSeconds](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-idleSessionTTLInSeconds"></a>
El tiempo máximo que Amazon Lex retiene los datos recopilados en una conversación, en segundos. Para obtener más información, consulte [PutBot](API_PutBot.md).  
Tipo: entero  
Rango válido: valor mínimo de 60. Valor máximo de 86 400.

 ** [intents](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-intents"></a>
Una matriz de objetos `intent`. Para obtener más información, consulte [PutBot](API_PutBot.md).  
Tipo: matriz de objetos [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-lastUpdatedDate"></a>
La fecha de actualización del bot. Cuando se crea un recurso, la fecha de creación y la fecha de la última actualización son la misma.   
Tipo: marca temporal

 ** [locale](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-locale"></a>
 La configuración regional de destino para el bot.   
Tipo: cadena  
Valores válidos: `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>
El nombre del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [nluIntentConfidenceThreshold](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-nluIntentConfidenceThreshold"></a>
La puntuación que determina dónde inserta Amazon Lex `AMAZON.FallbackIntent``AMAZON.KendraSearchIntent`, o ambas, al devolver intenciones alternativas en una [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)respuesta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)o. `AMAZON.FallbackIntent`se inserta si la puntuación de confianza de todos los intentos está por debajo de este valor. `AMAZON.KendraSearchIntent`solo se inserta si está configurado para el bot.  
Tipo: Doble  
Rango válido: valor mínimo de 0. El valor máximo es de 1.

 ** [status](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-status"></a>
El estado del bot.   
Cuando el estado es `BUILDING`, Amazon Lex está creando el bot para probarlo y usarlo.  
Si el estado del bot es `READY_BASIC_TESTING`, puede probar el bot con los enunciados exactos que se especifican en las intenciones del bot. Cuando el bot está listo para probarse definitivamente o para ejecutarse, el estado es `READY`.  
Si ha habido un problema al crear el bot, el estado es `FAILED` y en el campo `failureReason` se explica por qué no se ha compilado el bot.  
Si el bot se ha guardado sin compilar, el estado es `NOT_BUILT`.  
Tipo: cadena  
Valores válidos: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-version"></a>
La versión del bot. En el caso de un bot nuevo, la versión es siempre `$LATEST`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_GetBot_ResponseSyntax) **   <a name="lex-GetBot-response-voiceId"></a>
El ID de voz de Amazon Polly que Amazon Lex utiliza para la interacción de voz con el usuario. Para obtener más información, consulte [PutBot](API_PutBot.md).  
Tipo: cadena

## Errores
<a name="API_GetBot_Errors"></a>

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetBot_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBot) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBot) 

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

Devuelve información sobre un alias de bot de Amazon Lex. Para obtener más información acerca de los alias, consulte [Control de versiones y alias](versioning-aliases.md).

Esta operación necesita permisos para la acción `lex:GetBotAlias`.

## Sintaxis de la solicitud
<a name="API_GetBotAlias_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBotAlias_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [botName](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-botName"></a>
El nombre del bot.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [name](#API_GetBotAlias_RequestSyntax) **   <a name="lex-GetBotAlias-request-uri-name"></a>
El nombre del alias del bot. El nombre distingue entre mayúsculas y minúsculas.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetBotAlias_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetBotAlias_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [botName](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botName"></a>
El nombre del bot al que apunta el alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [botVersion](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-botVersion"></a>
La versión del bot a la que apunta el alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

 ** [checksum](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-checksum"></a>
La suma de comprobación del alias del bot.  
Tipo: cadena

 ** [conversationLogs](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-conversationLogs"></a>
La configuración que determina cómo Amazon Lex utiliza los registros de conversaciones para el alias.  
Tipo: objeto [ConversationLogsResponse](API_ConversationLogsResponse.md)

 ** [createdDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-createdDate"></a>
La fecha de creación del alias del bot.  
Tipo: marca temporal

 ** [description](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-description"></a>
Una descripción del alias del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [lastUpdatedDate](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-lastUpdatedDate"></a>
La fecha de actualización del alias del bot. Al crear un recurso, la fecha de creación y la fecha de la última actualización son la misma.  
Tipo: marca temporal

 ** [name](#API_GetBotAlias_ResponseSyntax) **   <a name="lex-GetBotAlias-response-name"></a>
El nombre del alias del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetBotAlias_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAlias) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAlias) 

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

Devuelve una lista de alias para un bot especificado de Amazon Lex.

Esta operación necesita permisos para la acción `lex:GetBotAliases`.

## Sintaxis de la solicitud
<a name="API_GetBotAliases_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBotAliases_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [botName](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-botName"></a>
El nombre del bot.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [maxResults](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-maxResults"></a>
El número máximo de alias que se devuelven en una respuesta. El valor predeterminado es 50.   
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nameContains"></a>
La subcadena que debe coincidir con los nombres de alias del bot. Se devolverá un alias si alguna parte del nombre coincide con la subcadena. Por ejemplo, “xyz” coincide con “xyzabc” y “abcxyz”.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotAliases_RequestSyntax) **   <a name="lex-GetBotAliases-request-uri-nextToken"></a>
Un token de paginación para obtener la siguiente página de alias. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de alias, especifique el token de paginación en la siguiente solicitud. 

## Cuerpo de la solicitud
<a name="API_GetBotAliases_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetBotAliases_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [BotAliases](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-BotAliases"></a>
Una matriz de objetos `BotAliasMetadata` en la que cada uno describe un alias de bot.  
Tipo: matriz de objetos [BotAliasMetadata](API_BotAliasMetadata.md)

 ** [nextToken](#API_GetBotAliases_ResponseSyntax) **   <a name="lex-GetBotAliases-response-nextToken"></a>
Un token de paginación para obtener la siguiente página de alias. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de alias, especifique el token de paginación en la siguiente solicitud.   
Tipo: cadena

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

## Véase también
<a name="API_GetBotAliases_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotAliases) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotAliases) 

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

Devuelve información sobre la asociación entre un bot de Amazon Lex y una plataforma de mensajería.

Esta operación necesita permisos para la acción `lex:GetBotChannelAssociation`.

## Sintaxis de la solicitud
<a name="API_GetBotChannelAssociation_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBotChannelAssociation_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [aliasName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botAlias"></a>
Un alias que apunta a la versión exacta del bot de Amazon Lex al que se vincula esta asociación.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [botName](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-botName"></a>
El nombre del bot de Amazon Lex.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [name](#API_GetBotChannelAssociation_RequestSyntax) **   <a name="lex-GetBotChannelAssociation-request-uri-name"></a>
El nombre de la asociación entre el bot y el canal. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetBotChannelAssociation_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetBotChannelAssociation_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [botAlias](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botAlias"></a>
Un alias que apunta a la versión exacta del bot de Amazon Lex al que se vincula esta asociación.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [botConfiguration](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botConfiguration"></a>
Proporciona la información que necesita la plataforma de mensajería para comunicarse con el bot de Amazon Lex.  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 10 elementos.

 ** [botName](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-botName"></a>
El nombre del bot de Amazon Lex.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [createdDate](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-createdDate"></a>
La fecha en que se creó la asociación entre el bot y el canal.  
Tipo: marca temporal

 ** [description](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-description"></a>
Una descripción de la asociación entre el bot y el canal.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [failureReason](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-failureReason"></a>
Si `status` es `FAILED`, Amazon Lex proporciona el motivo por el que no se ha podido crear la asociación.  
Tipo: cadena

 ** [name](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-name"></a>
El nombre de la asociación entre el bot y el canal.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [status](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-status"></a>
El estado del canal del bot.   
+  `CREATED`: el canal se ha creado y está listo para usarse.
+  `IN_PROGRESS`: el canal se está creando.
+  `FAILED`: se ha producido un error al crear el canal. Para obtener información acerca del motivo del error, consulte el campo `failureReason`.
Tipo: cadena  
Valores válidos: `IN_PROGRESS | CREATED | FAILED` 

 ** [type](#API_GetBotChannelAssociation_ResponseSyntax) **   <a name="lex-GetBotChannelAssociation-response-type"></a>
El tipo de plataforma de mensajería.  
Tipo: cadena  
Valores válidos: `Facebook | Slack | Twilio-Sms | Kik` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetBotChannelAssociation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociation) 

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

 Devuelve una lista de todos los canales asociados con el bot especificado. 

La operación `GetBotChannelAssociations` necesita permisos para la acción `lex:GetBotChannelAssociations`.

## Sintaxis de la solicitud
<a name="API_GetBotChannelAssociations_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBotChannelAssociations_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [aliasName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botAlias"></a>
Un alias que apunta a la versión exacta del bot de Amazon Lex al que se vincula esta asociación.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^(-|^([A-Za-z]_?)+$)$`   
Obligatorio: sí

 ** [botName](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-botName"></a>
El nombre del bot de Amazon Lex en la asociación.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [maxResults](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-maxResults"></a>
El número máximo de asociaciones que se devuelven en una respuesta. El valor predeterminado es 50.   
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nameContains"></a>
La subcadena que debe coincidir con los nombres de asociaciones de canal. Se devolverá una asociación si alguna parte del nombre coincide con la subcadena. Por ejemplo, “xyz” coincide con “xyzabc” y “abcxyz”. Para mostrar todas las asociaciones de canales de bots, utilice un guion (“-”) como parámetro `nameContains`.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBotChannelAssociations_RequestSyntax) **   <a name="lex-GetBotChannelAssociations-request-uri-nextToken"></a>
Un token de paginación para obtener la siguiente página de asociaciones. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de asociaciones, especifique el token de paginación en la siguiente solicitud. 

## Cuerpo de la solicitud
<a name="API_GetBotChannelAssociations_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetBotChannelAssociations_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [botChannelAssociations](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-botChannelAssociations"></a>
Una matriz de objetos, uno para cada asociación, que proporciona información acerca del bot de Amazon Lex y su asociación con el canal.   
Tipo: matriz de objetos [BotChannelAssociation](API_BotChannelAssociation.md)

 ** [nextToken](#API_GetBotChannelAssociations_ResponseSyntax) **   <a name="lex-GetBotChannelAssociations-response-nextToken"></a>
Un token de paginación que obtiene la siguiente página de asociaciones. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de asociaciones, especifique el token de paginación en la siguiente solicitud.   
Tipo: cadena

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

## Véase también
<a name="API_GetBotChannelAssociations_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotChannelAssociations) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotChannelAssociations) 

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

Devuelve información del bot de la siguiente forma: 
+ Si proporciona el campo `nameContains`, la respuesta incluye información sobre la versión `$LATEST` de todos los bots cuyo nombre contiene la cadena especificada.
+ Si no especifica el campo `nameContains`, la operación devuelve información sobre la versión `$LATEST` de todos los bots.

Esta operación necesita permiso para la acción `lex:GetBots`.

## Sintaxis de la solicitud
<a name="API_GetBots_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBots_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [maxResults](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-maxResults"></a>
El número máximo de bots que se devuelve en la respuesta de la solicitud. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nameContains"></a>
La subcadena que debe coincidir con los nombres de bots. Se devolverá un bot si alguna parte del nombre coincide con la subcadena. Por ejemplo, “xyz” coincide con “xyzabc” y “abcxyz”.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetBots_RequestSyntax) **   <a name="lex-GetBots-request-uri-nextToken"></a>
Un token de paginación que obtiene la siguiente página de bots. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de bots, especifique el token de paginación en la siguiente solicitud. 

## Cuerpo de la solicitud
<a name="API_GetBots_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetBots_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [bots](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-bots"></a>
Una matriz de objetos `botMetadata`, con una entrada para cada bot.   
Tipo: matriz de objetos [BotMetadata](API_BotMetadata.md)

 ** [nextToken](#API_GetBots_ResponseSyntax) **   <a name="lex-GetBots-response-nextToken"></a>
Si la respuesta está truncada, incluye un token de paginación que puede especificar en su próxima solicitud para obtener la siguiente página de bots.   
Tipo: cadena

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetBots_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBots) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBots) 

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

Obtiene información sobre todas las versiones de un bot.

La operación `GetBotVersions` devuelve un objeto `BotMetadata` para cada versión de un bot. Por ejemplo, si un bot tiene tres versiones numeradas, la operación `GetBotVersions` devuelve cuatro objetos `BotMetadata` en la respuesta, uno para cada versión numerada y uno para la versión `$LATEST`. 

La operación `GetBotVersions` siempre devuelve al menos una versión, la versión `$LATEST`.

Esta operación necesita permisos para la acción `lex:GetBotVersions`.

## Sintaxis de la solicitud
<a name="API_GetBotVersions_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBotVersions_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [maxResults](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-maxResults"></a>
El número máximo de versiones del bot que se devuelven en la respuesta. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [name](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-name"></a>
El nombre del bot del que deben devolverse las versiones.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [nextToken](#API_GetBotVersions_RequestSyntax) **   <a name="lex-GetBotVersions-request-uri-nextToken"></a>
Un token de paginación para obtener la siguiente página de versiones del bot. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de versiones, especifique el token de paginación en la siguiente solicitud. 

## Cuerpo de la solicitud
<a name="API_GetBotVersions_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetBotVersions_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [bots](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-bots"></a>
Una matriz de objetos `BotMetadata`, uno para cada versión numerada del bot, así como uno para la versión `$LATEST`.  
Tipo: matriz de objetos [BotMetadata](API_BotMetadata.md)

 ** [nextToken](#API_GetBotVersions_ResponseSyntax) **   <a name="lex-GetBotVersions-response-nextToken"></a>
Un token de paginación para obtener la siguiente página de versiones del bot. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de versiones, especifique el token de paginación en la siguiente solicitud.   
Tipo: cadena

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetBotVersions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBotVersions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBotVersions) 

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

Devuelve información sobre una intención integrada.

Esta operación necesita permiso para la acción `lex:GetBuiltinIntent`.

## Sintaxis de la solicitud
<a name="API_GetBuiltinIntent_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBuiltinIntent_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [signature](#API_GetBuiltinIntent_RequestSyntax) **   <a name="lex-GetBuiltinIntent-request-uri-signature"></a>
Un identificador único para una intención integrada. Para encontrar la firma de una intención, consulte [Intenciones integradas estándar](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) en *Alexa Skills Kit*.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetBuiltinIntent_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetBuiltinIntent_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_GetBuiltinIntent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [signature](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-signature"></a>
Un identificador único para una intención integrada.  
Tipo: cadena

 ** [slots](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-slots"></a>
Una matriz de objetos `BuiltinIntentSlot`, con una entrada para cada tipo de ranura en la intención.  
Tipo: matriz de objetos [BuiltinIntentSlot](API_BuiltinIntentSlot.md)

 ** [supportedLocales](#API_GetBuiltinIntent_ResponseSyntax) **   <a name="lex-GetBuiltinIntent-response-supportedLocales"></a>
Una lista con las configuraciones regionales que admite la intención.  
Tipo: matriz de cadenas  
Valores válidos: `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` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetBuiltinIntent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntent) 

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

Obtiene una lista de las intenciones integradas que cumplen los criterios especificados.

Esta operación necesita permiso para la acción `lex:GetBuiltinIntents`.

## Sintaxis de la solicitud
<a name="API_GetBuiltinIntents_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBuiltinIntents_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [locale](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-locale"></a>
Una lista con las configuraciones regionales que admite la intención.  
Valores válidos: `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>
El número máximo de intenciones que se devuelven en la respuesta. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [nextToken](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-nextToken"></a>
Un token de paginación que obtiene la siguiente página de intenciones. Si esta llamada a la API está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de intenciones, utilice el token de paginación en la siguiente solicitud.

 ** [signatureContains](#API_GetBuiltinIntents_RequestSyntax) **   <a name="lex-GetBuiltinIntents-request-uri-signatureContains"></a>
La subcadena que debe coincidir con las firmas de intenciones integradas. Se devolverá una intención si alguna parte de su firma coincide con la subcadena. Por ejemplo, “xyz” coincide con “xyzabc” y “abcxyz”. Para encontrar la firma de una intención, consulte [Intenciones integradas estándar](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) en *Alexa Skills Kit*.

## Cuerpo de la solicitud
<a name="API_GetBuiltinIntents_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetBuiltinIntents_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_GetBuiltinIntents_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [intents](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-intents"></a>
Una matriz de objetos `builtinIntentMetadata`, uno para cada intención en la respuesta.  
Tipo: matriz de objetos [BuiltinIntentMetadata](API_BuiltinIntentMetadata.md)

 ** [nextToken](#API_GetBuiltinIntents_ResponseSyntax) **   <a name="lex-GetBuiltinIntents-response-nextToken"></a>
Un token de paginación que obtiene la siguiente página de intenciones. Si la respuesta a esta llamada a la API está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de intenciones, especifique el token de paginación en la siguiente solicitud.  
Tipo: cadena

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

## Véase también
<a name="API_GetBuiltinIntents_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinIntents) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinIntents) 

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

Obtiene una lista de tipos de ranura integrados que cumplen los criterios especificados.

Para obtener una lista con los tipos de ranura integrados, consulte [Referencia del tipo de ranura](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) en *Alexa Skills Kit*.

Esta operación necesita permiso para la acción `lex:GetBuiltInSlotTypes`.

## Sintaxis de la solicitud
<a name="API_GetBuiltinSlotTypes_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetBuiltinSlotTypes_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [locale](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-locale"></a>
Una lista con las configuraciones regionales que admite el tipo de ranura.  
Valores válidos: `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>
El número máximo de tipos de ranura que se devuelven en la respuesta. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [nextToken](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-nextToken"></a>
Un token de paginación que obtiene la siguiente página de tipos de ranura. Si la respuesta a esta llamada a la API está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de tipos de ranura, especifique el token de paginación en la siguiente solicitud.

 ** [signatureContains](#API_GetBuiltinSlotTypes_RequestSyntax) **   <a name="lex-GetBuiltinSlotTypes-request-uri-signatureContains"></a>
La subcadena que debe coincidir con las firmas de tipos de ranura integrados. Se devolverá un tipo de ranura si alguna parte de su firma coincide con la subcadena. Por ejemplo, “xyz” coincide con “xyzabc” y “abcxyz”.

## Cuerpo de la solicitud
<a name="API_GetBuiltinSlotTypes_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetBuiltinSlotTypes_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_GetBuiltinSlotTypes_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [nextToken](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-nextToken"></a>
Si la respuesta está truncada, la respuesta incluye un token de paginación que puede utilizar en su próxima solicitud para obtener la siguiente página de tipos de ranura.  
Tipo: cadena

 ** [slotTypes](#API_GetBuiltinSlotTypes_ResponseSyntax) **   <a name="lex-GetBuiltinSlotTypes-response-slotTypes"></a>
Una matriz de objetos `BuiltInSlotTypeMetadata`, con una entrada para cada tipo de ranura devuelto.  
Tipo: matriz de objetos [BuiltinSlotTypeMetadata](API_BuiltinSlotTypeMetadata.md)

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

## Véase también
<a name="API_GetBuiltinSlotTypes_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetBuiltinSlotTypes) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetBuiltinSlotTypes) 

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

Exporta el contenido de un recurso de Amazon Lex en un formato específico. 

## Sintaxis de la solicitud
<a name="API_GetExport_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetExport_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [exportType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-exportType"></a>
El formato de los datos exportados.  
Valores válidos: `ALEXA_SKILLS_KIT | LEX`   
Obligatorio: sí

 ** [name](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-name"></a>
El nombre del bot que se va a exportar.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z_]+`   
Obligatorio: sí

 ** [resourceType](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-resourceType"></a>
El tipo de recurso que se va a exportar.   
Valores válidos: `BOT | INTENT | SLOT_TYPE`   
Obligatorio: sí

 ** [version](#API_GetExport_RequestSyntax) **   <a name="lex-GetExport-request-uri-version"></a>
La versión del bot que se va a exportar.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[0-9]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetExport_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetExport_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [exportStatus](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportStatus"></a>
El estado de la exportación.   
+  `IN_PROGRESS`: la exportación está en curso.
+  `READY`: la exportación ha finalizado.
+  `FAILED`: no se ha podido completar la exportación.
Tipo: cadena  
Valores válidos: `IN_PROGRESS | READY | FAILED` 

 ** [exportType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-exportType"></a>
El formato de los datos exportados.  
Tipo: cadena  
Valores válidos: `ALEXA_SKILLS_KIT | LEX` 

 ** [failureReason](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-failureReason"></a>
Si `status` es `FAILED`, Amazon Lex proporciona el motivo por el que no se ha podido exportar el recurso.  
Tipo: cadena

 ** [name](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-name"></a>
El nombre del bot que se está exportando.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z_]+` 

 ** [resourceType](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-resourceType"></a>
El tipo del recurso exportado.  
Tipo: cadena  
Valores válidos: `BOT | INTENT | SLOT_TYPE` 

 ** [url](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-url"></a>
Una dirección URL prefirmada de S3 que proporciona la ubicación del recurso exportado. El recurso exportado es un archivo ZIP que contiene el recurso exportado en formato JSON. La estructura del archivo puede cambiar. El código no tiene que depender de la estructura del archivo.  
Tipo: cadena

 ** [version](#API_GetExport_ResponseSyntax) **   <a name="lex-GetExport-response-version"></a>
La versión del bot que se está exportando.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[0-9]+` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetExport_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetExport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetExport) 

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

Obtiene información sobre un trabajo de importación iniciado con la operación `StartImport`.

## Sintaxis de la solicitud
<a name="API_GetImport_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetImport_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [importId](#API_GetImport_RequestSyntax) **   <a name="lex-GetImport-request-uri-importId"></a>
El identificador de la información del trabajo de importación que se va a devolver.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetImport_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetImport_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [createdDate](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-createdDate"></a>
Una marca de tiempo para la fecha y hora en la que se creó el trabajo de importación.  
Tipo: marca temporal

 ** [failureReason](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-failureReason"></a>
Una cadena que describe el motivo por el que no se ha completado un trabajo de importación.  
Tipo: matriz de cadenas

 ** [importId](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importId"></a>
El identificador de un trabajo de importación específico.  
Tipo: cadena

 ** [importStatus](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-importStatus"></a>
El estado del trabajo de importación. Si el estado es `FAILED`, puede consultar el motivo del fallo en el campo `failureReason`.  
Tipo: cadena  
Valores válidos: `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-mergeStrategy"></a>
La acción que se llevó a cabo cuando se produjo un conflicto entre un recurso existente y un recurso del archivo de importación.  
Tipo: cadena  
Valores válidos: `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-name"></a>
El nombre asignado al trabajo de importación.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z_]+` 

 ** [resourceType](#API_GetImport_ResponseSyntax) **   <a name="lex-GetImport-response-resourceType"></a>
El tipo de recurso importado.  
Tipo: cadena  
Valores válidos: `BOT | INTENT | SLOT_TYPE` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetImport_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetImport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetImport) 

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

 Devuelve información sobre una intención. Además del nombre de la intención, debe especificar la versión de la intención. 

 Esto operación requiere permisos para realizar la acción `lex:GetIntent`. 

## Sintaxis de la solicitud
<a name="API_GetIntent_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetIntent_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-name"></a>
El nombre de la intención. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [version](#API_GetIntent_RequestSyntax) **   <a name="lex-GetIntent-request-uri-version"></a>
La versión de la intención.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetIntent_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetIntent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [checksum](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-checksum"></a>
La suma de comprobación de la intención.  
Tipo: cadena

 ** [conclusionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-conclusionStatement"></a>
Una vez que la función de Lambda especificada en el elemento `fulfillmentActivity` cumple con la intención, Amazon Lex transmite esta afirmación al usuario.  
Tipo: objeto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-confirmationPrompt"></a>
Si se define en el bot, la solicitud que Amazon Lex utiliza para confirmar la intención del usuario antes de cumplirla. Para obtener más información, consulte [PutIntent](API_PutIntent.md).   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-createdDate"></a>
La fecha en que se creó la intención.  
Tipo: marca temporal

 ** [description](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-description"></a>
Una descripción de la intención.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [dialogCodeHook](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-dialogCodeHook"></a>
Si se define en el bot, Amazon Lex invoca esta función de Lambda para cada entrada del usuario. Para obtener más información, consulte [PutIntent](API_PutIntent.md).   
Tipo: objeto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-followUpPrompt"></a>
Si se define en el bot, Amazon Lex utiliza esta solicitud para solicitar actividad adicional del usuario una vez que se ha cumplido con la intención. Para obtener más información, consulte [PutIntent](API_PutIntent.md).  
Tipo: objeto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-fulfillmentActivity"></a>
Describe cómo se cumple con la intención. Para obtener más información, consulte [PutIntent](API_PutIntent.md).   
Tipo: objeto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-inputContexts"></a>
Una matriz de objetos `InputContext` que enumera los contextos que deben estar activos para que Amazon Lex elija la intención en una conversación con el usuario.  
Tipo: matriz de objetos [InputContext](API_InputContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 5 artículos.

 ** [kendraConfiguration](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-kendraConfiguration"></a>
Información sobre la configuración necesaria, si procede, para conectar un índice de Amazon Kendra con la intención `AMAZON.KendraSearchIntent`.  
Tipo: objeto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-lastUpdatedDate"></a>
La fecha de actualización de la intención. Al crear un recurso, la fecha de creación y la fecha de la última actualización son la misma.   
Tipo: marca temporal

 ** [name](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-name"></a>
El nombre de la intención.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-outputContexts"></a>
Una matriz de objetos `OutputContext` que enumera los contextos en los que la intención se activa cuando esta se cumple.  
Tipo: matriz de objetos [OutputContext](API_OutputContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.

 ** [parentIntentSignature](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-parentIntentSignature"></a>
Un identificador único para una intención integrada.  
Tipo: cadena

 ** [rejectionStatement](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-rejectionStatement"></a>
Si el usuario responde “no” a la pregunta definida en `confirmationPrompt`, Amazon Lex responde con esta afirmación para confirmar que la intención se ha cancelado.   
Tipo: objeto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-sampleUtterances"></a>
Una matriz de ejemplos de enunciados configurados para la intención.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 1500 elementos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.

 ** [slots](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-slots"></a>
Una matriz de ranuras de intención configuradas para la intención.  
Tipo: matriz de objetos [Slot](API_Slot.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 100 artículos.

 ** [version](#API_GetIntent_ResponseSyntax) **   <a name="lex-GetIntent-response-version"></a>
La versión de la intención.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetIntent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntent) 

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

Devuelve información de la intención de la siguiente forma: 
+ Si especifica el campo `nameContains`, devuelve la versión `$LATEST` de todas las intenciones que contienen la cadena especificada.
+  Si no especifica el campo `nameContains`, devuelve información sobre la versión `$LATEST` de todas las intenciones. 

 La operación necesita permisos para la acción `lex:GetIntents`. 

## Sintaxis de la solicitud
<a name="API_GetIntents_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetIntents_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [maxResults](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-maxResults"></a>
El número máximo de intenciones que se devuelven en la respuesta. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nameContains"></a>
La subcadena que debe coincidir con los nombres de intenciones. Se devolverá una intención si alguna parte del nombre coincide con la subcadena. Por ejemplo, “xyz” coincide con “xyzabc” y “abcxyz”.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetIntents_RequestSyntax) **   <a name="lex-GetIntents-request-uri-nextToken"></a>
Un token de paginación que obtiene la siguiente página de intenciones. Si la respuesta a esta llamada a la API está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de intenciones, especifique el token de paginación en la siguiente solicitud. 

## Cuerpo de la solicitud
<a name="API_GetIntents_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetIntents_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [intents](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-intents"></a>
Una matriz de objetos `Intent`. Para obtener más información, consulte [PutBot](API_PutBot.md).  
Tipo: matriz de objetos [IntentMetadata](API_IntentMetadata.md)

 ** [nextToken](#API_GetIntents_ResponseSyntax) **   <a name="lex-GetIntents-response-nextToken"></a>
Si la respuesta está truncada, la respuesta incluye un token de paginación que puede especificar en su próxima solicitud para obtener la siguiente página de intenciones.   
Tipo: cadena

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetIntents_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntents) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntents) 

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

Obtiene información sobre todas las versiones de una intención.

La operación `GetIntentVersions` devuelve un objeto `IntentMetadata` para cada versión de una intención. Por ejemplo, si una intención tiene tres versiones numeradas, la operación `GetIntentVersions` devuelve cuatro objetos `IntentMetadata` en la respuesta, uno para cada versión numerada y uno para la versión `$LATEST`. 

La operación `GetIntentVersions` siempre devuelve al menos una versión, la versión `$LATEST`.

Esta operación necesita permisos para la acción `lex:GetIntentVersions`.

## Sintaxis de la solicitud
<a name="API_GetIntentVersions_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetIntentVersions_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [maxResults](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-maxResults"></a>
El número máximo de versiones de la intención que se devuelven en la respuesta. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [name](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-name"></a>
El nombre de la intención de la que deben devolverse las versiones.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [nextToken](#API_GetIntentVersions_RequestSyntax) **   <a name="lex-GetIntentVersions-request-uri-nextToken"></a>
Un token de paginación para obtener la siguiente página de versiones de la intención. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de versiones, especifique el token de paginación en la siguiente solicitud. 

## Cuerpo de la solicitud
<a name="API_GetIntentVersions_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetIntentVersions_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [intents](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-intents"></a>
Una matriz de objetos `IntentMetadata`, uno para cada versión numerada de la intención, así como uno para la versión `$LATEST`.  
Tipo: matriz de objetos [IntentMetadata](API_IntentMetadata.md)

 ** [nextToken](#API_GetIntentVersions_ResponseSyntax) **   <a name="lex-GetIntentVersions-response-nextToken"></a>
Un token de paginación para obtener la siguiente página de versiones de la intención. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de versiones, especifique el token de paginación en la siguiente solicitud.   
Tipo: cadena

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetIntentVersions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetIntentVersions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetIntentVersions) 

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

Proporciona información acerca de una migración en curso o finalizada de un bot de Amazon Lex V1 a un bot de Amazon Lex V2. Utilice esta operación para ver las alertas y los avisos relacionados con la migración.

## Sintaxis de la solicitud
<a name="API_GetMigration_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetMigration_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [migrationId](#API_GetMigration_RequestSyntax) **   <a name="lex-GetMigration-request-uri-migrationId"></a>
El identificador único de la migración que se consulta. `migrationID` lo devuelve la operación [StartMigration](API_StartMigration.md).  
Limitaciones de longitud: longitud fija de 10.  
Patrón: `^[0-9a-zA-Z]+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetMigration_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetMigration_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [alerts](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-alerts"></a>
Una lista de alertas y advertencias que indican problemas con la migración de un bot de Amazon Lex V1 a Amazon Lex V2. Recibirá una advertencia cuando una característica de Amazon Lex V1 se implemente de forma distinta en Amazon Lex V2.  
Para obtener más información, consulte [Migración de un bot](https://docs.aws.amazon.com/lexv2/latest/dg/migrate.html) en la *Guía para desarrolladores de Amazon Lex V2*.  
Tipo: matriz de objetos [MigrationAlert](API_MigrationAlert.md)

 ** [migrationId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationId"></a>
El identificador único de la migración. Es el mismo identificador que se utiliza al llamar a la operación `GetMigration`.  
Tipo: cadena  
Limitaciones de longitud: longitud fija de 10.  
Patrón: `^[0-9a-zA-Z]+$` 

 ** [migrationStatus](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStatus"></a>
Indica el estado de la migración. Cuando el estado es `COMPLETE`, la migración ha finalizado y el bot está disponible en Amazon Lex V2. Es posible que haya alertas y advertencias que deban resolverse antes de completar la migración.  
Tipo: cadena  
Valores válidos: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [migrationStrategy](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationStrategy"></a>
La estrategia empleada para llevar a cabo la migración.  
+  `CREATE_NEW`: crea un nuevo bot de Amazon Lex V2 y migra el bot de Amazon Lex V1 al nuevo bot.
+  `UPDATE_EXISTING`: sobrescribe los metadatos de un bot de Amazon Lex V2 y la configuración regional que se van a migrar. No cambia ninguna otra configuración regional del bot de Amazon Lex V2. Si la configuración regional no existe, se crea una nueva configuración regional en el bot de Amazon Lex V2.
Tipo: cadena  
Valores válidos: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-migrationTimestamp"></a>
La fecha y hora en que comenzó la migración.  
Tipo: marca temporal

 ** [v1BotLocale](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotLocale"></a>
La configuración regional del bot de Amazon Lex V1 migrado a Amazon Lex V2.  
Tipo: cadena  
Valores válidos: `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>
El nombre del bot de Amazon Lex V1 migrado a Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v1BotVersion"></a>
La versión del bot de Amazon Lex V1 migrado a Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotId"></a>
El identificador único del bot de Amazon Lex V2 al que se migra desde Amazon Lex V1.  
Tipo: cadena  
Limitaciones de longitud: longitud fija de 10.  
Patrón: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_GetMigration_ResponseSyntax) **   <a name="lex-GetMigration-response-v2BotRole"></a>
El rol de IAM que Amazon Lex utiliza para ejecutar el bot de Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 2048 caracteres.  
Patrón: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetMigration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigration) 

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

Obtiene una lista de las migraciones entre Amazon Lex V1 y Amazon Lex V2.

## Sintaxis de la solicitud
<a name="API_GetMigrations_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetMigrations_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [maxResults](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-maxResults"></a>
El número máximo de migraciones que se devuelven en la respuesta. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [migrationStatusEquals](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-migrationStatusEquals"></a>
Filtra la lista para que muestre solo las migraciones con el estado especificado.  
Valores válidos: `IN_PROGRESS | COMPLETED | FAILED` 

 ** [nextToken](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-nextToken"></a>
Un token de paginación que obtiene la siguiente página de migraciones. Si la respuesta a esta operación está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de migraciones, especifique el token de paginación en la solicitud.

 ** [sortByAttribute](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByAttribute"></a>
El campo de referencia para ordenar la lista de migraciones. Puede ordenar la lista por nombre de bot de Amazon Lex V1 o por la fecha y hora en que se inició la migración.  
Valores válidos: `V1_BOT_NAME | MIGRATION_DATE_TIME` 

 ** [sortByOrder](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-sortByOrder"></a>
El orden en el que se ordena la lista.  
Valores válidos: `ASCENDING | DESCENDING` 

 ** [v1BotNameContains](#API_GetMigrations_RequestSyntax) **   <a name="lex-GetMigrations-request-uri-v1BotNameContains"></a>
Filtra la lista para que muestre solo los bots cuyo nombre contiene la cadena especificada. La cadena debe coincidir con cualquier parte del nombre del bot.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

## Cuerpo de la solicitud
<a name="API_GetMigrations_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetMigrations_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [migrationSummaries](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-migrationSummaries"></a>
Una matriz de resúmenes para migraciones de Amazon Lex V1 a Amazon Lex V2. Para ver los detalles de la migración, consulte `migrationId` en el resumen de una llamada a la operación [GetMigration](API_GetMigration.md).  
Tipo: matriz de objetos [MigrationSummary](API_MigrationSummary.md)

 ** [nextToken](#API_GetMigrations_ResponseSyntax) **   <a name="lex-GetMigrations-response-nextToken"></a>
Si la respuesta está truncada, incluye un token de paginación que puede especificar en su próxima solicitud para obtener la siguiente página de migraciones.  
Tipo: cadena

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

## Véase también
<a name="API_GetMigrations_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetMigrations) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetMigrations) 

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

Devuelve información sobre una versión específica de un tipo de ranura. Además de especificar el nombre del tipo de ranura, debe especificar la versión del tipo de ranura.

Esta operación necesita permisos para la acción `lex:GetSlotType`.

## Sintaxis de la solicitud
<a name="API_GetSlotType_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetSlotType_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-name"></a>
El nombre del tipo de slot. El nombre distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [version](#API_GetSlotType_RequestSyntax) **   <a name="lex-GetSlotType-request-uri-version"></a>
La versión del tipo de ranura.   
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetSlotType_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetSlotType_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [checksum](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-checksum"></a>
La suma de comprobación de la versión `$LATEST` del tipo de ranura.  
Tipo: cadena

 ** [createdDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-createdDate"></a>
La fecha de creación del tipo de ranura.  
Tipo: marca temporal

 ** [description](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-description"></a>
Una descripción del tipo de slot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [enumerationValues](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-enumerationValues"></a>
Una lista de objetos `EnumerationValue` que define los valores que puede tomar el tipo de ranura.  
Tipo: matriz de objetos [EnumerationValue](API_EnumerationValue.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 10 000 elementos.

 ** [lastUpdatedDate](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-lastUpdatedDate"></a>
La fecha de actualización del tipo de ranura. Cuando se crea un recurso, la fecha de creación y la fecha de la última actualización son la misma.  
Tipo: marca temporal

 ** [name](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-name"></a>
El nombre del tipo de slot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-parentSlotTypeSignature"></a>
El tipo de ranura integrado que se utiliza como principal para este tipo de ranura.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-slotTypeConfigurations"></a>
Información sobre la configuración que amplía el tipo de ranura integrado principal.  
Tipo: matriz de objetos [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.

 ** [valueSelectionStrategy](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-valueSelectionStrategy"></a>
La estrategia que Amazon Lex utiliza para determinar el valor de la ranura. Para obtener más información, consulte [PutSlotType](API_PutSlotType.md).  
Tipo: cadena  
Valores válidos: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_GetSlotType_ResponseSyntax) **   <a name="lex-GetSlotType-response-version"></a>
La versión del tipo de ranura.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetSlotType_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotType) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotType) 

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

Devuelve información del tipo de ranura de la siguiente forma: 
+ Si especifica el campo `nameContains`, devuelve la versión `$LATEST` de todos los tipos de ranura que contienen la cadena especificada.
+  Si no especifica el campo `nameContains`, devuelve información sobre la versión `$LATEST` de todos los tipos de ranura. 

 La operación necesita permisos para la acción `lex:GetSlotTypes`. 

## Sintaxis de la solicitud
<a name="API_GetSlotTypes_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetSlotTypes_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [maxResults](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-maxResults"></a>
El número máximo de tipos de ranura que se devuelven en la respuesta. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [nameContains](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nameContains"></a>
La subcadena que debe coincidir con los nombres de tipos de ranura. Se devolverá un tipo de ranura si alguna parte del nombre coincide con la subcadena. Por ejemplo, “xyz” coincide con “xyzabc” y “abcxyz”.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [nextToken](#API_GetSlotTypes_RequestSyntax) **   <a name="lex-GetSlotTypes-request-uri-nextToken"></a>
Un token de paginación que obtiene la siguiente página de tipos de ranura. Si la respuesta a esta llamada a la API está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de tipos de ranura, especifique el token de paginación en la siguiente solicitud.

## Cuerpo de la solicitud
<a name="API_GetSlotTypes_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_GetSlotTypes_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [nextToken](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-nextToken"></a>
Si la respuesta está truncada, incluye un token de paginación que puede especificar en su próxima solicitud para obtener la siguiente página de tipos de ranura.  
Tipo: cadena

 ** [slotTypes](#API_GetSlotTypes_ResponseSyntax) **   <a name="lex-GetSlotTypes-response-slotTypes"></a>
Una matriz de objetos, uno para cada tipo de ranura, que proporciona datos como el nombre del tipo de ranura, la versión y una descripción.  
Tipo: matriz de objetos [SlotTypeMetadata](API_SlotTypeMetadata.md)

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetSlotTypes_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypes) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypes) 

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

Obtiene información sobre todas las versiones de un tipo de ranura.

La operación `GetSlotTypeVersions` devuelve un objeto `SlotTypeMetadata` para cada versión de un tipo de ranura. Por ejemplo, si un tipo de ranura tiene tres versiones numeradas, la operación `GetSlotTypeVersions` devuelve cuatro objetos `SlotTypeMetadata` en la respuesta, uno para cada versión numerada y uno para la versión `$LATEST`. 

La operación `GetSlotTypeVersions` siempre devuelve al menos una versión, la versión `$LATEST`.

Esta operación necesita permisos para la acción `lex:GetSlotTypeVersions`.

## Sintaxis de la solicitud
<a name="API_GetSlotTypeVersions_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetSlotTypeVersions_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [maxResults](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-maxResults"></a>
El número máximo de versiones de tipo de ranura que se devuelven en la respuesta. El valor predeterminado es 10.  
Rango válido: valor mínimo de 1. Valor máximo de 50.

 ** [name](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-name"></a>
El nombre del tipo de ranura del que deben devolverse las versiones.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [nextToken](#API_GetSlotTypeVersions_RequestSyntax) **   <a name="lex-GetSlotTypeVersions-request-uri-nextToken"></a>
Un token de paginación para obtener la siguiente página de versiones del tipo de ranura. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de versiones, especifique el token de paginación en la siguiente solicitud. 

## Cuerpo de la solicitud
<a name="API_GetSlotTypeVersions_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_GetSlotTypeVersions_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [nextToken](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-nextToken"></a>
Un token de paginación para obtener la siguiente página de versiones del tipo de ranura. Si la respuesta a esta llamada está truncada, Amazon Lex devuelve un token de paginación en la respuesta. Para obtener la siguiente página de versiones, especifique el token de paginación en la siguiente solicitud.   
Tipo: cadena

 ** [slotTypes](#API_GetSlotTypeVersions_ResponseSyntax) **   <a name="lex-GetSlotTypeVersions-response-slotTypes"></a>
Una matriz de objetos `SlotTypeMetadata`, uno para cada versión numerada del tipo de ranura, así como uno para la versión `$LATEST`.  
Tipo: matriz de objetos [SlotTypeMetadata](API_SlotTypeMetadata.md)

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetSlotTypeVersions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetSlotTypeVersions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetSlotTypeVersions) 

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

Utilice la operación `GetUtterancesView` para obtener información acerca de los enunciados que los usuarios han hecho al bot. Puede utilizar esta lista para ajustar los enunciados a los que responde el bot.

Por ejemplo, supongamos que ha creado un bot para pedir flores. Una vez haya transcurrido cierto tiempo y los usuarios hayan utilizado bastante el bot, utilice la operación `GetUtterancesView` para ver las solicitudes que han realizado y si el resultado ha sido satisfactorio. Es posible que el enunciado “Quiero flores” no se reconozca. Puede añadir este enunciado a la intención `OrderFlowers` para que el bot lo reconozca.

Después de publicar una nueva versión de un bot, puede obtener información acerca de la versión anterior y la nueva para comparar el rendimiento de ambas versiones. 

Las estadísticas de enunciados se generan una vez al día. Hay datos disponibles para los últimos 15 días. Puede solicitar información para un máximo de 5 versiones del bot en cada solicitud. Amazon Lex devuelve los enunciados más frecuentes que ha recibido el bot a lo largo de los últimos 15 días. La respuesta contiene información acerca de un máximo de 100 enunciados para cada versión.

Las estadísticas de los enunciados no se generan en las siguientes condiciones:
+ El `childDirected` campo estaba establecido en verdadero cuando se creó el bot.
+ Está utilizando la ofuscación de ranuras con una o más ranuras.
+ Ha optado por no participar en la mejora de Amazon Lex.

Esta operación necesita permisos para la acción `lex:GetUtterancesView`.

## Sintaxis de la solicitud
<a name="API_GetUtterancesView_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetUtterancesView_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [botname](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botName"></a>
El nombre del bot del que se devuelve información sobre enunciados.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [botVersions](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-botVersions"></a>
La matriz de las versiones del bot de las que se devuelve información sobre enunciados. El límite es de 5 versiones por solicitud.  
Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+`   
Obligatorio: sí

 ** [statusType](#API_GetUtterancesView_RequestSyntax) **   <a name="lex-GetUtterancesView-request-uri-statusType"></a>
Para devolver enunciados reconocidos y gestionados, utilice `Detected`. Para devolver enunciados no reconocidos, utilice `Missed`.  
Valores válidos: `Detected | Missed`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetUtterancesView_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
            }
         ]
      }
   ]
}
```

## Elementos de respuesta
<a name="API_GetUtterancesView_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [botName](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-botName"></a>
El nombre del bot del que se ha devuelto información sobre enunciados.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [utterances](#API_GetUtterancesView_ResponseSyntax) **   <a name="lex-GetUtterancesView-response-utterances"></a>
Una matriz de objetos [UtteranceList](API_UtteranceList.md), en la que cada objeto contiene una lista de objetos [UtteranceData](API_UtteranceData.md) que describen los enunciados que ha procesado el bot. La respuesta contiene un máximo de 100 objetos `UtteranceData` para cada versión. Amazon Lex devuelve los enunciados más frecuentes que ha recibido el bot a lo largo de los últimos 15 días.  
Tipo: matriz de objetos [UtteranceList](API_UtteranceList.md)

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

## Véase también
<a name="API_GetUtterancesView_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView) 

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

Obtiene una lista de las etiquetas asociadas a un recurso especificado. Solo bots, alias de bots y canales de bots tienen etiquetas asociadas.

## Sintaxis de la solicitud
<a name="API_ListTagsForResource_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_ListTagsForResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="lex-ListTagsForResource-request-uri-resourceArn"></a>
El nombre de recurso de Amazon (ARN) del recurso del que se obtiene una lista de etiquetas.  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 1011.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_ListTagsForResource_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListTagsForResource_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_ListTagsForResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="lex-ListTagsForResource-response-tags"></a>
Las etiquetas asociadas a un recurso.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

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

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_ListTagsForResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/ListTagsForResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/ListTagsForResource) 

# PutBot
<a name="API_PutBot"></a>

Crea un bot de conversación de Amazon Lex o sustituye un bot existente. Cuando crea o actualiza un bot, solo debe especificar un nombre, una configuración regional y si el bot está dirigido a niños menores de 13 años. Puede utilizar esta opción para agregar intenciones más adelante o para eliminarlas de un bot existente. Cuando crea un bot con la información mínima necesaria, el bot se crea o actualiza, pero Amazon Lex devuelve la respuesta ```FAILED`. Puede compilar el bot una vez que haya agregado uno o más intentos. Para obtener más información acerca de los bots de Amazon Lex, consulte [Funcionamiento de Amazon Lex](how-it-works.md). 

Si especifica el nombre de un bot existente, los campos de la solicitud reemplazan los valores existentes en la versión `$LATEST` del bot. Amazon Lex elimina todos los campos para los que no proporciona valores en la solicitud, excepto para los campos `idleTTLInSeconds` y `privacySettings`, que se establecen en sus valores predeterminados. Si no especifica valores para los campos obligatorios, Amazon Lex devuelve una excepción.

Esta operación necesita permisos para la acción `lex:PutBot`. Para obtener más información, consulte [Identity and Access Management para Amazon Lex](security-iam.md).

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de solicitud del URI
<a name="API_PutBot_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-uri-name"></a>
El nombre del bot. El nombre *no* distingue entre mayúsculas y minúsculas.   
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_PutBot_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [abortStatement](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-abortStatement"></a>
Cuando Amazon Lex no comprende la entrada del usuario en el contexto de la conversación, intenta obtener la información varias veces. A continuación, Amazon Lex envía el mensaje definido en `abortStatement` al usuario y cancela la conversación. Para establecer el número de reintentos, utilice el campo `valueElicitationPrompt` del tipo de ranura.   
Por ejemplo, en un bot de pedidos de pizza, Amazon Lex puede realizar una pregunta del estilo “¿Qué tipo de masa desea?”. Si la respuesta del usuario no es una de las respuestas esperadas (por ejemplo, “masa fina”, “base gruesa”, etc.), Amazon Lex intenta obtener una respuesta correcta varias veces.   
Por ejemplo, en una aplicación de pedidos de pizza, `OrderPizza` puede ser una de las intenciones. Esta intención puede requerir la ranura `CrustType`. El campo `valueElicitationPrompt` se especifica al crear la ranura `CrustType`.  
Si ha definido una intención alternativa, la afirmación de cancelación no se enviará al usuario y se utilizará la intención alternativa. Para obtener más información, consulte [AMAZON. FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html).  
Tipo: objeto [Statement](API_Statement.md)  
Obligatorio: no

 ** [checksum](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-checksum"></a>
Identifica una revisión específica de la versión `$LATEST`.  
Si crea un nuevo bot, deje el campo `checksum` vacío. Si especifica una suma de comprobación, obtendrá una excepción `BadRequestException`.  
Cuando quiera actualizar el bot, establezca el campo `checksum` en la suma de comprobación de la revisión más reciente de la versión `$LATEST`. Si no especifica el campo ` checksum` o si la suma de comprobación no coincide con la versión `$LATEST`, obtendrá una excepción `PreconditionFailedException`.  
Tipo: cadena  
Requerido: no

 ** [childDirected](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-childDirected"></a>
Para cada bot de Amazon Lex creado con el Servicio de creación de modelos de Amazon Lex, debe especificar si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que esté dirigido, total o parcialmente, a niños menores de 13 años y esté sujeto a la Ley de protección de la privacidad infantil en línea (COPPA, por sus siglas en inglés). Para ello, especifique `true` o `false` en el campo `childDirected`. Al especificar `true` en el campo `childDirected`, confirma que el uso de Amazon Lex **está** relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. Al especificar `false` en el campo `childDirected`, confirma que el uso de Amazon Lex **no está** relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. No puede especificar un valor predeterminado en el campo `childDirected` que no indique de forma precisa si el uso de Amazon Lex está relacionado o no con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA.  
Si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años, debe obtener un consentimiento parental verificable, obligatorio en virtud de la COPPA. Para obtener información acerca del uso de Amazon Lex con relación a sitios web, programas u otras aplicaciones dirigidos, total o parcialmente, a niños menores de 13 años, consulte las [Preguntas frecuentes de Amazon Lex](https://aws.amazon.com/lex/faqs#data-security).   
Tipo: Booleano  
Obligatorio: sí

 ** [clarificationPrompt](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-clarificationPrompt"></a>
Cuando Amazon Lex no comprende la intención del usuario, utiliza este mensaje para obtener una aclaración. Para especificar cuantas veces Amazon Lex debe repetir la pregunta aclaratoria, utilice el campo `maxAttempts`. Si Amazon Lex sigue sin comprender la intención, envía el mensaje del campo `abortStatement`.   
Cuando cree una pregunta aclaratoria, asegúrese de que sugiere una respuesta correcta por parte del usuario. Por ejemplo, si el bot pregunta sobre pizzas y bebidas, una buena pregunta aclaratoria podría ser “¿Qué quiere hacer?”. Puede decir “Pedir una pizza” o “Pedir bebida”.  
Si ha definido una intención alternativa, se invocará si la pregunta aclaratoria se repite el número de veces definido en el campo `maxAttempts`. Para obtener más información, consulte [AMAZON. FallbackIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-fallback.html).  
Si no define una pregunta aclaratoria, en tiempo de ejecución, Amazon Lex devolverá una excepción 400 de solicitud errónea en estos tres casos:   
+ Pregunta aclaratoria: cuando el usuario responde a una pregunta de seguimiento, pero no proporciona una intención. Por ejemplo, como respuesta a una pregunta de seguimiento “¿Desea algo más hoy?”, el usuario dice “Sí”. Amazon Lex devolverá una excepción 400 de solicitud errónea porque no tiene una pregunta aclaratoria que pueda enviar al usuario para obtener una intención.
+ Función de Lambda: al utilizar una función de Lambda, se devuelve un tipo de diálogo `ElicitIntent`. Dado que Amazon Lex no tiene una pregunta aclaratoria para obtener una intención del usuario, devuelve la excepción 400 de solicitud errónea.
+ PutSession operación: al utilizar la `PutSession` operación, se envía un tipo `ElicitIntent` de diálogo. Dado que Amazon Lex no tiene una pregunta aclaratoria para obtener una intención del usuario, devuelve la excepción 400 de solicitud errónea.
Tipo: objeto [Prompt](API_Prompt.md)  
Obligatorio: no

 ** [createVersion](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-createVersion"></a>
Cuando se establece en `true`, se crea una nueva versión numerada del bot. Se produce lo mismo que al llamar a la operación `CreateBotVersion`. Si no especifica `createVersion`, el valor predeterminado es `false`.  
Tipo: Booleano  
Obligatorio: no

 ** [description](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-description"></a>
La descripción del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.  
Obligatorio: no

 ** [detectSentiment](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-detectSentiment"></a>
Cuando se establece en `true`, los enunciados del usuario se envían a Amazon Comprehend con fines de análisis de opiniones. Si no especifica `detectSentiment`, el valor predeterminado es `false`.  
Tipo: Booleano  
Obligatorio: no

 ** [enableModelImprovements](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-enableModelImprovements"></a>
Se establece en `true` para habilitar el acceso a mejoras de la comprensión del lenguaje natural.   
Cuando establece el parámetro `enableModelImprovements` en `true`, puede utilizar el parámetro `nluIntentConfidenceThreshold` para configurar puntuaciones de confianza. Para obtener más información, consulte [Puntuaciones de confianza](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html).  
Solo puede establecer el parámetro `enableModelImprovements` en ciertas regiones. Si establece el parámetro en `true`, el bot tendrá acceso a mejoras en la precisión.  
Las regiones en las que puede establecer el parámetro `enableModelImprovements` en `false` para la configuración regional en-US son las siguientes:  
+ Este de EE. UU. (Norte de Virginia) (us-east-1)
+ Oeste de EE. UU. (Oregón) (us-west-2)
+ Asia-Pacífico (Sídney) (ap-southeast-2)
+ UE (Irlanda) (eu-west-1)
En otras regiones y configuraciones regionales, el parámetro `enableModelImprovements` se establece en `true` de forma predeterminada. En estas regiones y configuraciones regionales, configurar el parámetro `false` da lugar a una excepción `ValidationException`.  
Tipo: Booleano  
Obligatorio: no

 ** [idleSessionTTLInSeconds](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-idleSessionTTLInSeconds"></a>
El tiempo máximo que Amazon Lex retiene los datos recopilados en una conversación, en segundos.  
Una sesión de interacciones del usuario permanece activa durante el tiempo especificado. Si no se produce ninguna conversación durante este tiempo, la sesión caduca y Amazon Lex elimina los datos proporcionados antes de que se agote el tiempo de espera.  
Por ejemplo, supongamos que un usuario elige la OrderPizza intención, pero se desvía a la mitad del proceso de realizar un pedido. Si el usuario no completa el pedido dentro de un plazo especificado, Amazon Lex descarta la información de la ranura que ha recopilado, por lo que el usuario tendrá que volver a iniciar el pedido.  
Si no se incluye el elemento `idleSessionTTLInSeconds` en una solicitud de la operación `PutBot`, Amazon Lex utiliza el valor predeterminado. También se da esta situación si la solicitud reemplaza un bot existente.  
El valor predeterminado es 300 segundos (5 minutos).  
Tipo: entero  
Rango válido: valor mínimo de 60. Valor máximo de 86 400.  
Obligatorio: no

 ** [intents](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-intents"></a>
Una matriz de objetos `Intent`. Cada intención representa una orden que puede expresar el usuario. Por ejemplo, un robot de pedidos de pizza podría respaldar una OrderPizza intención. Para obtener más información, consulte [Funcionamiento de Amazon Lex](how-it-works.md).  
Tipo: matriz de objetos [Intent](API_Intent.md)  
Obligatorio: no

 ** [locale](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-locale"></a>
 Especifica la configuración regional de destino para el bot. Todas las intenciones que se utilicen en el bot deben ser compatibles con la configuración regional del bot.   
El valor predeterminado es `en-US`.  
Tipo: cadena  
Valores válidos: `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`   
Obligatorio: sí

 ** [nluIntentConfidenceThreshold](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-nluIntentConfidenceThreshold"></a>
Determina el umbral en el que Amazon Lex insertará el `AMAZON.FallbackIntent``AMAZON.KendraSearchIntent`, o ambos, al devolver intenciones alternativas en una [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)respuesta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)o. `AMAZON.FallbackIntent`y solo `AMAZON.KendraSearchIntent` se insertan si están configurados para el bot.  
Debe establecer el parámetro `enableModelImprovements` en `true` para utilizar las puntuaciones de confianza en las siguientes regiones:  
+ Este de EE. UU. (Norte de Virginia) (us-east-1)
+ Oeste de EE. UU. (Oregón) (us-west-2)
+ Asia-Pacífico (Sídney) (ap-southeast-2)
+ UE (Irlanda) (eu-west-1)
En otras regiones, el parámetro `enableModelImprovements` se establece en `true` de forma predeterminada.  
Por ejemplo, supongamos que un bot se ha configurado con un umbral de confianza de 0,80 y `AMAZON.FallbackIntent`. Amazon Lex devuelve tres intenciones alternativas con las siguientes puntuaciones de confianza: IntentA (0,70), IntentB (0,60) e IntentC (0,50). La respuesta de la operación `PostText` sería:  
+ AMAZON. FallbackIntent
+ IntentA
+ IntentB
+ IntentC
Tipo: Doble  
Rango válido: valor mínimo de 0. El valor máximo es de 1.  
Obligatorio: no

 ** [processBehavior](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-processBehavior"></a>
Si establece el elemento `processBehavior` en `BUILD`, Amazon Lex compila el bot para que se pueda ejecutar. Si establece el elemento en `SAVE`, Amazon Lex guarda el bot sin compilarlo.   
Si no especifica este valor, el valor predeterminado es `BUILD`.  
Tipo: cadena  
Valores válidos: `SAVE | BUILD`   
Obligatorio: no

 ** [tags](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-tags"></a>
Una lista de las etiquetas que se agregarán al bot. Solo puede agregar etiquetas al crear un bot. No puede utilizar la operación `PutBot` para actualizar las etiquetas de un bot. Para actualizar las etiquetas, use la operación `TagResource`.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

 ** [voiceId](#API_PutBot_RequestSyntax) **   <a name="lex-PutBot-request-voiceId"></a>
El ID de voz de Amazon Polly que quiera que Amazon Lex utilice para las interacciones de voz con el usuario. La configuración regional de la voz debe coincidir con la configuración regional del bot. Para obtener más información, consulte [Voces en Amazon Polly](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html) en la *Guía para desarrolladores de Amazon Polly*.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_PutBot_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [abortStatement](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-abortStatement"></a>
El mensaje que Amazon Lex utiliza para cancelar una conversación. Para obtener más información, consulte [PutBot](#API_PutBot).  
Tipo: objeto [Statement](API_Statement.md)

 ** [checksum](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-checksum"></a>
La suma de comprobación del bot que ha creado.  
Tipo: cadena

 ** [childDirected](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-childDirected"></a>
Para cada bot de Amazon Lex creado con el Servicio de creación de modelos de Amazon Lex, debe especificar si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que esté dirigido, total o parcialmente, a niños menores de 13 años y esté sujeto a la Ley de protección de la privacidad infantil en línea (COPPA, por sus siglas en inglés). Para ello, especifique `true` o `false` en el campo `childDirected`. Al especificar `true` en el campo `childDirected`, confirma que el uso de Amazon Lex **está** relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. Al especificar `false` en el campo `childDirected`, confirma que el uso de Amazon Lex **no está** relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. No puede especificar un valor predeterminado en el campo `childDirected` que no indique de forma precisa si el uso de Amazon Lex está relacionado o no con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA.  
Si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años, debe obtener un consentimiento parental verificable, obligatorio en virtud de la COPPA. Para obtener información acerca del uso de Amazon Lex con relación a sitios web, programas u otras aplicaciones dirigidos, total o parcialmente, a niños menores de 13 años, consulte las [Preguntas frecuentes de Amazon Lex](https://aws.amazon.com/lex/faqs#data-security).   
Tipo: Booleano

 ** [clarificationPrompt](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-clarificationPrompt"></a>
 Las solicitudes que Amazon Lex utiliza cuando no comprende la intención del usuario. Para obtener más información, consulte [PutBot](#API_PutBot).   
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createdDate"></a>
La fecha de creación del bot.  
Tipo: marca temporal

 ** [createVersion](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-createVersion"></a>
 Es `True` si se ha creado una nueva versión del bot. Si el campo `createVersion` no se ha especificado en la solicitud, el campo `createVersion` se establece en “false” en la respuesta.  
Tipo: Booleano

 ** [description](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-description"></a>
La descripción del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [detectSentiment](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-detectSentiment"></a>
 Es `true` si el bot está configurado para enviar enunciados del usuario a Amazon Comprehend con fines de análisis de opiniones. Si el campo `detectSentiment` no se ha especificado en la solicitud, el campo `detectSentiment` es `false` en la respuesta.  
Tipo: Booleano

 ** [enableModelImprovements](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-enableModelImprovements"></a>
Indica si el bot utiliza mejoras en la precisión. `true` indica que el bot utiliza las mejoras y `false`, lo contrario.  
Tipo: Booleano

 ** [failureReason](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-failureReason"></a>
Si `status` es `FAILED`, Amazon Lex proporciona el motivo por el que no se ha podido crear el bot.  
Tipo: cadena

 ** [idleSessionTTLInSeconds](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-idleSessionTTLInSeconds"></a>
La duración máxima que Amazon Lex retiene los datos recopilados en una conversación. Para obtener más información, consulte [PutBot](#API_PutBot).  
Tipo: entero  
Rango válido: valor mínimo de 60. Valor máximo de 86 400.

 ** [intents](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-intents"></a>
Una matriz de objetos `Intent`. Para obtener más información, consulte [PutBot](#API_PutBot).  
Tipo: matriz de objetos [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-lastUpdatedDate"></a>
La fecha de actualización del bot. Cuando se crea un recurso, la fecha de creación y la fecha de la última actualización son la misma.  
Tipo: marca temporal

 ** [locale](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-locale"></a>
 La configuración regional de destino para el bot.   
Tipo: cadena  
Valores válidos: `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>
El nombre del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [nluIntentConfidenceThreshold](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-nluIntentConfidenceThreshold"></a>
La puntuación que determina dónde inserta Amazon Lex `AMAZON.FallbackIntent``AMAZON.KendraSearchIntent`, o ambas, al devolver intenciones alternativas en una [PostText](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html)respuesta [PostContent](https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html)o. `AMAZON.FallbackIntent`se inserta si la puntuación de confianza de todos los intentos está por debajo de este valor. `AMAZON.KendraSearchIntent`solo se inserta si está configurado para el bot.  
Tipo: Doble  
Rango válido: valor mínimo de 0. Valor máximo de 1.

 ** [status](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-status"></a>
 Cuando envía una solicitud para crear un bot y `processBehavior` se ha establecido en `BUILD`, Amazon Lex establece el elemento de respuesta `status` en `BUILDING`.  
En el `READY_BASIC_TESTING` estado, puede probar el bot con entradas del usuario que coincidan exactamente con los enunciados configurados para las intenciones y los valores del bot en los tipos de ranura.  
Si Amazon Lex no puede compilar el bot, Amazon Lex establece `status` en `FAILED`. Amazon Lex devuelve el motivo del error en el elemento de respuesta `failureReason`.   
Cuando se establece `processBehavior` en `SAVE`, Amazon Lex establece el código de estado en `NOT BUILT`.  
Cuando el bot se encuentra en el estado `READY`, se puede probar y publicar.  
Tipo: cadena  
Valores válidos: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [tags](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-tags"></a>
Una lista de etiquetas asociadas al bot.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

 ** [version](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-version"></a>
La versión del bot. En el caso de un bot nuevo, la versión es siempre `$LATEST`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_PutBot_ResponseSyntax) **   <a name="lex-PutBot-response-voiceId"></a>
El ID de voz de Amazon Polly que Amazon Lex utiliza para la interacción de voz con el usuario. Para obtener más información, consulte [PutBot](#API_PutBot).  
Tipo: cadena

## Errores
<a name="API_PutBot_Errors"></a>

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** PreconditionFailedException **   
 La suma de comprobación del recurso que intenta modificar no coincide con la suma de comprobación de la solicitud. Revise la suma de comprobación del recurso e inténtelo de nuevo.  
Código de estado HTTP: 412

## Véase también
<a name="API_PutBot_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBot) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBot) 

# PutBotAlias
<a name="API_PutBotAlias"></a>

Crea un alias de la versión especificada del bot o reemplaza un alias del bot especificado. Para cambiar la versión del bot al que apunta el alias, reemplace el alias. Para obtener más información acerca de los alias, consulte [Control de versiones y alias](versioning-aliases.md).

Esta operación necesita permisos para la acción `lex:PutBotAlias`. 

## Sintaxis de la solicitud
<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"
      }
   ]
}
```

## Parámetros de solicitud del URI
<a name="API_PutBotAlias_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [botName](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-botName"></a>
El nombre del bot.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [name](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-name"></a>
El nombre del alias. El nombre *no* distingue entre mayúsculas y minúsculas.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_PutBotAlias_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [botVersion](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-botVersion"></a>
La versión del bot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+`   
Obligatorio: sí

 ** [checksum](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-checksum"></a>
Identifica una revisión específica de la versión `$LATEST`.  
Si crea un nuevo alias de bot, deje el campo `checksum` vacío. Si especifica una suma de comprobación, obtendrá una excepción `BadRequestException`.  
Cuando quiera actualizar un alias de bot, establezca el campo `checksum` en la suma de comprobación de la revisión más reciente de la versión `$LATEST`. Si no especifica el campo ` checksum` o si la suma de comprobación no coincide con la versión `$LATEST`, obtendrá una excepción `PreconditionFailedException`.  
Tipo: cadena  
Requerido: no

 ** [conversationLogs](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-conversationLogs"></a>
La configuración de los registros de conversaciones para el alias.  
Tipo: objeto [ConversationLogsRequest](API_ConversationLogsRequest.md)  
Obligatorio: no

 ** [description](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-description"></a>
Una descripción del alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.  
Obligatorio: no

 ** [tags](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-tags"></a>
Una lista de las etiquetas que se agregarán al alias del bot. Solo puede agregar etiquetas al crear un alias. No puede utilizar la operación `PutBotAlias` para actualizar las etiquetas de un alias de bot. Para actualizar las etiquetas, use la operación `TagResource`.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<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"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_PutBotAlias_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [botName](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botName"></a>
El nombre del bot al que apunta el alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [botVersion](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botVersion"></a>
La versión del bot a la que apunta el alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

 ** [checksum](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-checksum"></a>
La suma de comprobación para la versión actual del alias.  
Tipo: cadena

 ** [conversationLogs](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-conversationLogs"></a>
La configuración que determina cómo Amazon Lex utiliza los registros de conversaciones para el alias.  
Tipo: objeto [ConversationLogsResponse](API_ConversationLogsResponse.md)

 ** [createdDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-createdDate"></a>
La fecha de creación del alias del bot.  
Tipo: marca temporal

 ** [description](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-description"></a>
Una descripción del alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [lastUpdatedDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-lastUpdatedDate"></a>
La fecha de actualización del alias del bot. Al crear un recurso, la fecha de creación y la fecha de la última actualización son la misma.  
Tipo: marca temporal

 ** [name](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-name"></a>
El nombre del alias.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [tags](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-tags"></a>
Una lista de etiquetas asociadas a un bot.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

## Errores
<a name="API_PutBotAlias_Errors"></a>

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** PreconditionFailedException **   
 La suma de comprobación del recurso que intenta modificar no coincide con la suma de comprobación de la solicitud. Revise la suma de comprobación del recurso e inténtelo de nuevo.  
Código de estado HTTP: 412

## Véase también
<a name="API_PutBotAlias_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutBotAlias) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutBotAlias) 

# PutIntent
<a name="API_PutIntent"></a>

Crea una intención o sustituye una intención existente.

Para definir la interacción entre el usuario y el bot, utiliza una o varias intenciones. Por ejemplo, para un bot de pedidos de pizza, crearía una intención `OrderPizza`. 

Para crear una intención o reemplazar una intención existente, debe proporcionar lo siguiente:
+ El nombre de la intención. Por ejemplo, `OrderPizza`.
+ Enunciados de muestra. Por ejemplo, “¿Puedo pedir una pizza?” y “Quiero pedir una pizza”.
+ La información que debe recopilarse. Es necesario especificar los tipos de ranura para la información que el bot solicitará del usuario. Puede especificar tipos de ranura estándar, como una fecha o una hora, o tipos de ranura personalizados, como el tamaño y la masa de una pizza.
+ Cómo se cumplirá la intención. Puede proporcionar una función de Lambda o configurar la intención para que devuelva información de la intención a la aplicación cliente. Si utiliza una función de Lambda, en el caso de que toda la información de la intención esté disponible, Amazon Lex invoca la función de Lambda. Si configura la intención para que devuelva la información de la intención a la aplicación cliente. 

Puede especificar información opcional en la solicitud como la siguiente:
+ Una pregunta de confirmación para solicitar al usuario que confirme una intención. Por ejemplo, “¿Debo pedir su pizza?”.
+ Una afirmación de cierre que se envía al usuario después de cumplir con la intención. Por ejemplo, “He pedido su pizza”.
+ Una pregunta de seguimiento para solicitar actividad adicional al usuario. Por ejemplo, puede preguntar “¿Quiere acompañar su pizza con una bebida?”.

Si especifica un nombre de intención existente para actualizar la intención, Amazon Lex reemplaza los valores de la versión `$LATEST` de la intención con los valores de la solicitud. Amazon Lex elimina los campos que no ha proporcionado en la solicitud. Si no especifica los campos obligatorios, Amazon Lex devuelve una excepción. Al actualizar la versión `$LATEST` de una intención, el campo `status` de cualquier bot que utilice la versión `$LATEST` de la intención se establece en `NOT_BUILT`.

Para obtener más información, consulte [Funcionamiento de Amazon Lex](how-it-works.md).

Esta operación necesita permisos para la acción `lex:PutIntent`.

## Sintaxis de la solicitud
<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"
         }
      }
   ]
}
```

## Parámetros de solicitud del URI
<a name="API_PutIntent_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-uri-name"></a>
El nombre de la intención. El nombre *no* distingue entre mayúsculas y minúsculas.   
El nombre no puede coincidir con el nombre de una intención integrada o con el nombre de una intención integrada con la parte “AMAZON”. eliminada. Por ejemplo, como hay una intención integrada con el nombre `AMAZON.HelpIntent`, no puede crear una intención personalizada con el nombre `HelpIntent`.  
Para obtener una lista de las intenciones integradas, consulte [Intenciones estándar integradas](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) en *Alexa Skills Kit*.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_PutIntent_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [checksum](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-checksum"></a>
Identifica una revisión específica de la versión `$LATEST`.  
Si crea una nueva intención, deje el campo `checksum` vacío. Si especifica una suma de comprobación, obtendrá una excepción `BadRequestException`.  
Cuando quiera actualizar una intención, establezca el campo `checksum` en la suma de comprobación de la revisión más reciente de la versión `$LATEST`. Si no especifica el campo ` checksum` o si la suma de comprobación no coincide con la versión `$LATEST`, obtendrá una excepción `PreconditionFailedException`.  
Tipo: cadena  
Requerido: no

 ** [conclusionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-conclusionStatement"></a>
 La afirmación que quiere que Amazon Lex transmita al usuario después de que la función de Lambda haya cumplido correctamente la intención.   
Este elemento solo es relevante si proporciona una función de Lambda en `fulfillmentActivity`. Si devuelve la intención a la aplicación cliente, no puede especificar este elemento.  
`followUpPrompt` y `conclusionStatement` son mutuamente excluyentes. Puede especificar solo un valor.
Tipo: objeto [Statement](API_Statement.md)  
Obligatorio: no

 ** [confirmationPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-confirmationPrompt"></a>
Pide al usuario que confirme la intención. Esta pregunta debe tener una respuesta afirmativa o negativa.  
Amazon Lex utiliza esta solicitud para confirmar que el usuario sabe que la intención puede cumplirse. Por ejemplo, con la intención `OrderPizza`, es posible que quiera confirmar que los detalles del pedido son correctos antes de procesarlo. En el caso de otras intenciones, como las intenciones que sirven únicamente para responder a preguntar del usuario, es posible que no quiera solicitar confirmación al usuario antes de proporcionar la información.   
Debe proporcionar `rejectionStatement` y `confirmationPrompt` o ningún valor.
Tipo: objeto [Prompt](API_Prompt.md)  
Obligatorio: no

 ** [createVersion](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-createVersion"></a>
Cuando se establece en `true`, se crea una nueva versión numerada de la intención. Se produce lo mismo que al llamar a la operación `CreateIntentVersion`. Si no especifica `createVersion`, el valor predeterminado es `false`.  
Tipo: Booleano  
Obligatorio: no

 ** [description](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-description"></a>
Una descripción de la intención.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.  
Obligatorio: no

 ** [dialogCodeHook](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-dialogCodeHook"></a>
 Especifica una función de Lambda para que se invoque para cada entrada del usuario. Puede invocar esta función de Lambda para personalizar la interacción del usuario.   
Por ejemplo, supongamos que el bot determina que el usuario es John. La función de Lambda podría recuperar la información de John de una base de datos de back-end y rellenar previamente algunos de los valores. Por ejemplo, si descubre que John es intolerante al gluten, puede establecer la ranura de la intención correspondiente, `GlutenIntolerant`, en verdadero. Si encuentra el número de teléfono de John, puede configurar el atributo de la sesión correspondiente.   
Tipo: objeto [CodeHook](API_CodeHook.md)  
Obligatorio: no

 ** [followUpPrompt](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-followUpPrompt"></a>
Amazon Lex utiliza esta solicitud para solicitar actividad adicional una vez que se ha cumplido con una intención. Por ejemplo, si se cumple la intención `OrderPizza`, puede enviar una solicitud al usuario para saber si quiere pedir bebida.  
La acción que Amazon Lex realiza depende de la respuesta del usuario, tal como se indica a continuación:  
+ Si el usuario dice “sí”, responde con la pregunta aclaratoria que se ha configurado para el bot.
+ Si el usuario dice “sí” y continua con un enunciado que activa una intención, inicia una conversación para cumplir con la intención.
+ Si el usuario dice “no”, responde con la afirmación de rechazo configurada para la pregunta de seguimiento.
+ Si no reconoce el enunciado, repite la pregunta de seguimiento.
Los campos `followUpPrompt` y `conclusionStatement` son mutuamente excluyentes. Puede especificar solo un valor.   
Tipo: objeto [FollowUpPrompt](API_FollowUpPrompt.md)  
Obligatorio: no

 ** [fulfillmentActivity](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-fulfillmentActivity"></a>
Obligatorio. Describe cómo se cumple con la intención. Por ejemplo, cuando un usuario ha proporcionado toda la información necesaria para pedir una pizza, `fulfillmentActivity` define cómo el bot realiza el pedido en una pizzería local.   
 Puede configurar Amazon Lex para que devuelva toda la información de la intención a la aplicación cliente o indicar a Amazon Lex que invoque una función de Lambda que pueda procesar la intención (por ejemplo, realizar un pedido en una pizzería).   
Tipo: objeto [FulfillmentActivity](API_FulfillmentActivity.md)  
Obligatorio: no

 ** [inputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-inputContexts"></a>
Una matriz de objetos `InputContext` que enumera los contextos que deben estar activos para que Amazon Lex elija la intención en una conversación con el usuario.  
Tipo: matriz de objetos [InputContext](API_InputContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 5 artículos.  
Obligatorio: no

 ** [kendraConfiguration](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-kendraConfiguration"></a>
Información de configuración necesaria para utilizar la intención `AMAZON.KendraSearchIntent` con la finalidad de conectarse a un índice de Amazon Kendra. Para obtener más información, consulte [AMAZON. KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html).  
Tipo: objeto [KendraConfiguration](API_KendraConfiguration.md)  
Obligatorio: no

 ** [outputContexts](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-outputContexts"></a>
Una matriz de objetos `OutputContext` que enumera los contextos en los que la intención se activa cuando esta se cumple.  
Tipo: matriz de objetos [OutputContext](API_OutputContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.  
Obligatorio: no

 ** [parentIntentSignature](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-parentIntentSignature"></a>
Un identificador único para la intención integrada en la cual se debe basar esta intención. Para encontrar la firma de una intención, consulte [Intenciones integradas estándar](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) en *Alexa Skills Kit*.  
Tipo: cadena  
Requerido: no

 ** [rejectionStatement](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-rejectionStatement"></a>
Cuando el usuario responde “no” a la pregunta definida en `confirmationPrompt`, Amazon Lex responde con esta afirmación para confirmar que la intención se ha cancelado.   
Debe proporcionar `rejectionStatement` y `confirmationPrompt` o ningún valor.
Tipo: objeto [Statement](API_Statement.md)  
Obligatorio: no

 ** [sampleUtterances](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-sampleUtterances"></a>
Una matriz de enunciados (cadenas) que un usuario podría decir para indicar la intención. Por ejemplo, «Quiero \$1PizzaSize\$1 pizza», «Pedir \$1cantidad\$1 \$1PizzaSize\$1 pizzas».   
En cada enunciado se incluye un nombre de ranura entre llaves.   
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 1500 elementos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.  
Obligatorio: no

 ** [slots](#API_PutIntent_RequestSyntax) **   <a name="lex-PutIntent-request-slots"></a>
Una matriz de ranuras de intención. En tiempo de ejecución, Amazon Lex obtiene los valores de ranura del usuario a través de las solicitudes definidas en las ranuras. Para obtener más información, consulte [Funcionamiento de Amazon Lex](how-it-works.md).   
Tipo: matriz de objetos [Slot](API_Slot.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 100 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_PutIntent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [checksum](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-checksum"></a>
La suma de comprobación de la versión `$LATEST` de la intención creada o actualizada.  
Tipo: cadena

 ** [conclusionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-conclusionStatement"></a>
Una vez que la función de Lambda especificada en la intención `fulfillmentActivity` cumple con la intención, Amazon Lex transmite esta afirmación al usuario.  
Tipo: objeto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-confirmationPrompt"></a>
Si se define en la intención, Amazon Lex solicita al usuario que confirme la intención antes de cumplirla.  
Tipo: objeto [Prompt](API_Prompt.md)

 ** [createdDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createdDate"></a>
La fecha en que se creó la intención.  
Tipo: marca temporal

 ** [createVersion](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-createVersion"></a>
 Es `True` si se ha creado una nueva versión de la intención. Si el campo `createVersion` no se ha especificado en la solicitud, el campo `createVersion` se establece en “false” en la respuesta.  
Tipo: Booleano

 ** [description](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-description"></a>
Una descripción de la intención.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [dialogCodeHook](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-dialogCodeHook"></a>
Si se define en la intención, Amazon Lex invoca esta función de Lambda para cada entrada del usuario.  
Tipo: objeto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-followUpPrompt"></a>
Si se define en la intención, Amazon Lex utiliza esta solicitud para solicitar actividad adicional del usuario una vez que se ha cumplido con la intención.  
Tipo: objeto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-fulfillmentActivity"></a>
Si se define en la intención, Amazon Lex invoca esta función de Lambda para cumplir con la intención una vez que el usuario haya proporcionado toda la información que requiere la intención.  
Tipo: objeto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-inputContexts"></a>
Una matriz de objetos `InputContext` que enumera los contextos que deben estar activos para que Amazon Lex elija la intención en una conversación con el usuario.  
Tipo: matriz de objetos [InputContext](API_InputContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 5 artículos.

 ** [kendraConfiguration](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-kendraConfiguration"></a>
Información de configuración, si procede, para conectarse a un índice de Amazon Kendra y utilizar la intención `AMAZON.KendraSearchIntent`.  
Tipo: objeto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-lastUpdatedDate"></a>
La fecha de actualización de la intención. Cuando se crea un recurso, la fecha de creación y la fecha de la última actualización son la misma.  
Tipo: marca temporal

 ** [name](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-name"></a>
El nombre de la intención.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-outputContexts"></a>
Una matriz de objetos `OutputContext` que enumera los contextos en los que la intención se activa cuando esta se cumple.  
Tipo: matriz de objetos [OutputContext](API_OutputContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.

 ** [parentIntentSignature](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-parentIntentSignature"></a>
Un identificador único para la intención integrada en la cual se basa esta intención.  
Tipo: cadena

 ** [rejectionStatement](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-rejectionStatement"></a>
Si el usuario responde “no” a la pregunta definida en `confirmationPrompt`, Amazon Lex responde con esta afirmación para confirmar que la intención se ha cancelado.   
Tipo: objeto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-sampleUtterances"></a>
 Una matriz de enunciados de muestra configurados para la intención.   
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 1500 elementos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.

 ** [slots](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-slots"></a>
Una matriz de ranuras de intención configuradas para la intención.  
Tipo: matriz de objetos [Slot](API_Slot.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 100 artículos.

 ** [version](#API_PutIntent_ResponseSyntax) **   <a name="lex-PutIntent-response-version"></a>
La versión de la intención. En el caso de una intención nueva, la versión es siempre `$LATEST`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

## Errores
<a name="API_PutIntent_Errors"></a>

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** PreconditionFailedException **   
 La suma de comprobación del recurso que intenta modificar no coincide con la suma de comprobación de la solicitud. Revise la suma de comprobación del recurso e inténtelo de nuevo.  
Código de estado HTTP: 412

## Véase también
<a name="API_PutIntent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutIntent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutIntent) 

# PutSlotType
<a name="API_PutSlotType"></a>

Crea un tipo de ranura personalizado o sustituye un tipo de ranura personalizado existente.

Para crear un tipo de ranura personalizado, especifique un nombre para el tipo de ranura y un conjunto de valores de enumeración, que son los valores que puede asumir una ranura de este tipo. Para obtener más información, consulte [Funcionamiento de Amazon Lex](how-it-works.md).

Si especifica el nombre de un tipo de ranura existente, los campos de la solicitud reemplazan los valores existentes en la versión `$LATEST` del tipo de ranura. Amazon Lex elimina los campos que no ha proporcionado en la solicitud. Si no especifica los campos obligatorios, Amazon Lex devuelve una excepción. Al actualizar la versión `$LATEST` de un tipo de ranura, si el bot utiliza la versión `$LATEST` de una intención que contiene el tipo de ranura, el campo `status` del bot se establece en `NOT_BUILT`.

Esta operación necesita permisos para la acción `lex:PutSlotType`.

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de solicitud del URI
<a name="API_PutSlotType_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [name](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-uri-name"></a>
El nombre del tipo de slot. El nombre *no* distingue entre mayúsculas y minúsculas.   
El nombre no puede coincidir con el nombre de un tipo de ranura integrado o con el nombre de un tipo de ranura integrado con la parte “AMAZON.” eliminada. Por ejemplo, como hay un tipo de ranura integrado con el nombre `AMAZON.DATE`, no puede crear un tipo de ranura personalizado con el nombre `DATE`.  
Para obtener una lista con los tipos de ranura integrados, consulte [Referencia del tipo de ranura](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) en *Alexa Skills Kit*.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_PutSlotType_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [checksum](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-checksum"></a>
Identifica una revisión específica de la versión `$LATEST`.  
Si crea un nuevo tipo de ranura, deje el campo `checksum` vacío. Si especifica una suma de comprobación, obtendrá una excepción `BadRequestException`.  
Cuando quiera actualizar un tipo de ranura, establezca el campo `checksum` en la suma de comprobación de la revisión más reciente de la versión `$LATEST`. Si no especifica el campo ` checksum` o si la suma de comprobación no coincide con la versión `$LATEST`, obtendrá una excepción `PreconditionFailedException`.  
Tipo: cadena  
Requerido: no

 ** [createVersion](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-createVersion"></a>
Cuando se establece en `true`, se crea una nueva versión numerada del tipo de ranura. Se produce lo mismo que al llamar a la operación `CreateSlotTypeVersion`. Si no especifica `createVersion`, el valor predeterminado es `false`.  
Tipo: Booleano  
Obligatorio: no

 ** [description](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-description"></a>
Una descripción del tipo de slot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.  
Obligatorio: no

 ** [enumerationValues](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-enumerationValues"></a>
Una lista de objetos `EnumerationValue` que define los valores que puede tomar el tipo de ranura. Cada valor puede tener una lista de `synonyms`, que son valores adicionales que ayudan a entrenar el modelo de machine learning sobre los valores que resuelve para una ranura.   
Un tipo de ranura de expresión regular no requiere valores de enumeración. Todos los demás tipos de ranuras requieren una lista de valores de enumeración.  
Cuando Amazon Lex resuelve el valor de una ranura, genera una lista de resoluciones que contiene hasta cinco valores posibles para la ranura. Si utiliza una función de Lambda, esta lista de resoluciones se pasa a la función. Si no utiliza una función de Lambda, puede elegir que devuelva el valor que el usuario ha introducido o el primer valor de la lista de resoluciones como el valor de la ranura. El campo `valueSelectionStrategy` indica la opción que se utiliza.   
Tipo: matriz de objetos [EnumerationValue](API_EnumerationValue.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 10 000 elementos.  
Obligatorio: no

 ** [parentSlotTypeSignature](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-parentSlotTypeSignature"></a>
El tipo de ranura integrado que se utiliza como principal para este tipo de ranura. Al definir un tipo de ranura principal, el nuevo tipo de ranura tiene la misma configuración que el tipo de ranura principal.  
Solo se admite `AMAZON.AlphaNumeric`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^((AMAZON\.)_?|[A-Za-z]_?)+`   
Obligatorio: no

 ** [slotTypeConfigurations](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-slotTypeConfigurations"></a>
Información sobre la configuración que amplía el tipo de ranura integrado principal. La configuración se agrega a la configuración del tipo de ranura principal.  
Tipo: matriz de objetos [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.  
Obligatorio: no

 ** [valueSelectionStrategy](#API_PutSlotType_RequestSyntax) **   <a name="lex-PutSlotType-request-valueSelectionStrategy"></a>
Determina la estrategia de resolución de ranura que Amazon Lex utiliza para devolver valores de tipo de ranura. El campo se puede establecer en uno de los siguientes valores:  
+  `ORIGINAL_VALUE`: devuelve el valor que ha introducido el usuario, si el valor del usuario es similar a un valor de ranura.
+  `TOP_RESOLUTION`: si hay una lista de resoluciones para la ranura, devuelve el primer valor de la lista de resoluciones como el valor del tipo de ranura. Si no hay lista de resoluciones, se devuelve un valor null (nulo).
Si no especifica `valueSelectionStrategy`, el valor predeterminado es `ORIGINAL_VALUE`.  
Tipo: cadena  
Valores válidos: `ORIGINAL_VALUE | TOP_RESOLUTION`   
Obligatorio: no

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_PutSlotType_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [checksum](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-checksum"></a>
La suma de comprobación de la versión `$LATEST` del tipo de ranura.  
Tipo: cadena

 ** [createdDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createdDate"></a>
La fecha de creación del tipo de ranura.  
Tipo: marca temporal

 ** [createVersion](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-createVersion"></a>
 Es `True` si se ha creado una nueva versión del tipo de ranura. Si el campo `createVersion` no se ha especificado en la solicitud, el campo `createVersion` se establece en “false” en la respuesta.  
Tipo: Booleano

 ** [description](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-description"></a>
Una descripción del tipo de slot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

 ** [enumerationValues](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-enumerationValues"></a>
Una lista de objetos `EnumerationValue` que define los valores que puede tomar el tipo de ranura.  
Tipo: matriz de objetos [EnumerationValue](API_EnumerationValue.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 10 000 elementos.

 ** [lastUpdatedDate](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-lastUpdatedDate"></a>
La fecha de actualización del tipo de ranura. Cuando se crea un tipo de recurso, la fecha de creación y la fecha de la última actualización son la misma.  
Tipo: marca temporal

 ** [name](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-name"></a>
El nombre del tipo de slot.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [parentSlotTypeSignature](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-parentSlotTypeSignature"></a>
El tipo de ranura integrado que se utiliza como principal para este tipo de ranura.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^((AMAZON\.)_?|[A-Za-z]_?)+` 

 ** [slotTypeConfigurations](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-slotTypeConfigurations"></a>
Información sobre la configuración que amplía el tipo de ranura integrado principal.  
Tipo: matriz de objetos [SlotTypeConfiguration](API_SlotTypeConfiguration.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.

 ** [valueSelectionStrategy](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-valueSelectionStrategy"></a>
La estrategia de resolución de ranura que Amazon Lex utiliza para determinar el valor de la ranura. Para obtener más información, consulte [PutSlotType](#API_PutSlotType).  
Tipo: cadena  
Valores válidos: `ORIGINAL_VALUE | TOP_RESOLUTION` 

 ** [version](#API_PutSlotType_ResponseSyntax) **   <a name="lex-PutSlotType-response-version"></a>
La versión del tipo de ranura. En el caso de un tipo de ranura nuevo, la versión es siempre `$LATEST`.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

## Errores
<a name="API_PutSlotType_Errors"></a>

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** PreconditionFailedException **   
 La suma de comprobación del recurso que intenta modificar no coincide con la suma de comprobación de la solicitud. Revise la suma de comprobación del recurso e inténtelo de nuevo.  
Código de estado HTTP: 412

## Véase también
<a name="API_PutSlotType_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutSlotType) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutSlotType) 

# StartImport
<a name="API_StartImport"></a>

Comienza un trabajo para importar un recurso a Amazon Lex.

## Sintaxis de la solicitud
<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"
      }
   ]
}
```

## Parámetros de solicitud del URI
<a name="API_StartImport_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_StartImport_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [mergeStrategy](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-mergeStrategy"></a>
Especifica la acción que debe llevar a cabo la operación `StartImport` cuando hay un recurso con el mismo nombre.  
+ FAIL\$1ON\$1CONFLICT: la operación de importación se detiene al detectarse el primer conflicto entre un recurso del archivo de importación y un recurso existente. El nombre del recurso que provoca el conflicto se encuentra en el campo `failureReason` de la respuesta a la operación `GetImport`.

  OVERWRITE\$1LATEST: la operación de importación continua aunque haya un conflicto con un recurso existente. La versión \$1LASTEST del recurso existente se sobreescribe con los datos del archivo de importación.
Tipo: cadena  
Valores válidos: `OVERWRITE_LATEST | FAIL_ON_CONFLICT`   
Obligatorio: sí

 ** [payload](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-payload"></a>
Un archivo ZIP en formato binario. El archivo debe contener un archivo JSON que incluya el recurso que se va a importar. El recurso debe coincidir con el tipo especificado en el campo `resourceType`.  
Tipo: objeto de datos binarios codificados en Base64  
Obligatorio: sí

 ** [resourceType](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-resourceType"></a>
Especifica el tipo de recurso que se va a exportar. Cada recurso exporta a su vez los recursos de los que depende.   
+ Un bot exporta intenciones dependientes.
+ Una intención exporta los tipos de ranura dependientes.
Tipo: cadena  
Valores válidos: `BOT | INTENT | SLOT_TYPE`   
Obligatorio: sí

 ** [tags](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-tags"></a>
Una lista de las etiquetas que se agregarán al bot importado. Solo puede agregar etiquetas cuando importa un bot. No puede agregar etiquetas a una intención o un tipo de ranura.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<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"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_StartImport_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.

El servicio devuelve los datos siguientes en formato JSON.

 ** [createdDate](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-createdDate"></a>
Una marca de tiempo para la fecha y hora en la que se solicitó el trabajo de importación.  
Tipo: marca temporal

 ** [importId](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importId"></a>
El identificador de un trabajo de importación específico.  
Tipo: cadena

 ** [importStatus](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importStatus"></a>
El estado del trabajo de importación. Si el estado es `FAILED`, puede consultar el motivo del fallo con la operación `GetImport`.  
Tipo: cadena  
Valores válidos: `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-mergeStrategy"></a>
La acción que se debe llevar a cabo cuando se produce un conflicto de fusión.  
Tipo: cadena  
Valores válidos: `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-name"></a>
El nombre asignado al trabajo de importación.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z_]+` 

 ** [resourceType](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-resourceType"></a>
El tipo de recurso que se va a importar.  
Tipo: cadena  
Valores válidos: `BOT | INTENT | SLOT_TYPE` 

 ** [tags](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-tags"></a>
Una lista de las etiquetas agregadas al bot importado.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

## Errores
<a name="API_StartImport_Errors"></a>

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

## Véase también
<a name="API_StartImport_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartImport) 

# StartMigration
<a name="API_StartMigration"></a>

Comienza a migrar un bot de Amazon Lex V1 a Amazon Lex V2. Migre su bot cuando desee aprovechar las nuevas características de Amazon Lex V2.

Para obtener más información, consulte [Migración de un bot](https://docs.aws.amazon.com/lex/latest/dg/migrate.html) en la *Guía para desarrolladores de Amazon Lex*.

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de solicitud del URI
<a name="API_StartMigration_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_StartMigration_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [migrationStrategy](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-migrationStrategy"></a>
La estrategia empleada para llevar a cabo la migración.  
+  `CREATE_NEW`: crea un nuevo bot de Amazon Lex V2 y migra el bot de Amazon Lex V1 al nuevo bot.
+  `UPDATE_EXISTING`: sobrescribe los metadatos de un bot de Amazon Lex V2 y la configuración regional que se van a migrar. No cambia ninguna otra configuración regional del bot de Amazon Lex V2. Si la configuración regional no existe, se crea una nueva configuración regional en el bot de Amazon Lex V2.
Tipo: cadena  
Valores válidos: `CREATE_NEW | UPDATE_EXISTING`   
Obligatorio: sí

 ** [v1BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotName"></a>
El nombre del bot de Amazon Lex V1 que está migrando a Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$`   
Obligatorio: sí

 ** [v1BotVersion](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotVersion"></a>
La versión del bot que se va a migrar a Amazon Lex V2. Puede migrar la versión `$LATEST`, así como cualquier versión numerada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+`   
Obligatorio: sí

 ** [v2BotName](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotName"></a>
El nombre del bot de Amazon Lex V2 al que está migrando el bot de Amazon Lex V1.   
+ Si el bot de Amazon Lex V2 no existe, debe utilizar la estrategia de migración `CREATE_NEW`.
+ Si el bot de Amazon Lex V2 existe, debe utilizar la estrategia de migración `UPDATE_EXISTING` para modificar el contenido del bot de Amazon Lex V2.
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `^([0-9a-zA-Z][_-]?)+$`   
Obligatorio: sí

 ** [v2BotRole](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotRole"></a>
El rol de IAM que Amazon Lex utiliza para ejecutar el bot de Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 2048 caracteres.  
Patrón: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$`   
Obligatorio: sí

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_StartMigration_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 202.

El servicio devuelve los datos siguientes en formato JSON.

 ** [migrationId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationId"></a>
El identificador único que Amazon Lex ha asignado a la migración.  
Tipo: cadena  
Limitaciones de longitud: longitud fija de 10.  
Patrón: `^[0-9a-zA-Z]+$` 

 ** [migrationStrategy](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationStrategy"></a>
La estrategia empleada para llevar a cabo la migración.  
Tipo: cadena  
Valores válidos: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationTimestamp"></a>
La fecha y hora en que comenzó la migración.  
Tipo: marca temporal

 ** [v1BotLocale](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotLocale"></a>
La configuración regional utilizada para el bot de Amazon Lex V1.   
Tipo: cadena  
Valores válidos: `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>
El nombre del bot de Amazon Lex V1 que está migrando a Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.  
Patrón: `^([A-Za-z]_?)+$` 

 ** [v1BotVersion](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotVersion"></a>
La versión del bot que se va a migrar a Amazon Lex V2.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotId"></a>
El identificador único del bot de Amazon Lex V2.   
Tipo: cadena  
Limitaciones de longitud: longitud fija de 10.  
Patrón: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotRole"></a>
El rol de IAM que Amazon Lex utiliza para ejecutar el bot de Amazon Lex V2.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 2048 caracteres.  
Patrón: `^arn:[\w\-]+:iam::[\d]{12}:role/.+$` 

## Errores
<a name="API_StartMigration_Errors"></a>

 ** AccessDeniedException **   
Su usuario o rol de IAM no tiene permiso para llamar a la Amazon Lex V2 APIs necesaria para migrar su bot.  
Código de estado HTTP: 403

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_StartMigration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartMigration) 

# TagResource
<a name="API_TagResource"></a>

Agrega las etiquetas especificadas al recurso especificado. Si ya existe una clave de etiqueta, el valor existente se sustituye por el nuevo valor.

## Sintaxis de la solicitud
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

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

## Parámetros de solicitud del URI
<a name="API_TagResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-uri-resourceArn"></a>
El nombre de recurso de Amazon (ARN) del bot, alias de bot o canal de bot que se va a etiquetar.  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 1011.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_TagResource_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [tags](#API_TagResource_RequestSyntax) **   <a name="lex-TagResource-request-tags"></a>
La lista de las claves de etiquetas que se quieren añadir al recurso. Si ya existe una clave de etiqueta, el valor existente se sustituye por el nuevo valor.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_TagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

## Errores
<a name="API_TagResource_Errors"></a>

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_TagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Elimina las etiquetas de un bot, alias de bot o canal de bot.

## Sintaxis de la solicitud
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /tags/resourceArn?tagKeys=tagKeys HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_UntagResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-resourceArn"></a>
El nombre de recurso de Amazon (ARN) del recurso del que se van a eliminar las etiquetas.  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 1011.  
Obligatorio: sí

 ** [tagKeys](#API_UntagResource_RequestSyntax) **   <a name="lex-UntagResource-request-uri-tagKeys"></a>
Una lista de las claves de etiqueta que se eliminarán del recurso. Si una clave de etiqueta no existe en el recurso, se ignora.  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UntagResource_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_UntagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

## Errores
<a name="API_UntagResource_Errors"></a>

 ** BadRequestException **   
La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ConflictException **   
 Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.  
Código de estado HTTP: 500

 ** LimitExceededException **   
La solicitud ha superado un límite. Intente volver a realizar la solicitud.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.  
Código de estado HTTP: 404

## Véase también
<a name="API_UntagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/UntagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/UntagResource) 

# Servicio de tiempo de ejecución de Amazon Lex
<a name="API_Operations_Amazon_Lex_Runtime_Service"></a>

El Servicio de tiempo de ejecución de Amazon Lex admite las siguientes acciones:
+  [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>

Elimina la información de sesión de un bot, alias e ID de usuario especificados. 

## Sintaxis de la solicitud
<a name="API_runtime_DeleteSession_RequestSyntax"></a>

```
DELETE /bot/botName/alias/botAlias/user/userId/session HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_runtime_DeleteSession_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [botAlias](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-botAlias"></a>
El alias en uso para el bot que contiene los datos de la sesión.  
Obligatorio: sí

 ** [botName](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-botName"></a>
El nombre del bot que contiene los datos de la sesión.  
Obligatorio: sí

 ** [userId](#API_runtime_DeleteSession_RequestSyntax) **   <a name="lex-runtime_DeleteSession-request-uri-userId"></a>
El identificador del usuario que está asociado a los datos de la sesión.  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 100 caracteres.  
Patrón: `[0-9a-zA-Z._:-]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_runtime_DeleteSession_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_runtime_DeleteSession_ResponseSyntax"></a>

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

{
   "botAlias": "string",
   "botName": "string",
   "sessionId": "string",
   "userId": "string"
}
```

## Elementos de respuesta
<a name="API_runtime_DeleteSession_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [botAlias](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botAlias"></a>
El alias en uso para el bot asociado a los datos de la sesión.  
Tipo: cadena

 ** [botName](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-botName"></a>
El nombre del bot asociado a los datos de la sesión.  
Tipo: cadena

 ** [sessionId](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-sessionId"></a>
El identificador único de la sesión.  
Tipo: cadena

 ** [userId](#API_runtime_DeleteSession_ResponseSyntax) **   <a name="lex-runtime_DeleteSession-response-userId"></a>
El ID del usuario de la aplicación cliente.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 100 caracteres.  
Patrón: `[0-9a-zA-Z._:-]+` 

## Errores
<a name="API_runtime_DeleteSession_Errors"></a>

 ** BadRequestException **   
 Se ha producido un error al validar la solicitud, no hay mensajes útiles en el contexto o la compilación del bot ha fallado, está en curso o contiene cambios sin compilar.   
Código de estado HTTP: 400

 ** ConflictException **   
 Dos clientes utilizan la misma cuenta de AWS, el mismo bot de Amazon Lex y el mismo ID de usuario.   
Código de estado HTTP: 409

 ** InternalFailureException **   
Error de servicio interno. Vuelva a intentar la llamada.  
Código de estado HTTP: 500

 ** LimitExceededException **   
Se ha superado un límite.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso (como el bot o un alias de Amazon Lex) al que se hace referencia.  
Código de estado HTTP: 404

## Véase también
<a name="API_runtime_DeleteSession_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/DeleteSession) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/DeleteSession) 

# GetSession
<a name="API_runtime_GetSession"></a>

Devuelve la información de sesión de un bot, alias e ID de usuario especificados.

## Sintaxis de la solicitud
<a name="API_runtime_GetSession_RequestSyntax"></a>

```
GET /bot/botName/alias/botAlias/user/userId/session/?checkpointLabelFilter=checkpointLabelFilter HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_runtime_GetSession_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [botAlias](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botAlias"></a>
El alias en uso para el bot que contiene los datos de la sesión.  
Obligatorio: sí

 ** [botName](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-botName"></a>
El nombre del bot que contiene los datos de la sesión.  
Obligatorio: sí

 ** [checkpointLabelFilter](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-checkpointLabelFilter"></a>
La cadena que se utiliza para filtrar las intenciones devueltas en la estructura `recentIntentSummaryView`.   
Al especificar un filtro, solo se devuelven las intenciones cuyo campo `checkpointLabel` esté establecido para esa cadena.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `[a-zA-Z0-9-]+` 

 ** [userId](#API_runtime_GetSession_RequestSyntax) **   <a name="lex-runtime_GetSession-request-uri-userId"></a>
El ID del usuario de la aplicación cliente. Amazon Lex lo utiliza para identificar una conversación del usuario con el bot.   
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 100 caracteres.  
Patrón: `[0-9a-zA-Z._:-]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_runtime_GetSession_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_runtime_GetSession_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [activeContexts](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-activeContexts"></a>
Una lista de los contextos activos para la sesión. Se puede establecer un contexto cuando se cumple una intención o mediante una llamada a la operación `PostContent`, `PostText` o `PutSession`.  
Puede utilizar un contexto para controlar las intenciones que pueden acompañar una intención o para modificar la operación de la aplicación.  
Tipo: matriz de objetos [ActiveContext](API_runtime_ActiveContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 20 artículos.

 ** [dialogAction](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-dialogAction"></a>
Describe el estado actual del bot.  
Tipo: objeto [DialogAction](API_runtime_DialogAction.md)

 ** [recentIntentSummaryView](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-recentIntentSummaryView"></a>
Una matriz de información sobre las intenciones que se utilizan en la sesión. La matriz puede contener hasta tres resúmenes. Si se utilizan más de tres intenciones en la sesión, la operación `recentIntentSummaryView` contiene información sobre los tres últimos intentos empleados.  
Si establece el parámetro `checkpointLabelFilter` en la solicitud, la matriz contiene únicamente las intenciones con la etiqueta especificada.  
Tipo: matriz de objetos [IntentSummary](API_runtime_IntentSummary.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 3 elementos.

 ** [sessionAttributes](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionAttributes"></a>
Mapa de key/value pares que representan la información de contexto específica de la sesión. Contiene información de la aplicación pasada entre Amazon Lex y una aplicación cliente.  
Tipo: mapa de cadena a cadena

 ** [sessionId](#API_runtime_GetSession_ResponseSyntax) **   <a name="lex-runtime_GetSession-response-sessionId"></a>
Un identificador único de la sesión.  
Tipo: cadena

## Errores
<a name="API_runtime_GetSession_Errors"></a>

 ** BadRequestException **   
 Se ha producido un error al validar la solicitud, no hay mensajes útiles en el contexto o la compilación del bot ha fallado, está en curso o contiene cambios sin compilar.   
Código de estado HTTP: 400

 ** InternalFailureException **   
Error de servicio interno. Vuelva a intentar la llamada.  
Código de estado HTTP: 500

 ** LimitExceededException **   
Se ha superado un límite.  
Código de estado HTTP: 429

 ** NotFoundException **   
No se ha encontrado el recurso (como el bot o un alias de Amazon Lex) al que se hace referencia.  
Código de estado HTTP: 404

## Véase también
<a name="API_runtime_GetSession_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/GetSession) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/GetSession) 

# PostContent
<a name="API_runtime_PostContent"></a>

 Envía entradas de usuarios (texto o voz) a Amazon Lex. Los clientes utilizan esta API para enviar solicitudes de texto y audio a Amazon Lex en tiempo de ejecución. Amazon Lex interpreta la entrada del usuario con el modelo de machine learning que ha compilado para el bot. 

La operación `PostContent` es compatible con la entrada de audio a 8 kHz y 16 kHz. Puede utilizar audio a 8 kHz para mejorar la precisión del reconocimiento de voz en aplicaciones de audio por teléfono. 

 Como respuesta, Amazon Lex devuelve el siguiente mensaje para transmitirlo al usuario. Considere los siguientes ejemplos de mensaje: 
+  Para la entrada de usuario “Quiero una pizza”, Amazon Lex puede devolver una respuesta con un mensaje para obtener datos de ranura (por ejemplo, `PizzaSize`): “¿De qué tamaño quiere la pizza?”. 
+  Una vez que el usuario haya proporcionado toda la información necesaria para pedir la pizza, Amazon Lex puede devolver una respuesta con un mensaje para obtener la confirmación del usuario: “¿Desea pedir la pizza?”. 
+  Si el usuario responde “sí” a la pregunta de confirmación, es posible que Amazon Lex devuelva una afirmación de cierre: “Muchas gracias. Se ha realizado el pedido de su pizza de quesos”. 

 No todos los mensajes de Amazon Lex requieren una respuesta del usuario. Por ejemplo, las afirmaciones de cierre no requieren respuesta. Algunos mensajes solo requieren una respuesta afirmativa o negativa. Además de `message`, Amazon Lex proporciona contexto adicional sobre el mensaje de la respuesta para que pueda mejorar el comportamiento del cliente, como mostrar la interfaz de usuario adecuada al cliente. Considere los siguientes ejemplos: 
+  Si el mensaje tiene como objetivo obtener datos de ranuras, Amazon Lex devuelve la siguiente información de contexto: 
  +  El encabezado `x-amz-lex-dialog-state` establecido en `ElicitSlot` 
  +  El encabezado `x-amz-lex-intent-name` establecido en el nombre de la intención en el contexto actual 
  +  El encabezado `x-amz-lex-slot-to-elicit` establecido en el nombre de la ranura para el que `message` obtiene información 
  +  El encabezado `x-amz-lex-slots` establecido en una asignación de ranuras configurada para la intención con sus valores actuales 
+  Si el mensaje es una pregunta de confirmación, el encabezado `x-amz-lex-dialog-state` se establece en `Confirmation` y el encabezado `x-amz-lex-slot-to-elicit` se omite. 
+  Si el mensaje es una pregunta aclaratoria configurada para la intención, lo que indica que no se ha comprendido la intención del usuario, el encabezado `x-amz-dialog-state` se establece en `ElicitIntent` y el encabezado `x-amz-slot-to-elicit` se omite. 

 Además, Amazon Lex también devuelve los valores `sessionAttributes` específicos de la aplicación. Para obtener más información, consulte [Administración del contexto de la conversación](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html). 

## Sintaxis de la solicitud
<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
```

## Parámetros de solicitud del URI
<a name="API_runtime_PostContent_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [accept](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-accept"></a>
 Este valor se transfiere como el encabezado HTTP `Accept`.   
 El mensaje que Amazon Lex devuelve en la respuesta puede ser texto o voz basado en el valor del encabezado HTTP `Accept` de la solicitud.   
+  Si el valor es `text/plain; charset=utf-8`, Amazon Lex devuelve texto en la respuesta. 
+  Si el valor comienza por `audio/`, Amazon Lex devuelve voz en la respuesta. Amazon Lex utiliza Amazon Polly para generar la voz (con la configuración que ha especificado en el encabezado `Accept`). Por ejemplo, si especifica `audio/mpeg` como valor, Amazon Lex devuelve voz en formato MPEG.
+ Si el valor es `audio/pcm`, la voz que se devuelve es `audio/pcm` en formato little endian de 16 bits. 
+ A continuación se muestran los valores aceptados:
  + audio/mpeg
  + audio/ogg
  + audio/pcm
  + text/plain; charset=utf-8
  + audio/\$1 (el valor predeterminado es mpeg)

 ** [activeContexts](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-activeContexts"></a>
Una lista de los contextos activos para la solicitud. Un contexto se puede activar cuando se cumple una intención anterior o al incluir el contexto en la solicitud,  
Si no especifica una lista de contextos, Amazon Lex utilizará la lista de contextos actual en la sesión. Si especifica una lista vacía, se borran todos los contextos de la sesión.

 ** [botAlias](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botAlias"></a>
El alias del bot de Amazon Lex.  
Obligatorio: sí

 ** [botName](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-uri-botName"></a>
El nombre del bot de Amazon Lex.  
Obligatorio: sí

 ** [contentType](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-contentType"></a>
 Este valor se transfiere como el encabezado HTTP `Content-Type`.   
 Indica el formato de audio o de texto. El valor del encabezado debe comenzar por uno de los siguientes prefijos:   
+ En el formato PCM, los datos de audio deben estar en el orden de bytes little endian.
  + audio/l16; rate=16000; channels=1
  + audio/x-l16; sample-rate=16000; channel-count=1
  + audio/lpcm; frecuencia de muestreo = 8000; =16; recuento de canales=1; =false sample-size-bits is-big-endian 
+ Formato Opus
  + audio/ -preámbulox-cbr-opus-with; tamaño del preámbulo = 0; tasa de bits=256000; =4 frame-size-milliseconds
+ Formato de texto
  + text/plain; charset=utf-8
Obligatorio: sí

 ** [requestAttributes](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-requestAttributes"></a>
Este valor se transfiere como el encabezado HTTP `x-amz-lex-request-attributes`.  
La información específica de la solicitud que se pasa entre Amazon Lex y una aplicación cliente. El valor debe ser una asignación codificada en base64 y serializada en formato JSON con claves de cadena y valores. El tamaño total de los encabezados `requestAttributes` y `sessionAttributes` no puede superar 12 kB.  
El espacio de nombres `x-amz-lex:` está reservado para atributos especiales. No cree atributos de solicitud con el prefijo `x-amz-lex:`.  
Para obtener más información, consulte [Configuración de atributos de solicitud](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>
Este valor se transfiere como el encabezado HTTP `x-amz-lex-session-attributes`.  
La información específica de la aplicación que se pasa entre Amazon Lex y una aplicación cliente. El valor debe ser una asignación codificada en base64 y serializada en formato JSON con claves de cadena y valores. El tamaño total de los encabezados `sessionAttributes` y `requestAttributes` no puede superar 12 kB.  
Para obtener más información, consulte [Configuración de atributos de sesión](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>
El ID del usuario de la aplicación cliente. Amazon Lex lo utiliza para identificar una conversación del usuario con el bot. En tiempo de ejecución, cada solicitud debe contener el campo `userID`.  
Para decidir qué ID de usuario utilizará en la aplicación, tenga en cuenta lo siguiente.  
+ El campo `userID` no debe contener información de identificación personal del usuario como, por ejemplo, nombre, número de identificación personal u otro tipo de datos personales del usuario final.
+ Si desea que un usuario inicie una conversación en un dispositivo y esta continúe en otro dispositivo, utilice un identificador específico del usuario.
+ Si desea que el mismo usuario pueda mantener dos conversaciones independientes en dos dispositivos distintos, elija un identificador específico del dispositivo.
+ Un usuario no puede mantener dos conversaciones independientes con dos versiones distintas del mismo bot. Por ejemplo, un usuario no puede mantener una conversación con las versiones PROD y BETA del mismo bot. Si piensa que un usuario podría necesitar dos versiones distintas para mantener conversaciones (por ejemplo, para realizar pruebas), incluya el alias del bot en el ID del usuario para separar las dos conversaciones.
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 100 caracteres.  
Patrón: `[0-9a-zA-Z._:-]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_runtime_PostContent_RequestBody"></a>

La solicitud acepta los siguientes datos binarios.

 ** [inputStream](#API_runtime_PostContent_RequestSyntax) **   <a name="lex-runtime_PostContent-request-inputStream"></a>
 La entrada del usuario en formato de audio PCM u Opus o en formato de texto, tal como se describe en el encabezado HTTP `Content-Type`.   
Puede transmitir datos de audio a Amazon Lex o crear un búfer local que recopile todos los datos de audio antes de enviarlos. En general, transmitir datos de audio ofrece un mejor rendimiento que almacenar los datos en un búfer local.   
Obligatorio: sí

## Sintaxis de la respuesta
<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
```

## Elementos de respuesta
<a name="API_runtime_PostContent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

La respuesta devuelve los siguientes encabezados HTTP.

 ** [activeContexts](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-activeContexts"></a>
Una lista de los contextos activos para la sesión. Se puede establecer un contexto cuando se cumple una intención o mediante una llamada a la operación `PostContent`, `PostText` o `PutSession`.  
Puede utilizar un contexto para controlar las intenciones que pueden acompañar una intención o para modificar la operación de la aplicación.

 ** [alternativeIntents](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-alternativeIntents"></a>
Entre una y cuatro intenciones alternativas que pueden ser aplicables a la intención del usuario.  
Cada alternativa incluye una puntuación que indica la confianza de Amazon Lex en que la intención coincide con la intención del usuario. Las intenciones se ordenan por puntuación de confianza.

 ** [botVersion](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-botVersion"></a>
La versión del bot que ha respondido a la conversación. Puede utilizar esta información para determinar si una versión de un bot rinde mejor que otra versión.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[0-9]+|\$LATEST` 

 ** [contentType](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-contentType"></a>
El tipo de contenido, tal como se especifica en el encabezado HTTP `Accept` de la solicitud.

 ** [dialogState](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-dialogState"></a>
Identifica el estado actual de la interacción del usuario. Amazon Lex devuelve uno de los siguientes valores como `dialogState`. Si lo desea, el cliente puede utilizar esta información para personalizar la interfaz de usuario.   
+  `ElicitIntent`: Amazon Lex quiere obtener la intención del usuario. Considere los siguientes ejemplos: 

   Por ejemplo, un usuario puede expresar una intención (“Quiero pedir una pizza”). Si Amazon Lex no puede deducir la intención del usuario a partir de esta expresión, devolverá este estado de diálogo. 
+  `ConfirmIntent`: Amazon Lex espera “sí” o “no” como respuesta. 

  Por ejemplo, Amazon Lex solicita la confirmación del usuario antes de cumplir con una intención. El usuario, en lugar de responder “sí” o “no”, puede responder con información adicional. Por ejemplo, “sí, pero quiero una pizza con masa gruesa” o “no, quiero pedir bebida”. Amazon Lex puede procesar dicha información adicional (en estos ejemplos, actualizar la ranura tipo corteza o cambiar la intención de OrderPizza a OrderDrink). 
+  `ElicitSlot`: Amazon Lex espera el valor de una ranura para la intención actual. 

   Por ejemplo, supongamos que, en la respuesta, Amazon Lex envía el mensaje “¿De qué tamaño quiere la pizza?”. Un usuario puede responder con el valor de ranura (p. ej., “mediana”). El usuario también puede proporcionar información adicional en la respuesta (p. ej., “una pizza mediana con masa gruesa”). Amazon Lex puede procesar esta información adicional de forma adecuada. 
+  `Fulfilled`: indica que la función de Lambda ha cumplido con la intención correctamente. 
+  `ReadyForFulfillment`: indica que el cliente tiene que cumplir la solicitud. 
+  `Failed`: indica que la conversación con el usuario ha fallado. 

   Esto puede ocurrir porque el usuario no ha proporcionado una respuesta adecuada a las preguntas del servicio (puede configurar el número de veces que Amazon Lex puede solicitar cierta información al usuario), porque la función de Lambda no ha podido cumplir con la intención o por otros motivos. 
Valores válidos: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedInputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedInputTranscript"></a>
El texto que se utiliza para procesar la solicitud.  
Si la entrada era una transmisión de audio, el campo `encodedInputTranscript` contiene el texto que se ha extraído de la transmisión de audio. Este es el texto que se procesa realmente para reconocer los valores de las intenciones y slot. Puede utilizar esta información para determinar si Amazon Lex está procesando correctamente el audio que ha enviado.  
El campo `encodedInputTranscript` está codificado en base-64. Debe descodificar el campo antes de que pueda utilizar el valor.

 ** [encodedMessage](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-encodedMessage"></a>
El mensaje que se va a transmitir al usuario. El mensaje puede provenir de la configuración del bot o de una función de Lambda.  
Si la intención no está configurada con una función de Lambda o si la función de Lambda ha devuelto `Delegate` como `dialogAction.type` en su respuesta, Amazon Lex decide el siguiente procedimiento y selecciona un mensaje adecuado de la configuración del bot en función del contexto de la interacción actual. Por ejemplo, si Amazon Lex no puede entender las entradas del usuario, utiliza una pregunta aclaratoria.  
Al crear una intención, puede asignar mensajes a grupos. Si los mensajes están asignados a grupos, Amazon Lex devuelve un mensaje de cada grupo en la respuesta. El campo del mensaje es una cadena JSON con secuencias de escape que contiene los mensajes. Para obtener más información acerca de la estructura de la cadena JSON devuelta, consulte [Formatos de mensajes admitidos](howitworks-manage-prompts.md#msg-prompts-formats).  
Si la función de Lambda devuelve un mensaje, Amazon Lex lo envía al cliente en su respuesta.  
El campo `encodedMessage` está codificado en base-64. Debe descodificar el campo antes de que pueda utilizar el valor.  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 1366.

 ** [inputTranscript](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-inputTranscript"></a>
 *Este encabezado ha quedado obsoleto.*   
El texto que se utiliza para procesar la solicitud.  
Solo puede utilizar este campo en las configuraciones regionales de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR e it-IT. En el resto de configuraciones regionales, el campo `inputTranscript` es nulo. En su lugar, debe utilizar el campo `encodedInputTranscript`.  
Si la entrada era una transmisión de audio, el campo `inputTranscript` contiene el texto que se ha extraído de la transmisión de audio. Este es el texto que se procesa realmente para reconocer los valores de las intenciones y slot. Puede utilizar esta información para determinar si Amazon Lex está procesando correctamente el audio que ha enviado.

 ** [intentName](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-intentName"></a>
La intención del usuario actual de la que Amazon Lex está pendiente.

 ** [message](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-message"></a>
 *Este encabezado ha quedado obsoleto.*   
Solo puede utilizar este campo en las configuraciones regionales de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR e it-IT. En el resto de configuraciones regionales, el campo `message` es nulo. En su lugar, debe utilizar el campo `encodedMessage`.  
El mensaje que se va a transmitir al usuario. El mensaje puede provenir de la configuración del bot o de una función de Lambda.  
Si la intención no está configurada con una función de Lambda o si la función de Lambda ha devuelto `Delegate` como `dialogAction.type` en su respuesta, Amazon Lex decide el siguiente procedimiento y selecciona un mensaje adecuado de la configuración del bot en función del contexto de la interacción actual. Por ejemplo, si Amazon Lex no puede entender las entradas del usuario, utiliza una pregunta aclaratoria.  
Al crear una intención, puede asignar mensajes a grupos. Si los mensajes están asignados a grupos, Amazon Lex devuelve un mensaje de cada grupo en la respuesta. El campo del mensaje es una cadena JSON con secuencias de escape que contiene los mensajes. Para obtener más información acerca de la estructura de la cadena JSON devuelta, consulte [Formatos de mensajes admitidos](howitworks-manage-prompts.md#msg-prompts-formats).  
Si la función de Lambda devuelve un mensaje, Amazon Lex lo envía al cliente en su respuesta.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.

 ** [messageFormat](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-messageFormat"></a>
El formato del mensaje de respuesta. Uno de los valores siguientes:  
+  `PlainText`: el mensaje contiene texto UTF-8 sin formato.
+  `CustomPayload`: el mensaje está en un formato personalizado del cliente.
+  `SSML`: el mensaje contiene texto con formato para salida de voz.
+  `Composite`: el mensaje contiene un objeto JSON con secuencias de escape que contiene uno o más mensajes de los grupos a los que se asignaron cuando se creó la intención.
Valores válidos: `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-nluIntentConfidence"></a>
Proporciona una puntuación que indica el grado de confianza de Amazon Lex en lo que respecta a la capacidad de una intención devuelta para satisfacer las expectativas del usuario. La puntuación es un valor entre 0,0 y 1,0.  
La puntuación es relativa, no absoluta. La puntuación puede cambiar en función de las mejoras de Amazon Lex. 

 ** [sentimentResponse](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sentimentResponse"></a>
La opinión expresada en un enunciado.  
Cuando el bot está configurado para enviar enunciados a Amazon Comprehend con el fin de analizar opiniones, este campo contiene el resultado del análisis.

 ** [sessionAttributes](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionAttributes"></a>
 Mapa de key/value pares que representa la información contextual específica de la sesión. 

 ** [sessionId](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-sessionId"></a>
El identificador único de la sesión.

 ** [slots](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slots"></a>
Una asignación de cero o más ranuras de intención (pares nombre/valor) que Amazon Lex ha detectado a partir de la entrada del usuario durante la conversación. El campo está codificado en base-64.  
Amazon Lex crea una lista de resoluciones que contiene posibles valores para una ranura. El valor que devuelve viene determinado por el valor `valueSelectionStrategy` seleccionado cuando se creó o actualizó el tipo de ranura. Si `valueSelectionStrategy` se establece en `ORIGINAL_VALUE`, se devuelve el valor que proporciona el usuario, en caso de que el valor del usuario sea similar a los valores de la ranura. Si `valueSelectionStrategy` se establece en `TOP_RESOLUTION`, Amazon Lex devuelve el primer valor de la lista de resoluciones o, si no hay ninguna lista de resoluciones, un valor nulo. Si no especifica un valor `valueSelectionStrategy`, el valor predeterminado es `ORIGINAL_VALUE`.

 ** [slotToElicit](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-slotToElicit"></a>
 Si el valor `dialogState` es `ElicitSlot`, devuelve el nombre de la ranura para la que Amazon Lex quiere obtener un valor. 

La respuesta devuelve lo siguiente como el cuerpo HTTP.

 ** [audioStream](#API_runtime_PostContent_ResponseSyntax) **   <a name="lex-runtime_PostContent-response-audioStream"></a>
La solicitud (o afirmación) que se transmite al usuario. Depende de la configuración del bot y el contexto. Por ejemplo, si Amazon Lex no ha comprendido la intención del usuario, envía el valor `clarificationPrompt` configurado para el bot. Si la intención requiere confirmación antes de llevar a cabo la acción de cumplimiento, envía `confirmationPrompt`. Otro ejemplo: supongamos que la función de Lambda ha cumplido la intención satisfactoriamente y ha enviado un mensaje para transmitirlo al usuario. A continuación, Amazon Lex envía el mensaje en la respuesta. 

## Errores
<a name="API_runtime_PostContent_Errors"></a>

 ** BadGatewayException **   
El bot de Amazon Lex aún se está compilando o uno de los servicios dependientes (Amazon Polly o AWS Lambda) ha fallado debido a un error de servicio interno.  
Código de estado HTTP: 502

 ** BadRequestException **   
 Se ha producido un error al validar la solicitud, no hay mensajes útiles en el contexto o la compilación del bot ha fallado, está en curso o contiene cambios sin compilar.   
Código de estado HTTP: 400

 ** ConflictException **   
 Dos clientes utilizan la misma cuenta de AWS, el mismo bot de Amazon Lex y el mismo ID de usuario.   
Código de estado HTTP: 409

 ** DependencyFailedException **   
 Una de las dependencias, como AWS Lambda o Amazon Polly, ha generado una excepción. Por ejemplo:   
+ Si Amazon Lex no tiene permisos suficientes para llamar a una función de Lambda
+ Si una función de Lambda tarda más de 30 segundos en ejecutarse
+ Si una función de Lambda de cumplimiento devuelve una acción de diálogo `Delegate` sin eliminar ningún valor de ranura.
Código de estado HTTP: 424

 ** InternalFailureException **   
Error de servicio interno. Vuelva a intentar la llamada.  
Código de estado HTTP: 500

 ** LimitExceededException **   
Se ha superado un límite.  
Código de estado HTTP: 429

 ** LoopDetectedException **   
Esta excepción no se utiliza.  
Código de estado HTTP: 508

 ** NotAcceptableException **   
El encabezado de aceptación de la solicitud no cuenta con un valor válido.  
Código de estado HTTP: 406

 ** NotFoundException **   
No se ha encontrado el recurso (como el bot o un alias de Amazon Lex) al que se hace referencia.  
Código de estado HTTP: 404

 ** RequestTimeoutException **   
El mensaje de voz de la entrada es demasiado largo.  
Código de estado HTTP: 408

 ** UnsupportedMediaTypeException **   
El encabezado Content-Type (API `PostContent`) tiene un valor no válido.   
Código de estado HTTP: 415

## Ejemplos
<a name="API_runtime_PostContent_Examples"></a>

### Ejemplo 1
<a name="API_runtime_PostContent_Example_1"></a>

 En esta solicitud, la URI identifica un bot (Traffic), una versión del bot (\$1LATEST) y el nombre del usuario final (someuser). El encabezado `Content-Type` identifica el formato del audio en el cuerpo. Amazon Lex también admite otros formatos. Para convertir audio de un formato a otro, si es necesario, puede utilizar el software de código abierto SoX. Para especificar el formato en el que desea obtener la respuesta, agregue el encabezado HTTP `Accept`. 

 En la respuesta, el encabezado `x-amz-lex-message` muestra la respuesta que ha devuelto Amazon Lex. A continuación, el cliente puede enviar esta respuesta al usuario. El mismo mensaje se envía en audio/MPEG formato mediante codificación fragmentada (según se solicite). 

#### Solicitud de muestra
<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]"
…
```

#### Respuesta de ejemplo
<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
…
```

## Véase también
<a name="API_runtime_PostContent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostContent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostContent) 

# PostText
<a name="API_runtime_PostText"></a>

Envía entradas de usuarios a Amazon Lex. Las aplicaciones cliente pueden utilizar esta API para enviar solicitudes a Amazon Lex en tiempo de ejecución. A continuación, Amazon Lex interpreta la entrada del usuario con el modelo de machine learning que ha compilado para el bot. 

 Como respuesta, Amazon Lex devuelve el siguiente valor `message` al usuario para transmitir al usuario un valor `responseCard` opcional que se muestra. Considere los siguientes ejemplos de mensaje: 
+  Si un usuario escribe «Me gustaría una pizza», Amazon Lex podría devolver una respuesta con un mensaje con datos de espacio (por ejemplo, PizzaSize): «¿Qué tamaño de pizza quieres?» 
+  Una vez que el usuario haya proporcionado toda la información necesaria para pedir la pizza, Amazon Lex puede devolver una respuesta con un mensaje para obtener la confirmación del usuario: “¿Desea continuar con el pedido?”. 
+  Si el usuario responde “sí” a una pregunta de confirmación, es posible que Amazon Lex devuelva una afirmación de cierre: “Muchas gracias. Se ha realizado el pedido de su pizza de quesos”. 

 No todos los mensajes de Amazon Lex requieren una respuesta del usuario. Por ejemplo, las afirmaciones de cierre no requieren respuesta. Algunos mensajes solo requieren una respuesta afirmativa o negativa. Además de `message`, Amazon Lex proporciona contexto adicional sobre el mensaje de la respuesta para que pueda mejorar el comportamiento del cliente, como mostrar la interfaz de usuario adecuada al cliente. Se trata de los campos `slotToElicit`, `dialogState`, `intentName` y `slots` en la respuesta. Considere los siguientes ejemplos: 
+ Si el mensaje tiene como objetivo obtener datos de ranuras, Amazon Lex devuelve la siguiente información de contexto:
  +  `dialogState`establecido en ElicitSlot 
  +  `intentName` establecido en el nombre de la intención en el contexto actual 
  +  `slotToElicit` establecido en el nombre de la ranura para el que `message` obtiene información 
  +  `slots` establecido en una asignación de ranuras configurada para la intención con sus valores conocidos 
+  Si el mensaje es una solicitud de confirmación, `dialogState` se establece en ConfirmIntent y `SlotToElicit` se establece en nulo. 
+ Si el mensaje es una solicitud de aclaración (configurada para la intención) que indica que el usuario no entiende la intención, `dialogState` se establece en ElicitIntent y `slotToElicit` se establece en nulo. 

 Además, Amazon Lex también devuelve los valores `sessionAttributes` específicos de la aplicación. Para obtener más información, consulte [Administración del contexto de la conversación](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html). 

## Sintaxis de la solicitud
<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" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_runtime_PostText_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [botAlias](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botAlias"></a>
El alias del bot de Amazon Lex.  
Obligatorio: sí

 ** [botName](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-botName"></a>
El nombre del bot de Amazon Lex.  
Obligatorio: sí

 ** [userId](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-uri-userId"></a>
El ID del usuario de la aplicación cliente. Amazon Lex lo utiliza para identificar una conversación del usuario con el bot. En tiempo de ejecución, cada solicitud debe contener el campo `userID`.  
Para decidir qué ID de usuario utilizará en la aplicación, tenga en cuenta lo siguiente.  
+ El campo `userID` no debe contener información de identificación personal del usuario como, por ejemplo, nombre, número de identificación personal u otro tipo de datos personales del usuario final.
+ Si desea que un usuario inicie una conversación en un dispositivo y esta continúe en otro dispositivo, utilice un identificador específico del usuario.
+ Si desea que el mismo usuario pueda mantener dos conversaciones independientes en dos dispositivos distintos, elija un identificador específico del dispositivo.
+ Un usuario no puede mantener dos conversaciones independientes con dos versiones distintas del mismo bot. Por ejemplo, un usuario no puede mantener una conversación con las versiones PROD y BETA del mismo bot. Si piensa que un usuario podría necesitar dos versiones distintas para mantener conversaciones (por ejemplo, para realizar pruebas), incluya el alias del bot en el ID del usuario para separar las dos conversaciones.
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 100 caracteres.  
Patrón: `[0-9a-zA-Z._:-]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_runtime_PostText_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [activeContexts](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-activeContexts"></a>
Una lista de los contextos activos para la solicitud. Un contexto se puede activar cuando se cumple una intención anterior o al incluir el contexto en la solicitud,  
Si no especifica una lista de contextos, Amazon Lex utilizará la lista de contextos actual en la sesión. Si especifica una lista vacía, se borran todos los contextos de la sesión.  
Tipo: matriz de objetos [ActiveContext](API_runtime_ActiveContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 20 artículos.  
Obligatorio: no

 ** [inputText](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-inputText"></a>
El texto que ha introducido el usuario (Amazon Lex interpreta este texto).  
Cuando utiliza la CLI de AWS, no puede pasar una URL en el parámetro `--input-text`. En su lugar, pase la URL con el parámetro `--cli-input-json`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Obligatorio: sí

 ** [requestAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-requestAttributes"></a>
La información específica de la solicitud que se pasa entre Amazon Lex y una aplicación cliente.  
El espacio de nombres `x-amz-lex:` está reservado para atributos especiales. No cree atributos de solicitud con el prefijo `x-amz-lex:`.  
Para obtener más información, consulte [Configuración de atributos de solicitud](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs).  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [sessionAttributes](#API_runtime_PostText_RequestSyntax) **   <a name="lex-runtime_PostText-request-sessionAttributes"></a>
La información específica de la aplicación que se pasa entre Amazon Lex y una aplicación cliente.  
Para obtener más información, consulte [Configuración de atributos de sesión](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs).  
Tipo: mapa de cadena a cadena  
Obligatorio: no

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_runtime_PostText_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [activeContexts](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-activeContexts"></a>
Una lista de los contextos activos para la sesión. Se puede establecer un contexto cuando se cumple una intención o mediante una llamada a la operación `PostContent`, `PostText` o `PutSession`.  
Puede utilizar un contexto para controlar las intenciones que pueden acompañar una intención o para modificar la operación de la aplicación.  
Tipo: matriz de objetos [ActiveContext](API_runtime_ActiveContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 20 artículos.

 ** [alternativeIntents](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-alternativeIntents"></a>
Entre una y cuatro intenciones alternativas que pueden ser aplicables a la intención del usuario.  
Cada alternativa incluye una puntuación que indica la confianza de Amazon Lex en que la intención coincide con la intención del usuario. Las intenciones se ordenan por puntuación de confianza.  
Tipo: matriz de objetos [PredictedIntent](API_runtime_PredictedIntent.md)  
Miembros de la matriz: número máximo de 4 elementos.

 ** [botVersion](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-botVersion"></a>
La versión del bot que ha respondido a la conversación. Puede utilizar esta información para determinar si una versión de un bot rinde mejor que otra versión.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.  
Patrón: `[0-9]+|\$LATEST` 

 ** [dialogState](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-dialogState"></a>
 Identifica el estado actual de la interacción del usuario. Amazon Lex devuelve uno de los siguientes valores como `dialogState`. Si lo desea, el cliente puede utilizar esta información para personalizar la interfaz de usuario.   
+  `ElicitIntent`: Amazon Lex quiere obtener la intención del usuario. 

  Por ejemplo, un usuario puede expresar una intención (“Quiero pedir una pizza”). Si Amazon Lex no puede deducir la intención del usuario a partir de esta expresión, devolverá este dialogState.
+  `ConfirmIntent`: Amazon Lex espera “sí” o “no” como respuesta. 

   Por ejemplo, Amazon Lex solicita la confirmación del usuario antes de cumplir con una intención. 

  El usuario, en lugar de responder “sí” o “no”, puede responder con información adicional. Por ejemplo, “sí, pero quiero una pizza con masa gruesa” o “no, quiero pedir bebida”. Amazon Lex puede procesar dicha información adicional (en estos ejemplos, actualizar el valor de la ranura tipo masa o cambiar la intención de OrderPizza a OrderDrink).
+  `ElicitSlot`: Amazon Lex espera el valor de una ranura para la intención actual. 

  Por ejemplo, supongamos que, en la respuesta, Amazon Lex envía el mensaje “¿De qué tamaño quiere la pizza?”. Un usuario puede responder con el valor de ranura (p. ej., “mediana”). El usuario también puede proporcionar información adicional en la respuesta (p. ej., “una pizza mediana con masa gruesa”). Amazon Lex puede procesar esta información adicional de forma adecuada. 
+  `Fulfilled`: indica que la función de Lambda configurada para la intención ha cumplido con la intención correctamente. 
+  `ReadyForFulfillment`: indica que el cliente tiene que cumplir la intención. 
+  `Failed`: indica que la conversación con el usuario ha fallado. 

   Esto puede ocurrir porque el usuario no ha proporcionado una respuesta adecuada a las preguntas del servicio (puede configurar el número de veces que Amazon Lex puede solicitar cierta información al usuario), porque la función de Lambda no ha podido cumplir con la intención o por otros motivos. 
Tipo: cadena  
Valores válidos: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [intentName](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-intentName"></a>
La intención del usuario actual de la que Amazon Lex está pendiente.  
Tipo: cadena

 ** [message](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-message"></a>
El mensaje que se va a transmitir al usuario. El mensaje puede provenir de la configuración del bot o de una función de Lambda.  
Si la intención no está configurada con una función de Lambda o si la función de Lambda ha devuelto `Delegate` como `dialogAction.type` en su respuesta, Amazon Lex decide el siguiente procedimiento y selecciona un mensaje adecuado de la configuración del bot en función del contexto de la interacción actual. Por ejemplo, si Amazon Lex no puede entender las entradas del usuario, utiliza una pregunta aclaratoria.  
Al crear una intención, puede asignar mensajes a grupos. Si los mensajes están asignados a grupos, Amazon Lex devuelve un mensaje de cada grupo en la respuesta. El campo del mensaje es una cadena JSON con secuencias de escape que contiene los mensajes. Para obtener más información acerca de la estructura de la cadena JSON devuelta, consulte [Formatos de mensajes admitidos](howitworks-manage-prompts.md#msg-prompts-formats).  
Si la función de Lambda devuelve un mensaje, Amazon Lex lo envía al cliente en su respuesta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.

 ** [messageFormat](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-messageFormat"></a>
El formato del mensaje de respuesta. Uno de los valores siguientes:  
+  `PlainText`: el mensaje contiene texto UTF-8 sin formato.
+  `CustomPayload`: el mensaje tiene el formato personalizado que define la función de Lambda.
+  `SSML`: el mensaje contiene texto con formato para salida de voz.
+  `Composite`: el mensaje contiene un objeto JSON con secuencias de escape que contiene uno o más mensajes de los grupos a los que se asignaron cuando se creó la intención.
Tipo: cadena  
Valores válidos: `PlainText | CustomPayload | SSML | Composite` 

 ** [nluIntentConfidence](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-nluIntentConfidence"></a>
Proporciona una puntuación que indica el grado de confianza de Amazon Lex en lo que respecta a la capacidad de una intención devuelta para satisfacer las expectativas del usuario. La puntuación es un valor entre 0,0 y 1,0. Para obtener más información, consulte [Puntuaciones de confianza](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html).  
La puntuación es relativa, no absoluta. La puntuación puede cambiar en función de las mejoras de Amazon Lex.  
Tipo: objeto [IntentConfidence](API_runtime_IntentConfidence.md)

 ** [responseCard](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-responseCard"></a>
Representa las opciones con las que el usuario puede responder a la pregunta actual. La tarjeta de respuesta puede proceder de la configuración del bot (en la consola de Amazon Lex, seleccione el botón de configuración situado junto a una ranura) o de un enlace de código (función de Lambda).   
Tipo: objeto [ResponseCard](API_runtime_ResponseCard.md)

 ** [sentimentResponse](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sentimentResponse"></a>
La opinión expresada en un enunciado.  
Cuando el bot está configurado para enviar enunciados a Amazon Comprehend con el fin de analizar opiniones, este campo contiene el resultado del análisis.  
Tipo: objeto [SentimentResponse](API_runtime_SentimentResponse.md)

 ** [sessionAttributes](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sessionAttributes"></a>
Una asignación de pares clave-valor que representa la información de contexto específica de la sesión.  
Tipo: mapa de cadena a cadena

 ** [sessionId](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-sessionId"></a>
Un identificador único de la sesión.  
Tipo: cadena

 ** [slots](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slots"></a>
 Las ranuras de intención que Amazon Lex ha detectado a partir de la entrada del usuario en la conversación.   
Amazon Lex crea una lista de resoluciones que contiene posibles valores para una ranura. El valor que devuelve viene determinado por el valor `valueSelectionStrategy` seleccionado cuando se creó o actualizó el tipo de ranura. Si `valueSelectionStrategy` se establece en `ORIGINAL_VALUE`, se devuelve el valor que proporciona el usuario, en caso de que el valor del usuario sea similar a los valores de la ranura. Si `valueSelectionStrategy` se establece en `TOP_RESOLUTION`, Amazon Lex devuelve el primer valor de la lista de resoluciones o, si no hay ninguna lista de resoluciones, un valor nulo. Si no especifica un valor `valueSelectionStrategy`, el valor predeterminado es `ORIGINAL_VALUE`.  
Tipo: mapa de cadena a cadena

 ** [slotToElicit](#API_runtime_PostText_ResponseSyntax) **   <a name="lex-runtime_PostText-response-slotToElicit"></a>
Si el valor `dialogState` es `ElicitSlot`, devuelve el nombre de la ranura para que Amazon Lex quiere obtener un valor.   
Tipo: cadena

## Errores
<a name="API_runtime_PostText_Errors"></a>

 ** BadGatewayException **   
El bot de Amazon Lex aún se está compilando o uno de los servicios dependientes (Amazon Polly o AWS Lambda) ha fallado debido a un error de servicio interno.  
Código de estado HTTP: 502

 ** BadRequestException **   
 Se ha producido un error al validar la solicitud, no hay mensajes útiles en el contexto o la compilación del bot ha fallado, está en curso o contiene cambios sin compilar.   
Código de estado HTTP: 400

 ** ConflictException **   
 Dos clientes utilizan la misma cuenta de AWS, el mismo bot de Amazon Lex y el mismo ID de usuario.   
Código de estado HTTP: 409

 ** DependencyFailedException **   
 Una de las dependencias, como AWS Lambda o Amazon Polly, ha generado una excepción. Por ejemplo:   
+ Si Amazon Lex no tiene permisos suficientes para llamar a una función de Lambda
+ Si una función de Lambda tarda más de 30 segundos en ejecutarse
+ Si una función de Lambda de cumplimiento devuelve una acción de diálogo `Delegate` sin eliminar ningún valor de ranura.
Código de estado HTTP: 424

 ** InternalFailureException **   
Error de servicio interno. Vuelva a intentar la llamada.  
Código de estado HTTP: 500

 ** LimitExceededException **   
Se ha superado un límite.  
Código de estado HTTP: 429

 ** LoopDetectedException **   
Esta excepción no se utiliza.  
Código de estado HTTP: 508

 ** NotFoundException **   
No se ha encontrado el recurso (como el bot o un alias de Amazon Lex) al que se hace referencia.  
Código de estado HTTP: 404

## Véase también
<a name="API_runtime_PostText_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostText) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostText) 

# PutSession
<a name="API_runtime_PutSession"></a>

Crea una nueva sesión o modifica una sesión existente con un bot de Amazon Lex. Utilice esta operación para permitir que la aplicación establezca el estado del bot.

Para obtener más información, consulte [Administración de las sesiones](https://docs.aws.amazon.com/lex/latest/dg/how-session-api.html).

## Sintaxis de la solicitud
<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" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_runtime_PutSession_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [accept](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-accept"></a>
El mensaje que Amazon Lex devuelve en la respuesta puede ser texto o voz basado en el valor de este campo.  
+ Si el valor es `text/plain; charset=utf-8`, Amazon Lex devuelve texto en la respuesta.
+ Si el valor comienza por `audio/`, Amazon Lex devuelve voz en la respuesta. Amazon Lex utiliza Amazon Polly para generar la voz en la configuración que ha especificado. Por ejemplo, si especifica `audio/mpeg` como valor, Amazon Lex devuelve voz en formato MPEG.
+ Si el valor es `audio/pcm`, la voz que se devuelve es `audio/pcm` en formato little endian de 16 bits.
+ A continuación se muestran los valores aceptados:
  +  `audio/mpeg` 
  +  `audio/ogg` 
  +  `audio/pcm` 
  +  `audio/*` (el valor predeterminado es mpeg)
  +  `text/plain; charset=utf-8` 

 ** [botAlias](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-botAlias"></a>
El alias en uso para el bot que contiene los datos de la sesión.  
Obligatorio: sí

 ** [botName](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-botName"></a>
El nombre del bot que contiene los datos de la sesión.  
Obligatorio: sí

 ** [userId](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-uri-userId"></a>
El ID del usuario de la aplicación cliente. Amazon Lex lo utiliza para identificar una conversación del usuario con el bot.   
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 100 caracteres.  
Patrón: `[0-9a-zA-Z._:-]+`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_runtime_PutSession_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [activeContexts](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-activeContexts"></a>
Una lista de los contextos activos para la solicitud. Un contexto se puede activar cuando se cumple una intención anterior o al incluir el contexto en la solicitud,  
Si no especifica una lista de contextos, Amazon Lex utilizará la lista de contextos actual en la sesión. Si especifica una lista vacía, se borran todos los contextos de la sesión.  
Tipo: matriz de objetos [ActiveContext](API_runtime_ActiveContext.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 20 artículos.  
Obligatorio: no

 ** [dialogAction](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-dialogAction"></a>
Establece la siguiente acción que el bot debería llevar a cabo para cumplir con la conversación.  
Tipo: objeto [DialogAction](API_runtime_DialogAction.md)  
Obligatorio: no

 ** [recentIntentSummaryView](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-recentIntentSummaryView"></a>
Un resumen de los incidentes recientes en el bot. Puede utilizar la vista de resumen de intenciones para establecer una etiqueta de punto de control en una intención y modificar los atributos de intenciones. También puede utilizarla para eliminar o agregar objetos de resumen de intención a la lista.  
La intención que modifique o agregue a la lista debe tener sentido para el bot. Por ejemplo, el nombre de la intención debe ser válido para el bot. Debe proporcionar valores válidos para lo siguiente:  
+  `intentName` 
+ nombres de ranuras
+  `slotToElict` 
Si envía el parámetro `recentIntentSummaryView` en una solicitud `PutSession`, el contenido de la nueva vista de resumen reemplaza la vista anterior. Por ejemplo, si una solicitud `GetSession` devuelve tres intenciones en la vista de resumen y puede llamar a `PutSession` con una intención en la vista de resumen, la siguiente llamada a `GetSession` devolverá únicamente una intención.  
Tipo: matriz de objetos [IntentSummary](API_runtime_IntentSummary.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 3 elementos.  
Obligatorio: no

 ** [sessionAttributes](#API_runtime_PutSession_RequestSyntax) **   <a name="lex-runtime_PutSession-request-sessionAttributes"></a>
Mapa de key/value pares que representan la información de contexto específica de la sesión. Contiene información de la aplicación pasada entre Amazon Lex y una aplicación cliente.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

## Sintaxis de la respuesta
<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
```

## Elementos de respuesta
<a name="API_runtime_PutSession_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

La respuesta devuelve los siguientes encabezados HTTP.

 ** [activeContexts](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-activeContexts"></a>
Una lista de los contextos activos para la sesión.

 ** [contentType](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-contentType"></a>
El tipo de contenido, tal como se especifica en el encabezado HTTP `Accept` de la solicitud.

 ** [dialogState](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-dialogState"></a>
  
+  `ConfirmIntent`: Amazon Lex espera “sí” o “no” como respuesta para confirmar la intención antes de cumplirla.
+  `ElicitIntent`: Amazon Lex quiere obtener la intención del usuario.
+  `ElicitSlot`: Amazon Lex espera el valor de una ranura para la intención actual.
+  `Failed`: indica que la conversación con el usuario ha fallado. Esto puede ocurrir porque el usuario no ha proporcionado una respuesta adecuada a las preguntas del servicio, porque la función de Lambda no ha podido cumplir con la intención o por otros motivos.
+  `Fulfilled`: indica que la función de Lambda ha cumplido con la intención satisfactoriamente.
+  `ReadyForFulfillment`: indica que el cliente tiene que cumplir la intención.
Valores válidos: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` 

 ** [encodedMessage](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-encodedMessage"></a>
El siguiente mensaje que debería mostrarse al usuario.  
El campo `encodedMessage` está codificado en base-64. Debe descodificar el campo antes de que pueda utilizar el valor.  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 1366.

 ** [intentName](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-intentName"></a>
El nombre de la intención actual.

 ** [message](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-message"></a>
 *Este encabezado ha quedado obsoleto.*   
El siguiente mensaje que debería mostrarse al usuario.  
Solo puede utilizar este campo en las configuraciones regionales de-DE, en-AU, en-GB, en-US, es-419, es-ES, es-US, fr-CA, fr-FR e it-IT. En el resto de configuraciones regionales, el campo `message` es nulo. En su lugar, debe utilizar el campo `encodedMessage`.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.

 ** [messageFormat](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-messageFormat"></a>
El formato del mensaje de respuesta. Uno de los valores siguientes:  
+  `PlainText`: el mensaje contiene texto UTF-8 sin formato.
+  `CustomPayload`: el mensaje está en un formato personalizado del cliente.
+  `SSML`: el mensaje contiene texto con formato para salida de voz.
+  `Composite`: el mensaje contiene un objeto JSON con secuencias de escape que contiene uno o más mensajes de los grupos a los que se asignaron cuando se creó la intención.
Valores válidos: `PlainText | CustomPayload | SSML | Composite` 

 ** [sessionAttributes](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionAttributes"></a>
Mapa de key/value pares que representan información de contexto específica de la sesión.

 ** [sessionId](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-sessionId"></a>
Un identificador único de la sesión.

 ** [slots](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slots"></a>
Una asignación de cero o más ranuras de intención que Amazon Lex ha detectado a partir de la entrada del usuario durante la conversación.  
Amazon Lex crea una lista de resoluciones que contiene posibles valores para una ranura. El valor que devuelve viene determinado por el valor `valueSelectionStrategy` seleccionado cuando se creó o actualizó el tipo de ranura. Si `valueSelectionStrategy` se establece en `ORIGINAL_VALUE`, se devuelve el valor que proporciona el usuario, en caso de que el valor del usuario sea similar a los valores de la ranura. Si `valueSelectionStrategy` se establece en `TOP_RESOLUTION`, Amazon Lex devuelve el primer valor de la lista de resoluciones o, si no hay ninguna lista de resoluciones, un valor nulo. Si no especifica un valor `valueSelectionStrategy`, el valor predeterminado es `ORIGINAL_VALUE`. 

 ** [slotToElicit](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-slotToElicit"></a>
Si `dialogState` es `ElicitSlot`, devuelve el nombre de la ranura para que Amazon Lex quiere obtener un valor.

La respuesta devuelve lo siguiente como el cuerpo HTTP.

 ** [audioStream](#API_runtime_PutSession_ResponseSyntax) **   <a name="lex-runtime_PutSession-response-audioStream"></a>
La versión del audio del mensaje que se transmite al usuario.

## Errores
<a name="API_runtime_PutSession_Errors"></a>

 ** BadGatewayException **   
El bot de Amazon Lex aún se está compilando o uno de los servicios dependientes (Amazon Polly o AWS Lambda) ha fallado debido a un error de servicio interno.  
Código de estado HTTP: 502

 ** BadRequestException **   
 Se ha producido un error al validar la solicitud, no hay mensajes útiles en el contexto o la compilación del bot ha fallado, está en curso o contiene cambios sin compilar.   
Código de estado HTTP: 400

 ** ConflictException **   
 Dos clientes utilizan la misma cuenta de AWS, el mismo bot de Amazon Lex y el mismo ID de usuario.   
Código de estado HTTP: 409

 ** DependencyFailedException **   
 Una de las dependencias, como AWS Lambda o Amazon Polly, ha generado una excepción. Por ejemplo:   
+ Si Amazon Lex no tiene permisos suficientes para llamar a una función de Lambda
+ Si una función de Lambda tarda más de 30 segundos en ejecutarse
+ Si una función de Lambda de cumplimiento devuelve una acción de diálogo `Delegate` sin eliminar ningún valor de ranura.
Código de estado HTTP: 424

 ** InternalFailureException **   
Error de servicio interno. Vuelva a intentar la llamada.  
Código de estado HTTP: 500

 ** LimitExceededException **   
Se ha superado un límite.  
Código de estado HTTP: 429

 ** NotAcceptableException **   
El encabezado de aceptación de la solicitud no cuenta con un valor válido.  
Código de estado HTTP: 406

 ** NotFoundException **   
No se ha encontrado el recurso (como el bot o un alias de Amazon Lex) al que se hace referencia.  
Código de estado HTTP: 404

## Véase también
<a name="API_runtime_PutSession_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PutSession) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PutSession)