Poursuivre les flux de travail de longue durée à l'aide de l'API Step Functions (recommandé)

Pour démarrer les exécutions de flux de travail à partir d'un Task état

1. Ouvrez la console Step Functions et choisissez Create state machine.

2. Dans la boîte de dialogue Choisir un modèle, sélectionnez Vide.

3. Choisissez Sélectionner pour ouvrir Workflow Studio dansMode de conception.

4. Dans l'onglet Actions, faites glisser l'action StartExecutionAPI et déposez-la sur l'état vide intitulé Drag first state here.

5. Choisissez l'StartExecutionétat et effectuez les opérations suivantes dans l'onglet Configuration de Mode de conception :

   1. Renommez l'état en. Start nested execution

   2. Pour le type d'intégration, choisissez AWS SDK - nouveau dans la liste déroulante.

   3. Dans Paramètres de l'API, procédez comme suit :

      1. Pour remplacer StateMachineArn l'exemple de nom de ressource Amazon par l'ARN de votre machine à états. Par exemple, entrez l'ARN de la machine à états qui utilise Lambda.

      2. Pour Input node, remplacez le texte de l'espace réservé existant par la valeur suivante :

         "Comment": "Starting workflow execution using a Step Functions API action"

      3. Assurez-vous que vos entrées dans les paramètres de l'API ressemblent à ce qui suit :

         {
           "StateMachineArn": "arn:aws:states:us-east-2:123456789012:stateMachine:LambdaStateMachine",
           "Input": {
             "Comment": "Starting workflow execution using a Step Functions API action",
             "AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID.$": "$$.Execution.Id"
           }

6. (Facultatif) Choisissez Définition dans le Panneau Inspector panneau pour afficher la définition générée automatiquement Amazon States Language (ASL) de votre flux de travail.

   Astuce

   Vous pouvez également consulter la définition ASL dans Workflow Studio. Éditeur de code Dans l'éditeur de code, vous pouvez également modifier la définition ASL de votre flux de travail.

7. Spécifiez un nom pour votre machine à états. Pour ce faire, cliquez sur l'icône d'édition à côté du nom de la machine à états par défaut de MyStateMachine. Ensuite, dans Configuration de la machine d'état, spécifiez un nom dans le champ Nom de la machine d'état.

   Pour ce didacticiel, saisissez le nom ParentStateMachine.

8. (Facultatif) Dans Configuration de la machine à états, spécifiez d'autres paramètres de flux de travail, tels que le type de machine à états et son rôle d'exécution.

   Pour ce didacticiel, conservez toutes les sélections par défaut dans les paramètres State Machine.

   Si vous avez déjà créé un rôle IAM avec les autorisations appropriées pour votre machine d'état et que vous souhaitez l'utiliser, dans Autorisations, sélectionnez Choisir un rôle existant, puis sélectionnez un rôle dans la liste. Vous pouvez également sélectionner Entrer un ARN de rôle, puis fournir un ARN pour ce rôle IAM.

9. Dans la boîte de dialogue Confirmer la création du rôle, choisissez Confirmer pour continuer.

   Vous pouvez également choisir Afficher les paramètres des rôles pour revenir à la configuration de la machine State.

   Note

   Si vous supprimez le rôle IAM créé par Step Functions, Step Functions ne pourra pas le recréer ultérieurement. De même, si vous modifiez le rôle (par exemple, en supprimant Step Functions des principes de la politique IAM), Step Functions ne pourra pas restaurer ses paramètres d'origine ultérieurement.

1. Sur la ParentStateMachinepage, choisissez l'ARN du rôle IAM pour accéder à la page Rôles IAM de votre machine à états.

2. Attribuez une autorisation appropriée au rôle IAM du ParentStateMachinepour qu'il puisse démarrer l'exécution d'une autre machine à états. Pour attribuer l'autorisation, procédez comme suit :

   1. Sur la page Rôles IAM, choisissez Ajouter des autorisations, puis choisissez Créer une politique intégrée.

   2. Sur la page Créer une politique, choisissez l'onglet JSON.

   3. Remplacez le texte existant par la politique suivante.

      {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Effect": "Allow",
                "Action": [
                    "states:StartExecution"
                ],
                "Resource": [
                    "arn:aws:states:us-east-2:123456789012:stateMachine:LambdaStateMachine"
                ]
            }
        ]
      }

   4. Choisissez Review policy (Examiner une politique).

   5. Spécifiez un nom pour la politique, puis choisissez Créer une politique.

1. Sur la ParentStateMachinepage, choisissez Démarrer l'exécution.

   La boîte de dialogue Démarrer l'exécution s'affiche.

2. Dans la boîte de dialogue Démarrer l'exécution, procédez comme suit :

   1. (Facultatif) Entrez un nom d'exécution personnalisé pour remplacer le nom par défaut généré.

      Noms non ASCII et journalisation

      Step Functions accepte les noms des machines à états, des exécutions, des activités et des étiquettes contenant des caractères non ASCII. Comme ces caractères ne fonctionnent pas avec Amazon CloudWatch, nous vous recommandons de n'utiliser que des caractères ASCII afin de pouvoir suivre les statistiques. CloudWatch

   2. (Facultatif) Dans la zone de saisie, entrez les valeurs d'entrée au format JSON pour exécuter votre flux de travail.

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

   4. La console Step Functions vous dirige vers une page intitulée avec votre ID d'exécution. Cette page est connue sous le nom de page Détails de l'exécution. Sur cette page, vous pouvez consulter les résultats de l'exécution au fur et à mesure que l'exécution progresse ou une fois celle-ci terminée.

      Pour consulter les résultats de l'exécution, choisissez des états individuels dans la vue graphique, puis choisissez les onglets individuels du Détails de l'étape volet pour afficher les détails de chaque état, y compris les entrées, les sorties et la définition respectivement. Pour plus de détails sur les informations d'exécution que vous pouvez consulter sur la page Détails de l'exécution, voirVue d'ensemble des détails d'exécution.

3. Ouvrez la LambdaStateMachinepage et remarquez une nouvelle exécution déclenchée par le ParentStateMachine.