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

1. Suivez les étapes de Configuration pour utiliser API Gateway.

2. Créez une nouvelle API nommée MyDemoAPI. Pour de plus amples informations, veuillez consulter Tutoriel : créer un REST API avec une HTTP intégration sans proxy.

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

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

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 à l'adresse https://console.aws.amazon.com/iam/.

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 stratégie gérée pour plus de simplicité. Il est recommandé de créer votre propre stratégie 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 APIGateway AWSProxyExecRole, puis choisissez Actions de rôle, Supprimer le rôle. A l'invite, sélectionnez Yes, Delete.

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

5. Sélectionnez APIGateway AWSProxyExecPolicy, puis choisissez Policy Actions, Supprimer. A l'invite, sélectionnez Delete (Supprimer).