Versioning und Aliasnamen - Amazon Lex V 1

Hinweis zum Ende des Supports: Am 15. September 2025 AWS wird der Support für Amazon Lex V1 eingestellt. Nach dem 15. September 2025 können Sie nicht mehr auf die Amazon Lex V1-Konsole oder die Amazon Lex V1-Ressourcen zugreifen. Wenn Sie Amazon Lex V2 verwenden, lesen Sie stattdessen das Amazon Lex V2-Handbuch.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Versioning und Aliasnamen

Amazon Lex unterstützt die Veröffentlichung von Versionen von Bots, Intents und Slot-Typen, sodass Sie die Implementierung kontrollieren können, die Ihre Client-Anwendungen verwenden. Eine Version ist ein nummerierter Snapshot Ihrer Arbeit, den Sie zur Verwendung in verschiedenen Teilen Ihres Workflows, zum Beispiel Entwicklung, Beta-Bereitstellung und Produktion, veröffentlichen können.

Amazon Lex Lex-Bots unterstützen auch Aliase. Ein Alias ist ein Zeiger auf eine bestimmte Bot-Version. Mit einem Alias können Sie einfach die Version aktualisieren, die Ihre Clientanwendungen verwenden. Beispielsweise können Sie einen Alias auf Version 1 Ihres Bot zeigen lassen. Wenn Sie bereit sind, den Bot zu aktualisieren, veröffentlichen Sie Version 2 und ändern den Alias so, dass er auf die neue Version zeigt. Da Ihre Anwendungen den Alias anstelle einer bestimmten Version verwenden, erhalten alle Ihre Clients die neuen Funktionen, ohne dafür aktualisiert werden zu müssen.

Versionsverwaltung

Wenn Sie eine Version einer Amazon Lex Lex-Ressource erstellen, erstellen Sie einen Snapshot der Ressource, sodass Sie die Ressource so verwenden können, wie sie bei der Erstellung der Version vorhanden war. Nachdem Sie eine Version erstellt haben, bleibt Sie, während Sie weiter an Ihrer Anwendung arbeiten, unverändert.

Die $LATEST Version

Wenn Sie einen Amazon Lex Lex-Bot-, Intent- oder Slot-Typ erstellen, gibt es nur eine Version, die $LATEST Version.

The $LATEST version of a bot.

$LATEST ist die Arbeitsversion Ihrer Ressource. Sie können nur die $LATEST Version aktualisieren. Bis Sie Ihre erste Version veröffentlicht haben, ist die $LATEST Version die einzige Version der Ressource, die Sie haben.

Nur die $LATEST Version einer Ressource kann die $LATEST Version einer anderen Ressource nutzen. Beispielsweise kann die $LATEST Version eines Bots die $LATEST Version einer Absicht nutzen und die $LATEST Version einer Absicht kann die $LATEST Version eines Slot-Typs verwenden.

Die $LATEST Version Ihres Bots sollte nur für manuelle Tests verwendet werden. Amazon Lex begrenzt die Anzahl der Runtime-Anfragen, die Sie an die $LATEST Version des Bots stellen können.

Veröffentlichen einer Amazon Lex Lex-Ressourcenversion

Wenn Sie eine Ressource veröffentlichen, erstellt Amazon Lex eine Kopie der $LATEST Version und speichert sie als nummerierte Version. Die veröffentlichte Version kann nicht geändert werden.

Publishing a new version of the bot.

Sie erstellen und veröffentlichen Versionen mithilfe der Amazon Lex Lex-Konsole oder des CreateBotVersion Vorgangs. Ein Beispiel finden Sie unter Übung 3: Eine Version veröffentlichen und einen Aliasnamen generieren.

Wenn Sie die $LATEST Version einer Ressource ändern, können Sie die neue Version veröffentlichen, um die Änderungen für Ihre Clientanwendungen bereitzustellen. Jedes Mal, wenn Sie eine Version veröffentlichen, kopiert Amazon Lex die $LATEST Version, um die neue Version zu erstellen, und erhöht die Versionsnummer um 1. Versionsnummern werden niemals wiederverwendet. Wenn Sie beispielsweise eine Ressource mit der Nummer Version 10 entfernen und sie dann neu erstellen, weist Amazon Lex als nächste Versionsnummer Version 11 zu.

