PutBotAlias - Amazon Lex V1
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Si utiliza Amazon Lex V2, consulte la guía de Amazon Lex V2.

 

Si utiliza Amazon Lex V1, le recomendamos que actualice los bots a Amazon Lex V2. Hemos dejado de agregar nuevas características a V1, por lo que recomendamos encarecidamente utilizar V2 para todos los nuevos bots.

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

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.

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

Sintaxis de la solicitud

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

La solicitud utiliza los siguientes parámetros URI.

botName

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

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

La solicitud acepta los siguientes datos en formato JSON.

botVersion

La versión del bot.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.

Patrón: \$LATEST|[0-9]+

Obligatorio: sí

checksum

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

La configuración de los registros de conversaciones para el alias.

Tipo: objeto ConversationLogsRequest

Obligatorio: no

description

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

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

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

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

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

El servicio devuelve los datos siguientes en formato JSON.

botName

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

La versión del bot a la que apunta el alias.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.

Patrón: \$LATEST|[0-9]+

checksum

La suma de comprobación para la versión actual del alias.

Tipo: cadena

conversationLogs

La configuración que determina cómo Amazon Lex utiliza los registros de conversaciones para el alias.

Tipo: objeto ConversationLogsResponse

createdDate

La fecha de creación del alias del bot.

Tipo: marca temporal

description

Una descripción del alias.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

lastUpdatedDate

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

El nombre del alias.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.

Patrón: ^([A-Za-z]_?)+$

tags

Una lista de etiquetas asociadas a un bot.

Tipo: matriz de objetos Tag

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

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 AWS SDK específicos del idioma, consulta lo siguiente: