Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Comment Step Functions associe les exécutions à une version ou à un alias

Step Functions associe une exécution à une version ou à un alias basé sur le nom de ressource Amazon (ARN) que vous utilisez pour appeler l'StartExecutionAPIaction. Step Functions exécute cette action au début de l'exécution.

Vous pouvez démarrer l'exécution d'une machine à états à l'aide d'un système qualifié ou non qualifiéARN.

Par exemple, si votre qualificatif ARN fait référence à une version3, Step Functions associe l'exécution à cette version. Il n'associe l'exécution à aucun alias pointant vers la version3.

Si votre ARN qualificatif fait référence à un alias, Step Functions associe l'exécution à cet alias et à la version vers laquelle pointe l'alias. Une exécution ne peut être associée qu'à un seul alias.

Afficher les exécutions démarrées par une version ou un alias

Step Functions propose les méthodes suivantes pour visualiser les exécutions démarrées avec une version ou un alias :

Utiliser des API actions

Vous pouvez afficher toutes les exécutions associées à une version ou à un alias en invoquant les ListExecutionsAPIactions DescribeExecutionet. Ces API actions renvoient ARN la version ou l'alias utilisé pour démarrer l'exécution. Ces actions renvoient également d'autres détails, notamment le statut et ARN l'exécution.

Vous pouvez également fournir un alias ARN ou une version de machine à états ARN pour répertorier les exécutions associées à un alias ou à une version spécifique.

L'exemple de réponse suivant à l'ListExecutionsAPIaction montre ARN l'alias utilisé pour démarrer une exécution par machine à états nommé myFirstExecution.

Le italicized le texte de l'extrait de code suivant représente des informations spécifiques à la ressource.

{
    "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"
        }
    ]
}

Utilisation de la console Step Functions

Vous pouvez également consulter les exécutions lancées par une version ou un alias depuis la console Step Functions. La procédure suivante indique comment visualiser les exécutions démarrées avec une version spécifique :

L'image suivante montre la page de console Détails de la version. Cette page répertorie les exécutions lancées par la version 4 d'une machine à états nomméeMathAddDemo. Cette liste affiche également une exécution démarrée par un alias nomméPROD. Cet alias a acheminé le trafic d'exécution vers la version 4.

Utilisation de CloudWatch métriques

Pour chaque exécution de machine à états que vous commencez par unQualified ARN, Step Functions émet des métriques supplémentaires portant le même nom et la même valeur que les métriques émises actuellement. Ces métriques supplémentaires contiennent des dimensions pour chaque identifiant de version et nom d'alias avec lesquels vous démarrez une exécution. Grâce à ces mesures, vous pouvez surveiller les exécutions des machines à états au niveau de la version et déterminer dans quels cas un scénario de restauration peut être nécessaire. Vous pouvez également créer des CloudWatch alarmes Amazon en fonction de ces statistiques.

Step Functions émet les métriques suivantes pour les exécutions que vous commencez par un alias ou une version :

Si vous avez commencé l'exécution avec une versionARN, Step Functions publie la métrique avec les Version dimensions StateMachineArn et une deuxième métrique avec StateMachineArn et.

Si vous avez démarré l'exécution avec un aliasARN, Step Functions émet les métriques suivantes :