Bevor Sie einen Bot veröffentlichen können, müssen Sie diesen auf eine nummerierte Version einer Absicht verweisen, die er verwendet. Wenn Sie versuchen, eine neue Version eines Bots zu veröffentlichen, der die $LATEST-Version einer Absicht verwendet, gibt Amazon Lex einen HTTP-400-Fehler (Bad Request) zurück. Bevor Sie einen nummerierte Version einer Absicht veröffentlichen können, müssen Sie die Absicht auf eine nummerierte Version eines von ihr verwendeten Slot-Typs verweisen. Andernfalls erhalten Sie einen HTTP-400-Fehler (Bad Request).

Publishing a new version of $LATEST.

Anmerkung

Amazon Lex veröffentlicht eine neue Version nur, wenn sich die zuletzt veröffentlichte Version von der $LATEST Version unterscheidet. Wenn Sie versuchen, die $LATEST Version zu veröffentlichen, ohne sie zu ändern, erstellt oder veröffentlicht Amazon Lex keine neue Version.

Aktualisieren einer Amazon Lex Lex-Ressource

Sie können nur die $LATEST Version eines Amazon Lex Lex-Bot-, Intent- oder Slot-Typs aktualisieren. Veröffentlichte Versionen können nicht geändert werden. Sie können jederzeit eine neue Version veröffentlichen, nachdem Sie eine Ressource in der Konsole oder über die Operationen CreateBotVersion, CreateIntentVersion oder CreateSlotTypeVersion aktualisiert haben.

Löschen einer Amazon Lex Lex-Ressource oder -Version

Amazon Lex unterstützt das Löschen einer Ressource oder Version mithilfe der Konsole oder einer der API-Operationen:

Aliasnamen

Ein Alias ist ein Verweis auf eine bestimmte Version eines Amazon Lex Lex-Bot. Verwenden Sie einen Alias, um Clientanwendungen zu erlauben, eine bestimmte Version des Bots zu verwenden, ohne dass die Anwendung nachverfolgen muss, um welche Version es sich handelt.

Das folgende Beispiel zeigt zwei Versionen eines Amazon Lex Lex-Bot, Version 1 und Version 2. Jeder dieser Bot-Versionen ist ein Alias zugeordnet, BETA bzw. PROD. Clientanwendungen greifen auf den Bot mithilfe des PROD-Alias zu.

Point a client application to a version by using an alias.

Wenn Sie eine zweite Version des Bots erstellen, können Sie den Alias mit der Konsole oder der PutBot-Operation so aktualisieren, dass er auf die neue Version des Bots zeigt. Wenn Sie den Alias ändern, verwenden alle Ihre Clientanwendungen die neue Version. Wenn es mit der neuen Version ein Problem gibt, können Sie einfach zu der vorhergehenden Version zurückkehren, indem Sie den Alias so ändern, dass er auf diese Version zeigt.

Updating an alias changes the version used by client applications.

Anmerkung

Obwohl Sie die $LATEST Version eines Bots in der Konsole testen können, empfehlen wir für den Fall, dass Sie einen Bot in Ihre Clientanwendung integrieren, zunächst eine Version zu veröffentlichen und einen Alias zu erstellen, der auf diese Version zeigt. Verwenden Sie den Alias in Ihrer Clientanwendung aus den Gründen, die in diesem Abschnitt erklärt werden. Wenn Sie einen Alias aktualisieren, wartet Amazon Lex, bis das Sitzungs-Timeout aller aktuellen Sitzungen abgelaufen ist, bevor es die neue Version verwendet. Weitere Informationen zur Zeitbeschränkung bei einer Sitzung finden Sie unter Festlegen der Sitzungs-Zeitüberschreitung.