Versions des machines d'état dans les flux de travail Step Functions

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.

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.

Une version est un instantané numéroté et immuable d'une machine à états. Vous publiez les versions de la dernière révision apportée à cette machine d'état. Chaque version possède un Amazon Resource Name (ARN) unique qui est une combinaison de l'ARN de la machine à états et du numéro de version séparés par deux points (:). L'exemple suivant montre le format d'un ARN de version State Machine.

arn:partition:states:region:account-id:stateMachine:myStateMachine:1

Pour commencer à utiliser les versions State Machine, vous devez publier la première version. Après avoir publié une version, vous pouvez appeler l'action d'StartExecutionAPI avec l'ARN de la version. Vous ne pouvez pas modifier une version, mais vous pouvez mettre à jour une machine à états et publier une nouvelle version. Vous pouvez également publier plusieurs versions de votre machine d'état.

Lorsque vous publiez une nouvelle version de votre machine à états, Step Functions lui attribue un numéro de version. Les numéros de version commencent à 1 et augmentent de façon monotone pour chaque nouvelle version. Les numéros de version ne sont pas réutilisés pour une machine à états donnée. Si vous supprimez la version 10 de votre machine d'état puis publiez une nouvelle version, Step Functions la publie en tant que version 11.

Les propriétés suivantes sont les mêmes pour toutes les versions d'une machine à états :

Les machines à états contiennent également des propriétés qui font partie de chaque versionrevision, mais ces propriétés peuvent différer entre deux versions ou révisions données. Ces propriétés incluent la définition de la machine State, le rôle IAM, la configuration du suivi et la configuration de la journalisation.

Publication d'une version de machine à états (console)

Vous pouvez publier jusqu'à 1 000 versions d'une machine à états. Pour demander une augmentation de cette limite souple, utilisez la page Support Center du AWS Management Console. Vous pouvez supprimer manuellement les versions inutilisées depuis la console ou en appelant l'action DeleteStateMachineVersionAPI.

Gestion des versions avec les opérations de l'API Step Functions

Step Functions fournit les opérations d'API suivantes pour publier et gérer les versions de State Machine :

Pour publier une nouvelle version à partir de la révision actuelle d'une machine à états appelée à myStateMachine l'aide du AWS Command Line Interface, utilisez la publish-state-machine-version commande :

aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

La réponse renvoie le stateMachineVersionArn. Par exemple, la commande précédente renvoie une réponse dearn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1.

Exécution d'une version de machine à états depuis la console

Pour commencer à utiliser les versions de la machine à états, vous devez d'abord publier une version à partir de la machine à états actuellerevision. Pour publier une version, utilisez la console Step Functions ou appelez l'action PublishStateMachineVersionAPI. Vous pouvez également appeler l'action d'UpdateStateMachineAliasAPI avec un paramètre facultatif nommé publish pour mettre à jour une machine à états et publier sa version.

Vous pouvez démarrer l'exécution d'une version à l'aide de la console ou en appelant l'action d'StartExecutionAPI et en fournissant l'ARN de la version. Vous pouvez également utiliser un alias pour démarrer l'exécution d'une version. En fonction de sa configuration de routage, un alias achemine le trafic vers une version spécifique.

Si vous lancez une exécution par machine à états sans utiliser de version, Step Functions utilise la version la plus récente de la machine à états pour l'exécution. Pour plus d'informations sur la façon dont Step Functions associe une exécution à une version, consultezAssocier des exécutions à une version ou à un alias.