Tutoriel : Création d'une API REST avec une AWS intégration

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

2. Créez une nouvelle API nommée MyDemoAPI. Pour de plus amples informations, veuillez consulter 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 une liste des sujets associés à votre AWS compte sur Amazon SNS. 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 AWS service

1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à https://console.aws.amazon.com/iam/l'adresse.

2. Sélectionnez Roles.

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

4. Choisissez le AWS service sous Sélectionner le type d'entité de confiance, puis sélectionnez API Gateway et sélectionnez Allows API Gateway to push CloudWatch logs vers 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 la ressource sous la forme /.

6. Sous Resource Name (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 l' Région AWS endroit 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 Stage name (Nom de l’étape), entrez test.

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

5. Choisissez Deploy (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 Role Actions (Actions du rôle), et 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) et Delete (Supprimer). À l’invite, sélectionnez Delete (Supprimer).