State-Machine-Versionen in Step Functions Functions-Workflows

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 Zustandsmaschine ARN und Versionsnummer ist, getrennt durch einen Doppelpunkt (:). Das folgende Beispiel zeigt das Format einer State-Machine-VersionARN.

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 StartExecutionAPIAktion mit der Version 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:

• Alle Versionen einer Zustandsmaschine haben denselben Typ (Standard oder Express).

• Sie können den Namen oder das Erstellungsdatum einer Zustandsmaschine nicht zwischen den Versionen ändern.

• Tags gelten global für Zustandsmaschinen. Sie können Tags für Zustandsmaschinen mithilfe der UntagResourceAPIAktionen TagResourceund verwalten.

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 IAMRolle, 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 nicht verwendete Versionen manuell von der Konsole löschen oder indem Sie die DeleteStateMachineVersionAPIAktion aufrufen.

Um eine State-Machine-Version zu veröffentlichen

1. Öffnen Sie die Step Functions Functions-Konsole und wählen Sie dann eine vorhandene Zustandsmaschine aus.

2. Wählen Sie auf der Seite mit den State-Machine-Details die Option Bearbeiten aus.

3. Bearbeiten Sie die State-Machine-Definition nach Bedarf und wählen Sie dann Speichern.

4. Wählen Sie Publish version (Version veröffentlichen) aus.

5. (Optional) Geben Sie im Feld Beschreibung des daraufhin angezeigten Dialogfelds eine kurze Beschreibung der State-Machine-Version ein.

6. Wählen Sie Publish.

Anmerkung

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.

Versionen mit Step Functions API Functions-Operationen verwalten

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

• PublishStateMachineVersion— Publiziert eine aktuelle Version einer revision Zustandsmaschine.

• UpdateStateMachine— Veröffentlicht eine neue Zustandsmaschine, wenn Sie eine Zustandsmaschine aktualisieren und den publish Parameter true in derselben Anfrage auf setzen.

• CreateStateMachine— Publiziert die erste Version der Zustandsmaschine, wenn Sie den publish Parameter auf setzentrue.

• ListStateMachineVersions— Listet die Versionen für die angegebene Zustandsmaschine aufARN.

• DescribeStateMachine— Gibt die Versionsdetails der Zustandsmaschine für eine Version zurück, die in ARN angegeben iststateMachineArn.

• DeleteStateMachineVersion— Löscht eine State-Machine-Version.

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.

Anmerkung

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.

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 PublishStateMachineVersionAPIAktion auf. Sie können die UpdateStateMachineAliasAPIAktion auch mit einem optionalen Parameter aufrufen, um einen Zustandsmaschine publish zu aktualisieren und seine Version zu veröffentlichen.

Sie können Ausführungen einer Version starten, indem Sie die Konsole verwenden oder indem Sie die StartExecutionAPIAktion aufrufen und die Version bereitstellen. 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.

So starten Sie eine Ausführung mit einer State-Machine-Version

1. Öffnen Sie die Step Functions Functions-Konsole und wählen Sie dann eine vorhandene Zustandsmaschine aus, für die Sie eine oder mehrere Versionen veröffentlicht haben. Informationen zum Veröffentlichen einer Version finden Sie unterVeröffentlichen einer State-Machine-Version (Konsole).

2. Wählen Sie auf der Detailseite der Statusmaschine die Registerkarte Versionen aus.

3. Gehen Sie im Abschnitt Versionen wie folgt vor:

   1. Wählen Sie die Version aus, mit der Sie die Ausführung starten möchten.

   2. Wählen Sie Start execution (Ausführung starten) aus.

4. (Optional) Geben Sie im Dialogfeld Ausführung starten einen Namen für die Ausführung ein.

5. (Optional) Geben Sie die Ausführungseingabe ein und wählen Sie dann Ausführung starten aus.