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.
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
3Zustandsmaschine mit dem NamenmyStateMachine.arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:3Das folgende qualifizierte ARN-Beispiel bezieht sich auf einen Alias mit dem Namen
PRODeiner 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
-
Ö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. -
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.
-
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 MathAddDemoPROD
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
AliasDimensionenStateMachineArnund.
