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.

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