Versions des machines d'état dans les flux de travail Step Functions - AWS Step Functions
Publication d'une version de machine à états (console)Gérer les versions avec APIsExécution d'une version de machine à états depuis la console

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.

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

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 nom de ressource Amazon unique (ARN). Il s'ARNagit d'une combinaison entre la machine à états ARN et le numéro de version séparés par deux points (:). L'exemple suivant montre le format d'une version de machine à étatsARN.

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 invoquer l'StartExecutionAPIaction avec cette versionARN. 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.

Schéma illustratif flou montrant comment les versions sont des instantanés immuables de machines 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 :

  • Toutes les versions d'une machine à états partagent le même type (Standard ou Express).

  • Vous ne pouvez pas modifier le nom ou la date de création d'une machine à états entre les versions.

  • Les balises s'appliquent globalement aux machines d'État. Vous pouvez gérer les balises pour les machines à états à l'aide TagResourcedes UntagResourceAPIactions et.

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, IAMle rôle, la configuration du suivi et la configuration de 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'DeleteStateMachineVersionAPIaction.

Pour publier une version d'une machine à états

  1. Ouvrez la console Step Functions, puis choisissez une machine à états existante.

  2. Sur la page détaillée de State machine, choisissez Modifier.

  3. Modifiez la définition de la machine à états selon vos besoins, puis choisissez Enregistrer.

  4. Choisissez Publier la version.

  5. (Facultatif) Dans le champ Description de la boîte de dialogue qui apparaît, entrez une brève description de la version de la machine à états.

  6. Choisissez Publish.

Note

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.

Gestion des versions avec les API opérations Step Functions

Step Functions propose les API opérations suivantes pour publier et gérer les versions des machines à états :

  • PublishStateMachineVersion— Publie une version à partir de la version actuelle revision d'une machine à états.

  • UpdateStateMachine— Publie une nouvelle version de machine à états si vous mettez à jour une machine à états et définissez le publish paramètre sur true dans la même demande.

  • CreateStateMachine— Publie la première révision de la machine à états si vous définissez le publish paramètre surtrue.

  • ListStateMachineVersions— Répertorie les versions de la machine à états spécifiéeARN.

  • DescribeStateMachine— Renvoie les détails de la version de la machine à états pour une version ARN spécifiée dansstateMachineArn.

  • DeleteStateMachineVersion— Supprime une version de machine à états.

Pour publier une nouvelle version à partir de la révision en cours d'une machine à états appelée à l'myStateMachineaide 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.

Note

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.

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'PublishStateMachineVersionAPIaction. Vous pouvez également invoquer l'UpdateStateMachineAliasAPIaction 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 en utilisant la console ou en invoquant l'StartExecutionAPIaction et en fournissant la versionARN. Vous pouvez également utiliser un alias pour démarrer l'exécution d'une version. Sur la base 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.

Pour démarrer une exécution à l'aide d'une version de machine à états

  1. Ouvrez la console Step Functions, puis choisissez une machine à états existante pour laquelle vous avez publié une ou plusieurs versions. Pour savoir comment publier une version, voirPublication d'une version de machine à états (console).

  2. Sur la page détaillée de State machine, choisissez l'onglet Versions.

  3. Dans la section Versions, procédez comme suit :

    1. Sélectionnez la version avec laquelle vous souhaitez démarrer l'exécution.

    2. Choisissez Start execution (Démarrer l'exécution).

  4. (Facultatif) Dans la boîte de dialogue Démarrer l'exécution, entrez le nom de l'exécution.

  5. (Facultatif), entrez l'entrée d'exécution, puis choisissez Démarrer l'exécution.