Zuordnen von Zustandsautomaten-Ausführungen zu einer Version oder einem Alias

Step Functions ordnet eine Ausführung einer Version oder einem Alias basierend auf dem Amazon-Ressourcennamen (ARN) zu, den Sie zum Aufrufen der StartExecution API-Aktion verwenden. Step Functions führt diese Aktion zum Startzeitpunkt der Ausführung aus.

Sie können eine Zustandsautomaten-Ausführung mit einem qualifizierten oder einem nicht qualifizierten ARN starten.

• Qualifizierter ARN – Bezieht sich auf einen Zustandsautomaten-ARN mit einer Versionsnummer oder einem Aliasnamen.

  Das folgende qualifizierte ARN-Beispiel bezieht sich auf die Version eines 3 Zustandsautomaten mit dem Namen myStateMachine.

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:3

  Das folgende qualifizierte ARN-Beispiel bezieht sich auf einen Alias mit dem Namen eines PROD Zustandsautomaten mit dem Namen myStateMachine.

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD

• Unqualifizierter ARN – Bezieht sich auf einen Zustandsautomaten-ARN ohne Versionsnummer oder Aliasnamenssuffix.

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

Wenn sich Ihr qualifizierter ARN beispielsweise auf Version bezieht3, ordnet Step Functions die Ausführung dieser Version zu. Die Ausführung wird nicht mit Aliassen verknüpft, die auf die Version verweisen3.

Wenn sich Ihr qualifizierter ARN auf einen Alias bezieht, ordnet Step Functions die Ausführung diesem Alias und der Version zu, auf die der Alias verweist. Eine Ausführung kann nur einem Alias zugeordnet werden.

Anmerkung

Wenn Sie eine Ausführung mit einem unqualifizierten ARN starten, ordnet Step Functions diese Ausführung nicht einer Version zu, selbst wenn die Version denselben Zustandsautomaten verwendetrevision. Wenn Version 3 beispielsweise die neueste Revision verwendet, Sie jedoch eine Ausführung mit einem nicht qualifizierten ARN starten, ordnet Step Functions diese Ausführung nicht der Version 3 zu.

Anzeigen von Ausführungen, die mit einer Version oder einem Alias gestartet wurden

Step Functions bietet die folgenden Möglichkeiten, um die Ausführungen anzuzeigen, die mit einer Version oder einem Alias begonnen wurden:

Verwenden von API-Aktionen

Sie können alle Ausführungen anzeigen, die einer Version oder einem Alias zugeordnet sind, indem Sie die ListExecutions API-Aktionen DescribeExecution und aufrufen. Diese API-Aktionen geben den ARN der Version oder des Alias zurück, die/der zum Starten der Ausführung verwendet wurde. Diese Aktionen geben auch andere Details zurück, einschließlich Status und ARN der Ausführung.

Sie können auch einen Zustandsautomaten-Alias-ARN oder Versions-ARN angeben, um die Ausführungen aufzulisten, die einem bestimmten Alias oder einer bestimmten Version zugeordnet sind.

Die folgende Beispielantwort der ListExecutions -API-Aktion zeigt den ARN des Alias, der zum Starten einer Zustandsautomaten-Ausführung mit dem Namen verwendet wirdmyFirstExecution.

Der kursive Text im folgenden Codeausschnitt stellt ressourcenspezifische Informationen dar.

{
    "executions": [
        {
            "executionArn": "arn:aws:states:us-east-1:123456789012:execution:myStateMachine:myFirstExecution",
            "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine",
            "stateMachineAliasArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD",
            "name": "myFirstExecution",
            "status": "SUCCEEDED",
            "startDate": "2023-04-20T23:07:09.477000+00:00",
            "stopDate": "2023-04-20T23:07:09.732000+00:00"
        }
    ]
}

Verwenden der Step-Functions-Konsole

Sie können die von einer Version oder einem Alias gestarteten Ausführungen auch über die Step-Functions-Konsole anzeigen. Das folgende Verfahren zeigt, wie Sie die Ausführungen anzeigen können, die mit einer bestimmten Version gestartet wurden:

1. Öffnen Sie die Step-Functions-Konsole und wählen Sie dann einen vorhandenen Zustandsautomaten aus, für den Sie eine Version veröffentlicht oder einen Alias erstellt haben. Dieses Beispiel zeigt, wie Sie die Ausführungen anzeigen, die mit einer bestimmten Zustandsautomatenversion gestartet wurden.

2. Wählen Sie die Registerkarte Versionen und dann eine Version aus der Liste Versionen aus.

   Tipp

   Filtern Sie nach Eigenschaft oder Wertfeld, um nach einer bestimmten Version zu suchen.

3. Auf der Seite Versionsdetails finden Sie eine Liste aller laufenden und vergangenen Zustandsautomatenausführungen, die mit der ausgewählten Version gestartet wurden.

Die folgende Abbildung zeigt die Konsolenseite Versionsdetails. Auf dieser Seite werden Ausführungen aufgeführt, die von der Version 4 eines Zustandsautomaten mit dem Namen gestartet wurdenMathAddDemo. Diese Liste zeigt auch eine Ausführung an, die von einem Alias namens gestartet wurdePROD. Dieser Alias leitete den Ausführungsdatenverkehr an Version 4 weiter.

Verwenden von CloudWatch-Metriken

Für jede Ausführung des Zustandsautomaten, die Sie mit einem beginnenQualified ARN, gibt Step Functions zusätzliche Metriken mit demselben Namen und Wert wie die Metriken aus, die derzeit ausgegeben werden. Diese zusätzlichen Metriken enthalten Dimensionen für jede der Versionskennungen und Aliasnamen, mit denen Sie eine Ausführung starten. Mit diesen Metriken können Sie die Ausführung von Zustandsautomaten auf Versionsebene überwachen und feststellen, wann ein Rollback-Szenario erforderlich sein könnte. Sie können auch Amazon CloudWatch-Alarme basierend auf diesen Metriken erstellen.

Step Functions gibt die folgenden Metriken für Ausführungen aus, die mit einem Alias oder einer Version beginnen:

• ExecutionTime

• ExecutionsAborted

• ExecutionsFailed

• ExecutionsStarted

• ExecutionsSucceeded

• ExecutionsTimedOut

Wenn Sie die Ausführung mit einem Versions-ARN gestartet haben, veröffentlicht Step Functions die Metrik mit der StateMachineArn und eine zweite Metrik mit den Version Dimensionen StateMachineArn und .

Wenn Sie die Ausführung mit einem Alias-ARN gestartet haben, gibt Step Functions die folgenden Metriken aus:

• Zwei Metriken für den nicht qualifizierten ARN und die Version.

• Eine Metrik mit den Alias Dimensionen StateMachineArn und .