Didacticiel : création d’une API REST avec une intégration AWS

1. Suivez les étapes de Configuration d’API Gateway avant son utilisation.

2. Créez une nouvelle API nommée MyDemoAPI. Pour plus d’informations, consultez Didacticiel : création d’une API REST avec une intégration HTTP sans proxy.

3. Déployez l’API au moins une fois dans une étape nommée test. Pour plus d’informations, consultez Déployer l’API dans Choix d’un didacticiel d’intégration AWS Lambda.

4. Suivez le reste des étapes dans Choix d’un didacticiel d’intégration AWS Lambda.

5. Créez au moins une rubrique dans Amazon Simple Notification Service (Amazon SNS). Vous utiliserez l’API déployée pour obtenir la liste des rubriques d’Amazon SNS associées à votre compte AWS. Pour apprendre à créer une rubrique dans Amazon SNS, consultez Création d’une rubrique. (Vous n’avez pas besoin de copier l’ARN de la rubrique mentionné à l’étape 5.)

Pour créer le rôle d’exécution du proxy de service AWS

1. Connectez-vous à l’outil AWS Management Console, puis ouvrez la console IAM à l’adresse https://console.aws.amazon.com/iam/.

2. Sélectionnez Roles (Rôles).

3. Sélectionnez Créer un rôle.

4. Choisissez Service AWS sous Sélectionner le type d’entité de confiance, puis choisissez API Gateway et sélectionnez Autoriser API Gateway à transmettre des journaux à CloudWatch Logs.

5. Choisissez Suivant, puis Suivant.

6. Pour Nom du rôle, saisissez APIGatewaySNSProxyPolicy, puis choisissez Créer un rôle.

7. Dans la liste Roles, choisissez le rôle que vous venez de créer. Vous devrez peut-être faire défiler la page ou utiliser la barre de recherche pour rechercher le rôle.

8. Pour le rôle sélectionné, sélectionnez l’onglet Ajouter des autorisations.

9. Choisissez Attacher des politiques dans la liste déroulante.

10. Dans la barre de recherche, saisissez AmazonSNSReadOnlyAccess et choisissez Ajouter des autorisations.

    Note

    Ce didacticiel utilise une politique gérée pour plus de simplicité. Il est recommandé de créer votre propre politique IAM afin d’accorder les autorisations minimales requises.

11. Notez l’ARN du rôle nouvellement créé. Vous l’utiliserez ultérieurement.

Pour créer la ressource

1. Connectez-vous à la console API Gateway à l’adresse https://console.aws.amazon.com/apigateway.

2. Choisissez votre API.

3. Sélectionnez la racine de la ressource, /, représentée par une seule barre oblique (/), puis choisissez Créer une ressource.

4. Maintenez Ressource proxy désactivée.

5. Conservez Chemin de ressource sous la forme /.

6. Pour Nom de la ressource, entrez mydemoawsproxy.

7. Maintenez CORS (Partage des ressources entre origines multiples) désactivé.

8. Choisissez Créer une ressource.

Pour créer la méthode GET

1. Sélectionnez la ressource /mydemoawsproxy, puis choisissez Créer une méthode.

2. Pour le type de méthode, sélectionnez GET.

3. Pour Type d’intégration, sélectionnez Service AWS.

4. Pour Région AWS, sélectionnez la Région AWS où vous avez créé votre rubrique Amazon SNS.

5. Pour Service AWS, sélectionnez Amazon SNS.

6. Laissez Sous-domaine AWS vide.

7. Pour Méthode HTTP, sélectionnez GET.

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

9. Pour Nom de l’action, saisissez ListTopics.

10. Pour Rôle d’exécution, saisissez l’ARN de rôle pour APIGatewaySNSProxyPolicy.

11. Choisissez Créer une méthode.

Pour tester la méthode GET

1. Choisissez l’onglet Test. Vous devrez peut-être choisir la flèche droite pour afficher l’onglet.

2. Sélectionnez Tester.

   Le résultat affiche une réponse semblable à ce qui suit :

   {
     "ListTopicsResponse": {
       "ListTopicsResult": {
         "NextToken": null,
         "Topics": [
           {
             "TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-1"
           },
           {
             "TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-2"
           },
           ...
           {
             "TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-N"
           }
         ]
       },
       "ResponseMetadata": {
         "RequestId": "abc1de23-45fa-6789-b0c1-d2e345fa6b78"
       }
     }
   }

Pour déployer l’API

1. Sélectionnez Deploy API (Déployer une API).

2. Pour Étape, sélectionnez Nouvelle étape.

3. Sous Nom de l’étape, entrez test.

4. (Facultatif) Sous Description, entrez une description.

5. Choisissez Déployer.

1. Dans le volet de navigation principal, choisissez Étape.

2. Sous Détails de l’étape, choisissez l’icône de copie pour copier l’URL d’invocation de votre API.

   Elle doit ressembler à ce qui suit :

   https://my-api-id.execute-api.region-id.amazonaws.com/test

3. Collez l’URL dans la zone d’adresse d’un nouvel onglet du navigateur.

4. Ajoutez /mydemoawsproxy afin que l’URL ressemble à ce qui suit :

   https://my-api-id.execute-api.region-id.amazonaws.com/test/mydemoawsproxy

   Accédez à l’URL. Des informations similaires à celles qui suivent doivent s’afficher :

   {"ListTopicsResponse":{"ListTopicsResult":{"NextToken": null,"Topics":[{"TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-1"},{"TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-2"},...{"TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-N}]},"ResponseMetadata":{"RequestId":"abc1de23-45fa-6789-b0c1-d2e345fa6b78}}}

Pour supprimer les ressources IAM associées

1. Ouvrez la console IAM à l’adresse https://console.aws.amazon.com/iam/.

2. Dans la zone Details, sélectionnez Roles.

3. Sélectionnez ApigateWayawsProxyExecRole, puis choisissez Role Actions (Actions de rôle), Delete Role (Supprimer le rôle). À l’invite, sélectionnez Yes, Delete.

4. Dans la zone Details, sélectionnez Policies.

5. Sélectionnez ApigateWayawsProxyExecPolicy, puis choisissez Policy Actions (Actions de stratégie), Delete (Supprimer). À l’invite, sélectionnez Delete (Supprimer).