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. # PutSlotType 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 ``` 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 La solicitud utiliza los siguientes parámetros URI. ** [name](#API_PutSlotType_RequestSyntax) ** 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 La solicitud acepta los siguientes datos en formato JSON. ** [checksum](#API_PutSlotType_RequestSyntax) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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 ``` 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 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) ** La suma de comprobación de la versión `$LATEST` del tipo de ranura. Tipo: cadena ** [createdDate](#API_PutSlotType_ResponseSyntax) ** La fecha de creación del tipo de ranura. Tipo: marca temporal ** [createVersion](#API_PutSlotType_ResponseSyntax) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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) ** 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 ** 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 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)