Funzione Versioni multiple e alias

Amazon Lex supporta la pubblicazione di versioni di bot, intenti e tipi di slot per controllare l'implementazione utilizzata dalle applicazioni client. Una versione è una snapshot numerata del lavoro dell'utente che è possibile pubblicare per l'utilizzo in diverse parti del flusso di lavoro, quali lo sviluppo, la distribuzione beta e la produzione.

I bot di Amazon Lex supportano anche gli alias. Un alias è un puntatore a una specifica versione di un bot Con un alias è possibile aggiornare facilmente la versione utilizzata dalle applicazioni client. Ad esempio, si potrebbe associare un alias alla versione 1 di un bot. Quando si è pronti per aggiornare il bot, è possibile pubblicare la versione 2 del bot e modificare l'alias in modo che punti alla nuova versione. Poiché le applicazioni utilizzano l'alias anziché una versione specifica, tutti i client otterranno la nuova funzionalità senza necessità di un aggiornamento.

Funzione Controllo delle versioni

Quando si esegue la versione di una risorsa Amazon Lex, viene creata una snapshot della risorsa in modo che sia possibile utilizzare la risorsa esistente al momento della creazione della versione. Una volta creata una versione, mentre si continua a lavorare sull'applicazione questa versione rimarrà invariata.

La versione $LATEST

Quando si crea un bot, un intento o un tipo di slot di Amazon Lex è disponibile una sola versione:$LATESTVersione .

La versione $LATEST è la copia di lavoro della risorsa. Fino a quando non si pubblica la prima versione della risorsa, è possibile aggiornare solo la versione $LATEST. La versione $LATEST è l'unica versione della risorsa disponibile.

Solo la versione $LATEST di una risorsa può utilizzare la versione $LATEST di un'altra risorsa. Ad esempio, la versione $LATEST di un bot può utilizzare la versione $LATEST di un intento e la versione $LATEST di un intento può utilizzare la versione $LATEST di un tipo di slot.

La$LATESTLa versione del bot deve essere utilizzata solo per i test manuali. Amazon Lex limita il numero di richieste di runtime che è possibile effettuare per$LATESTversione del bot.

Pubblicazione di una versione delle risorse Amazon Lex

Quando si pubblica una risorsa, Amazon Lex crea una copia del$LATESTla salva come versione numerata. La versione pubblicata non può essere modificata.

È possibile creare e pubblicare versioni tramite la console Amazon Lex o ilCreateBotVersionoperazione. Per un esempio, consultare Esercizio 3. Pubblicazione di una versione e creazione di un alias.

Quando si modifica la versione $LATEST di una risorsa, è possibile pubblicare la nuova versione per rendere disponibili le modifiche per le applicazioni client. Ogni volta che pubblichi una versione, Amazon Lex copia il$LATESTversione per creare la nuova versione e incrementa il numero della versione di 1 numero. I numeri di versione non vengono mai riutilizzati. Ad esempio, se si elimina una versione con numero di risorsa 10 e quindi la si crea nuovamente, il numero della nuova versione assegnato da Amazon Lex sarà 11.

Prima di poter pubblicare un bot, è necessario farlo puntare a una versione numerata di qualsiasi evento utilizzato. Se si tenta di pubblicare una nuova versione di un bot che utilizza la versione $LATEST di un intento, Amazon Lex restituisce un'eccezione di richiesta non valida HTTP 400. Prima di poter pubblicare una versione numerata dell'intento, è necessario far puntare l'intento a una versione numerata di qualsiasi tipo di slot utilizzato. In caso contrario, verrà restituita un'eccezione di richiesta non valida 400 HTTP.

Nota

Amazon Lex pubblica una nuova versione solo se l'ultima versione pubblicata è diversa dalla$LATESTVersione . Se provi a pubblicare il$LATESTsenza modificarla, Amazon Lex non crea né pubblica una nuova versione.

Aggiornamento di una risorsa Amazon Lex

È possibile aggiornare solo il$LATESTversione di un bot, intento o tipo di slot di Amazon Lex. Non è possibile modificare le versioni pubblicate. È possibile pubblicare una nuova versione in qualsiasi momento dopo aver aggiornato una risorsa tramite la console o le operazioni CreateBotVersion, CreateIntentVersion o CreateSlotTypeVersion.

Eliminazione di una risorsa o versione di Amazon Lex

Amazon Lex supporta l'eliminazione di una risorsa o versione tramite la console o una delle operazioni API:

• DeleteBot

• DeleteBotVersion

• DeleteBotAlias

• DeleteBotChannelAssociation

• DeleteIntent

• DeleteIntentVersion

• DeleteSlotType

• DeleteSlotTypeVersion

Alias

Un alias è un puntatore a una specifica versione di un bot Amazon Lex. È possibile utilizzare un alias per consentire alle applicazioni client di utilizzare una versione specifica del bot senza richiedere all'applicazione di tenere traccia di quale versione sia.

L'esempio seguente mostra due versioni di un bot Amazon Lex: la versione 1 e la versione 2. A ciascuna di queste versioni di bot è associato un alias: rispettivamente BETA e PROD. Le applicazioni client utilizzano l'alias PROD per accedere al bot.

Quando si crea una seconda versione del bot, è possibile aggiornare l'alias utilizzando la console o l'operazione PutBot per fare in modo che punti alla nuova versione del bot. Se si modifica l'alias, tutte le applicazioni client utilizzeranno la nuova versione. Se si verifica un problema relativo alla nuova versione, è possibile tornare alla versione precedente semplicemente modificando l'alias in modo che punti a tale versione.

Nota

Sebbene sia possibile effettuare un test della versione $LATEST di un bot nella console, quando si integra un bot con l'applicazione client si consiglia di pubblicare prima una versione e creare un alias che punta a tale versione. Utilizzare l'alias nell'applicazione client per i motivi illustrati in questa sezione. Quando si aggiorna un alias, prima di iniziare a utilizzare la nuova versione Amazon Lex attenderà fino allo scadere del timeout di sessione per tutte le sessioni correnti. Per ulteriori informazioni sul timeout di sessione, consultare Impostazione del timeout di sessione.