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 StartExecutionAPIAktion 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 Wert starten.

  • Qualifiziert ARN — Bezieht sich auf eine Zustandsmaschine, der eine Versionsnummer oder ein Aliasname als ARN Suffix angehängt wird.

    Das folgende qualifizierte ARN Beispiel bezieht sich auf die Version einer 3 Zustandsmaschine 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 PROD eines Zustandsmaschinen namensmyStateMachine.

    arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD
  • Unqualifiziert ARN — Bezieht sich auf eine Zustandsmaschine ARN ohne Versionsnummer oder Aliasnamensuffix.

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

Wenn sich Ihr qualifizierter Wert beispielsweise ARN auf die 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 Wert 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 Wert startenARN, ordnet Step Functions diese Ausführung keiner Version zu, auch wenn die Version dieselbe Zustandsmaschine revision verwendet. Wenn Version 3 beispielsweise die neueste Version verwendet, Sie aber eine Ausführung mit einer unqualifizierten Version startenARN, 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:

Aktionen verwenden API

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

Sie können auch einen Alias ARN oder eine State-Machine-Version angebenARN, um die Ausführungen aufzulisten, die einem bestimmten Alias oder einer bestimmten Version zugeordnet sind.

Die folgende Beispielantwort der ListExecutionsAPIAktion zeigt den Alias, ARN der verwendet wurde, um eine State-Machine-Ausführung mit dem Namen zu starten myFirstExecution.

Das Tool italicized Der Text im folgenden Codeausschnitt steht für ressourcenspezifische Informationen.

{ "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 gestartet habenARN, 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 gestartet habenARN, gibt Step Functions die folgenden Metriken aus:

  • Zwei Metriken für „unqualifiziert“ ARN und „Version“.

  • Eine Metrik mit den Alias Dimensionen StateMachineArn und.