Poursuivre les flux de travail de longue durée à l'aide de Step Functions API (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'StartExecutionAPIaction 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, sélectionnez AWS SDK- nouveau dans la liste déroulante.

   3. Dans APIParamètres, procédez comme suit :

      1. PourStateMachineArn, remplacez l'exemple de nom de ressource Amazon par celui ARN de votre machine à états. Par exemple, entrez le 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 APIParamètres 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 ASL définition dans Workflow Studio. Éditeur de code Dans l'éditeur de code, vous pouvez également modifier la ASL définition 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 IAM rôle 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 rôle, ARN puis fournir un ARN pour ce IAM rôle.

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 IAM rôle 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 IAM politique), Step Functions ne pourra pas restaurer ses paramètres d'origine ultérieurement.

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

2. Attribuez une autorisation appropriée au IAM rôle 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 IAM Rôles, choisissez Ajouter des autorisations, puis choisissez Créer une politique intégrée.

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

   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 le nom de la stratégie, puis choisissez Create policy.

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é.

      ASCIINon-noms et journalisation

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

   2. (Facultatif) Dans la zone de saisie, entrez les valeurs d'entrée dans un JSON format permettant d'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.