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.

# 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)