Création d'une API Step Functions à l'aide d'API Gateway

Connectez-vous à la console IAM et choisissez Rôles, Créer un rôle.

Sur la page Select trusted entity (Sélectionner une entité de confiance), procédez comme suit :

1. Pour le type d'entité fiable, conservez la sélection par défaut de Service AWS.

2. Dans le cas d'utilisation, choisissez API Gateway dans la liste déroulante.

Sélectionnez API Gateway, puis Next.

Sur la page Ajouter des autorisations, sélectionnez Suivant.

(Facultatif) Sur la page Nom, révision et création, entrez des informations, telles que le nom du rôle. Par exemple, saisissez APIGatewayToStepFunctions.

Sélectionnez Créer un rôle.

Le rôle IAM apparaît dans la liste des rôles.

Choisissez le nom de votre rôle et notez l' ARN de rôle, comme illustré dans l'exemple suivant.

arn:aws:iam::123456789012:role/APIGatewayToStepFunctions

Sur la page Rôles, recherchez votre rôle (APIGatewayToStepFunctions), puis choisissez le rôle.

Dans l'onglet Autorisations, choisissez Ajouter des autorisations, puis choisissez Joindre des politiques.

Sur la page Joindre une politique, recherchezAWSStepFunctionsFullAccess, choisissez la politique, puis choisissez Ajouter des autorisations.

Ouvrez la console Amazon API Gateway, puis choisissez Create API.

Sur la page Choisissez un type d'API, dans le volet API REST, choisissez Build.

Sur la page Créer une API REST, sélectionnez Nouvelle API, puis entrez le nom StartExecutionAPI de l'API.

Conservez le type de point de terminaison d'API régional, puis choisissez Create API.

Sur la page Ressources deStartExecutionAPI, choisissez Créer une ressource.

Sur la page Créer une ressource, entrez le nom execution de la ressource, puis choisissez Créer une ressource.

Choisissez la ressource /execution, puis choisissez Create method.

Dans Type de méthode, sélectionnezPOST.

Pour Type d’intégration, choisissez Service AWS .

Pour Région AWS, choisissez une région dans la liste.

Pour Service AWS, choisissez Step Functions dans la liste.

Laissez Sous-domaine AWS vide.

Pour la méthode HTTP, choisissez POST dans la liste.

Pour Type d’action, sélectionnez Utiliser un nom d’action.

Pour Nom de l’action, saisissez StartExecution.

Pour le rôle d'exécution, entrez l'ARN du rôle IAM que vous avez créé précédemment, comme indiqué dans l'exemple suivant.

arn:aws:iam::123456789012:role/APIGatewayToStepFunctions

Conservez les options par défaut pour le cache des informations d'identification et le délai d'expiration par défaut, puis choisissez Enregistrer.

Sur la page /execution - POST - Method Execution, choisissez l'onglet Test. Vous devrez peut-être choisir la flèche droite pour afficher l’onglet.

Dans l'onglet /execution - POST - Method Test, copiez les paramètres de demande suivants dans la section Corps de la requête en utilisant l'ARN d'une machine à états existante (ou créez une nouvelle machine à états utilisant une fonction Lambda), puis choisissez Test.

{
   "input": "{}",
   "name": "MyExecution",
   "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld"
}

Pour plus d'informations, consultez la syntaxe des StartExecution demandes dans la référence de l'AWS Step Functions API.

{
    "input": "$util.escapeJavaScript($input.json('$'))",
    "stateMachineArn": "$util.escapeJavaScript($stageVariables.arn)"
}

L'exécution démarre et l'ARN d'exécution ainsi que sa date d'époque sont affichés sous le corps de la réponse.

{
   "executionArn": "arn:aws:states:us-east-1:123456789012:execution:HelloWorld:MyExecution",
   "startDate": 1486768956.878
}

Sur la page Ressources deStartExecutionAPI, choisissez Deploy API.

Pour Étape, sélectionnez Nouvelle étape.

Sous Stage name (Nom de l’étape), entrez alpha.

(Facultatif) Sous Description, entrez une description.

Choisissez Déployer.

Sur la page Stages deStartExecutionAPI, développez alpha,/, /execution, POST, puis choisissez la méthode POST.

Sous Method overrides, choisissez l'icône de copie pour copier l'URL d'appel de votre API. L'URL complète doit ressembler à l'exemple suivant.

https://a1b2c3d4e5.execute-api.us-east-1.amazonaws.com/alpha/execution

À partir de la ligne de commande, exécutez la commande curl à l'aide de l'ARN de votre machine d'état, puis appelez l'URL de votre déploiement, comme illustré dans l'exemple suivant :

curl -X POST -d '{"input": "{}","name": "MyExecution","stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld"}' https://a1b2c3d4e5.execute-api.us-east-1.amazonaws.com/alpha/execution

L'ARN d'exécution et sa date d'époque sont renvoyés, comme illustré dans l'exemple suivant.

{"executionArn":"arn:aws:states:us-east-1:123456789012:execution:HelloWorld:MyExecution","startDate":1.486772644911E9}