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.

Redrivingexécutions de machines à états dans Step Functions

Vous pouvez l'utiliser redrive pour redémarrer les exécutions de flux de travail standard qui ne se sont pas terminées correctement au cours des 14 derniers jours. Il s'agit notamment des exécutions échouées, abandonnées ou dont le délai imparti a expiré.

Lorsque vous effectuez redrive une exécution, elle poursuit l'exécution échouée à partir de l'étape infructueuse et utilise la même entrée. Step Functionspréserve les résultats et l'historique d'exécution des étapes réussies, et ces étapes ne sont pas réexécutées lors redrive d'une exécution. Supposons, par exemple, que votre flux de travail contienne deux états : un Passer l'état du flux de travail état suivi d'un État du flux de travail des tâches état. Si l'exécution de votre flux de travail échoue à l'état Tâche et que vous redrive l'exécutez, l'exécution replanifie puis réexécute l'état Tâche.

Redrivenles exécutions utilisent la même définition de machine à états et la même exécution ARN que celles utilisées lors de la tentative d'exécution initiale. Si votre tentative d'exécution initiale était associée à une version, à un alias ou aux deux, l'redrivenexécution est associée à la même version, au même alias, ou aux deux. Même si vous mettez à jour votre alias pour qu'il pointe vers une autre version, l'redrivenexécution continue d'utiliser la version associée à la tentative d'exécution initiale. Comme redriven les exécutions utilisent la même définition de machine à états, vous devez démarrer une nouvelle exécution si vous mettez à jour la définition de votre machine à états.

Lors redrive d'une exécution, le délai d'expiration au niveau de la machine à états, s'il est défini, est remis à 0. Pour plus d'informations sur le délai d'expiration au niveau de la machine à états, consultezTimeoutSeconds.

redrivesLes exécutions sont considérées comme des transitions d'état. Pour plus d'informations sur l'impact des transitions entre États sur la facturation, consultez Step Functions Pricing.

Redriveéligibilité en cas d'exécution infructueuse

Vous pouvez exécuter redrive des exécutions si votre tentative d'exécution initiale répond aux conditions suivantes :

Redrivecomportement des différents États

En fonction de l'état qui a échoué dans votre flux de travail, le redrive comportement de tous les états d'échec varie. Le tableau suivant décrit le redrive comportement de tous les états.

IAMautorisation redrive d'exécution

Step Functions a besoin d'une autorisation appropriée pour redrive une exécution. L'exemple IAM de politique suivant accorde le minimum de privilèges requis à votre machine d'état pour redriving une exécution. N'oubliez pas de remplacer le italicized texte contenant les informations spécifiques à votre ressource.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "states:RedriveExecution"
            ],
            "Resource": "arn:aws:states:us-east-2:123456789012:execution:myStateMachine:*"
        }
    ]
}

Pour un exemple de l'autorisation dont vous avez besoin pour exécuter redrive une carte, consultezExemple de IAM politique pour redriving une carte distribuée.

Redrivingexécutions dans la console

Vous pouvez redrive sélectionner des exécutions depuis la Step Functions console.

Par exemple, imaginez que vous exécutez une machine à états et qu'un état parallèle ne s'exécute pas.

L'image suivante montre qu'une étape LambdaInvoke nommée Do square number inside a Parallel state a renvoyé un échec. Cela a également entraîné l'échec de l'état parallèle. Les branches dont l'exécution était en cours ou non démarrée sont arrêtées et l'exécution de la machine d'état échoue.

Redrivingexécutions en utilisant API

Vous pouvez sélectionner redrive des exécutions à l'aide du RedriveExecutionAPI. Cela API redémarre les exécutions infructueuses des flux de travail standard à partir de l'étape qui a échoué, qui a été abandonnée ou qui a expiré.

Dans le AWS Command Line Interface (AWS CLI), exécutez la commande suivante en cas redrive d'échec de l'exécution de la machine à états. N'oubliez pas de remplacer le italicized texte contenant les informations spécifiques à votre ressource.

aws stepfunctions redrive-execution --execution-arn arn:aws:states:us-east-2:123456789012:execution:myStateMachine:foo

Examen des redriven exécutions

Vous pouvez examiner une redriven exécution dans la console ou à l'aide des APIs touches : GetExecutionHistoryet DescribeExecution.

Examinez les redriven exécutions en utilisant APIs

Si vous avez redriven une exécution par machine à états, vous pouvez utiliser l'une des méthodes suivantes APIs pour afficher les détails de l'redrivenexécution. N'oubliez pas de remplacer le italicized texte contenant les informations spécifiques à votre ressource.

Réessayer le comportement des exécutions redriven

Si votre redriven exécution réexécute un état État du flux de travail des tâchesÉtat du flux de travail parallèle, ou Inline Map, pour lequel vous avez défini de nouvelles tentatives, le nombre de tentatives pour ces états est remis à 0 pour tenir compte du nombre maximum de tentatives. redrive Pour une redriven exécution, vous pouvez suivre les tentatives de tentative individuelles de ces états à l'aide de la console.

L'image suivante montre un exemple des nouvelles tentatives effectuées pour un état lors de la tentative d'exécution initiale et redrives de cette exécution. Dans cette image, trois nouvelles tentatives sont effectuées lors des tentatives d'origine et d'redriveexécution. L'exécution réussit à la quatrième redrive tentative et renvoie une sortie de 16.