State-Machine-Versionen in Step Functions Functions-Workflows

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.

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.

Eine Version ist ein nummerierter, unveränderlicher Snapshot einer Zustandsmaschine. Sie veröffentlichen Versionen der letzten Version, die an dieser Zustandsmaschine vorgenommen wurde. Jede Version hat einen eindeutigen Amazon-Ressourcennamen (ARN), der eine Kombination aus dem Zustandsmaschinen-ARN und der Versionsnummer ist, getrennt durch einen Doppelpunkt (:). Das folgende Beispiel zeigt das Format einer State-Machine-Version ARN.

arn:partition:states:region:account-id:stateMachine:myStateMachine:1

Um mit der Verwendung von State-Machine-Versionen zu beginnen, müssen Sie die erste Version veröffentlichen. Nachdem Sie eine Version veröffentlicht haben, können Sie die StartExecutionAPI-Aktion mit dem Versions-ARN aufrufen. Sie können eine Version nicht bearbeiten, aber Sie können eine Zustandsmaschine aktualisieren und eine neue Version veröffentlichen. Sie können auch mehrere Versionen Ihres State Machine veröffentlichen.

Wenn Sie eine neue Version Ihrer State Machine veröffentlichen, weist Step Functions ihr eine Versionsnummer zu. Die Versionsnummern beginnen bei 1 und steigen mit jeder neuen Version monoton an. Versionsnummern werden für eine bestimmte Zustandsmaschine nicht wiederverwendet. Wenn Sie Version 10 Ihrer State Machine löschen und dann eine neue Version veröffentlichen, veröffentlicht Step Functions sie als Version 11.

Die folgenden Eigenschaften sind für alle Versionen einer Zustandsmaschine identisch:

Zustandsmaschinen enthalten auch Eigenschaften, die Teil jeder Version und revision sind. Diese Eigenschaften können sich jedoch zwischen zwei bestimmten Versionen oder Revisionen unterscheiden. Zu diesen Eigenschaften gehören die Definition von Zustandsmaschinen, die IAM-Rolle, die Ablaufverfolgungskonfiguration und die Protokollierungskonfiguration.

Veröffentlichen einer State-Machine-Version (Konsole)

Sie können bis zu 1000 Versionen einer Zustandsmaschine veröffentlichen. Um eine Erhöhung dieses Soft-Limits zu beantragen, verwenden Sie die Support Center-Seite in der AWS Management Console. Sie können ungenutzte Versionen manuell von der Konsole oder durch Aufrufen der DeleteStateMachineVersionAPI-Aktion löschen.

Versionen mit Step Functions Functions-API-Operationen verwalten

Step Functions bietet die folgenden API-Operationen zum Veröffentlichen und Verwalten von State-Machine-Versionen:

Um eine neue Version der aktuellen Version einer Zustandsmaschine zu veröffentlichen, die myStateMachine mit dem aufgerufen wurde AWS Command Line Interface, verwenden Sie den publish-state-machine-version folgenden Befehl:

aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

In der Antwort wird der stateMachineVersionArn zurückgegeben. Der vorherige Befehl gibt beispielsweise eine Antwort von zurückarn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1.

Eine State-Machine-Version von der Konsole aus ausführen

Um mit der Verwendung von State-Machine-Versionen zu beginnen, müssen Sie zunächst eine Version von der aktuellen Zustandsmaschine veröffentlichenrevision. Um eine Version zu veröffentlichen, verwenden Sie die Step Functions Functions-Konsole oder rufen Sie die PublishStateMachineVersionAPI-Aktion auf. Sie können die UpdateStateMachineAliasAPI-Aktion auch mit einem optionalen Parameter aufrufen, um eine Zustandsmaschine publish zu aktualisieren und ihre Version zu veröffentlichen.

Sie können Ausführungen einer Version starten, indem Sie die Konsole verwenden oder indem Sie die StartExecutionAPI-Aktion aufrufen und den Versions-ARN ARN. Sie können auch einen Alias verwenden, um Ausführungen einer Version zu starten. Basierend auf seiner Routing-Konfiguration leitet ein Alias den Datenverkehr an eine bestimmte Version weiter.

Wenn Sie eine State-Machine-Ausführung starten, ohne eine Version zu verwenden, verwendet Step Functions die neueste Version der State-Machine für die Ausführung. Hinweise dazu, wie Step Functions eine Ausführung mit einer Version verknüpft, finden Sie unterVerbindet Ausführungen mit einer Version oder einem Alias.