PutBotAlias

Crea un alias per la versione specificata del bot o sostituisce un alias per il bot specificato. Per cambiare la versione del bot a cui punta l'alias, sostituisci l'alias. Per ulteriori informazioni sugli alias, consultare Funzione Versioni multiple e alias.

Questa operazione richiede le autorizzazioni per l'operazione lex:PutBotAlias.

Sintassi della richiesta

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"
      }
   ]
}

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

botName

Il nome del bot.

Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.

Modello: ^([A-Za-z]_?)+$

Campo obbligatorio: sì

name

Nome dell'alias. Il nome non fa distinzione tra maiuscole e minuscole.

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.

Modello: ^([A-Za-z]_?)+$

Campo obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

botVersion

La versione del bot.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: \$LATEST|[0-9]+

Campo obbligatorio: sì

checksum

Identifica una revisione specifica della $LATEST versione.

Quando crei un nuovo alias bot, lascia il checksum campo vuoto. Se si specifica un checksum si ottiene un'BadRequestExceptioneccezione.

Quando desideri aggiornare un alias bot, imposta il checksum campo sul checksum della revisione più recente della versione. $LATEST Se non specifichi il checksum campo o se il checksum non corrisponde alla $LATEST versione, ottieni un'eccezione. PreconditionFailedException

▬Tipo: stringa

Campo obbligatorio: no

conversationLogs

Impostazioni per i registri delle conversazioni per l'alias.

Tipo: oggetto ConversationLogsRequest

Campo obbligatorio: no

description

Una descrizione degli alias.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

Campo obbligatorio: no

tags

Un elenco di tag da aggiungere all'alias del bot. È possibile aggiungere tag solo quando si crea un alias, non è possibile utilizzare l'PutBotAliasoperazione per aggiornare i tag su un alias bot. Per aggiornare i tag, utilizza l'operazione TagResource.

Tipo: matrice di oggetti Tag

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

Campo obbligatorio: no

Sintassi della risposta

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"
      }
   ]
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

botName

Il nome del bot a cui punta l'alias.

▬Tipo: stringa

Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.

Modello: ^([A-Za-z]_?)+$

botVersion

La versione del bot a cui punta l'alias.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: \$LATEST|[0-9]+

checksum

Il checksum per la versione corrente dell'alias.

▬Tipo: stringa

conversationLogs

Le impostazioni che determinano in che modo Amazon Lex utilizza i log delle conversazioni per l'alias.

Tipo: oggetto ConversationLogsResponse

createdDate

La data di creazione dell'alias del bot.

Tipo: Timestamp

description

Una descrizione degli alias.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

lastUpdatedDate

La data in cui l'alias del bot è stato aggiornato. Quando crei una risorsa, la data di creazione e la data dell'ultimo aggiornamento coincidono.

Tipo: Timestamp

name

Nome dell'alias.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.

Modello: ^([A-Za-z]_?)+$

tags

Un elenco di tag associati a un bot.

Tipo: matrice di oggetti Tag

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

Errori

BadRequestException

La richiesta non è ben formata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.

Codice di stato HTTP: 400

ConflictException

Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.

Codice di stato HTTP: 409

InternalFailureException

Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.

Codice di stato HTTP: 500

LimitExceededException

La richiesta ha superato il limite. Riprova la richiesta.

Codice di stato HTTP: 429

PreconditionFailedException

Il checksum della risorsa che stai tentando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.

Codice di stato HTTP: 412

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:

• Interfaccia a riga di comando AWS

• AWS SDK per.NET

• AWS SDK per C++

• AWS SDK per Go v2

• AWS SDK per Java V2

• AWS SDK per V3 JavaScript

• AWS SDK per PHP V3

• AWS SDK per Python

• AWS SDK per Ruby V3