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.

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