So verknüpft Step Functions Ausführungen mit einer Version oder einem Alias - AWS Step Functions

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.

So verknüpft Step Functions Ausführungen mit einer Version oder einem Alias

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

Sie können eine State-Machine-Ausführung mit einem qualifizierten oder einem unqualifizierten ARN starten.

  • Qualifizierter ARN — Bezieht sich auf einen Zustandsmaschinen-ARN, dem eine Versionsnummer oder ein Aliasname als Suffix angehängt wird.

    Das folgende qualifizierte ARN-Beispiel bezieht sich auf die Version einer 3 Zustandsmaschine mit dem NamenmyStateMachine.

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

    Das folgende qualifizierte ARN-Beispiel bezieht sich auf einen Alias mit dem Namen PROD einer Zustandsmaschine namensmyStateMachine.

    arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD
  • Unqualifizierter ARN — Bezieht sich auf einen Zustandsmaschinen-ARN ohne Versionsnummer oder Aliasnamensuffix.

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

Wenn sich Ihr qualifizierter ARN beispielsweise auf eine Version bezieht3, ordnet Step Functions die Ausführung dieser Version zu. Es ordnet die Ausführung keinen Aliasnamen zu, die auf die Version 3 verweisen.

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 keiner Version zu, selbst wenn die Version dieselbe Zustandsmaschine revision verwendet. Wenn Version 3 beispielsweise die neueste Revision verwendet, Sie aber eine Ausführung mit einem unqualifizierten ARN starten, ordnet Step Functions diese Ausführung nicht der Version 3 zu.

Ausführungen anzeigen, 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 gestartet wurden:

API-Aktionen verwenden

Sie können alle Ausführungen anzeigen, die mit einer Version oder einem Alias verknüpft sind, indem Sie die ListExecutionsAPI-Aktionen DescribeExecutionund aufrufen. Diese API-Aktionen geben den ARN der Version oder des Alias zurück, mit dem die Ausführung gestartet wurde. Diese Aktionen geben auch andere Details zurück, einschließlich Status und ARN der Ausführung.

Sie können auch einen Zustandsmaschinen-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 ListExecutionsAPI-Aktion zeigt den ARN des Alias, der verwendet wurde, um eine State-Machine-Ausführung mit dem Namen zu startenmyFirstExecution.

Der italicized 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 Functions-Konsole

Sie können die Ausführungen, die von einer Version oder einem Alias gestartet wurden, auch in der 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 Functions-Konsole und wählen Sie dann einen vorhandenen State Machine aus, für den Sie eine Version veröffentlicht oder einen Alias erstellt haben. Dieses Beispiel zeigt, wie die Ausführungen angezeigt werden, die mit einer bestimmten State-Machine-Version gestartet wurden.

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

    Tipp

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

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

Die folgende Abbildung zeigt die Konsolenseite mit den Versionsdetails. Auf dieser Seite sind Ausführungen aufgeführt, die von der Version 4 einer Zustandsmaschine mit dem Namen MathAddDemo gestartet wurden. In dieser Liste wird auch eine Ausführung angezeigt, die von einem Alias namens PROD gestartet wurde. Dieser Alias hat den Ausführungsdatenverkehr an Version 4 weitergeleitet.

Illustrativer Screenshot der Konsolenseite mit den Versionsdetails der State Machine.

Metriken verwenden CloudWatch

Für jede State-Machine-Ausführung, die Sie mit einer beginnenQualified ARN, gibt Step Functions zusätzliche Metriken mit demselben Namen und Wert wie die aktuell ausgegebenen Metriken aus. Diese zusätzlichen Metriken enthalten Dimensionen für jede der Versions-IDs und Aliasnamen, mit denen Sie eine Ausführung starten. Mit diesen Metriken können Sie State-Machine-Ausführungen auf Versionsebene überwachen und bestimmen, wann ein Rollback-Szenario erforderlich sein könnte. Sie können auch CloudWatchAmazon-Alarme auf der Grundlage dieser Metriken erstellen.

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

  • ExecutionTime

  • ExecutionsAborted

  • ExecutionsFailed

  • ExecutionsStarted

  • ExecutionsSucceeded

  • ExecutionsTimedOut

Wenn Sie die Ausführung mit einer Version ARN gestartet haben, veröffentlicht Step Functions die Metrik mit den 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 unqualifizierten ARN und die Version.

  • Eine Metrik mit den Alias Dimensionen StateMachineArn und.