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.
# Prise en main de la console d’API REST
Dans cet exercice de prise en main, vous allez créer une API REST sans serveur à l’aide de la console d’API REST API Gateway. Le mode APIs Serverless vous permet de vous concentrer sur vos applications au lieu de perdre votre temps à approvisionner et à gérer des serveurs. Cet exercice devrait prendre moins de 20 minutes et peut être réalisé avec l’[offre gratuite AWS](https://aws.amazon.com/free/).
Vous commencez par créer une fonction Lambda à l’aide de la console Lambda. Ensuite, vous créez une API REST à l’aide de la console d’API REST API Gateway. Ensuite, vous créez une méthode d’API et vous l’intégrez avec une fonction Lambda à l’aide d’une intégration de proxy Lambda. Enfin, vous allez déployer et invoquer votre API.
Lorsque vous invoquez votre API REST, API Gateway route la demande vers votre fonction Lambda. Lambda exécute la fonction et renvoie une réponse à API Gateway. API Gateway vous renvoie ensuite cette réponse.
![\[Vue d’ensemble de l’API REST que vous créez dans ce didacticiel.\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/getting-started-overview-rest.png)
Pour effectuer cet exercice, vous avez besoin d'un utilisateur Compte AWS et d'un Gestion des identités et des accès AWS (IAM) ayant accès à la console. Pour de plus amples informations, veuillez consulter [Configuration d’API Gateway avant son utilisation](setting-up.md).
**Topics**
+ [Étape 1 : créer une fonction Lambda](#getting-started-rest-new-console-create-function)
+ [Étape 2 : Créer une API REST](#getting-started-rest-new-console-create-api)
+ [Étape 3 : créer une intégration de proxy Lambda](#getting-started-rest-new-console-create-integration)
+ [Étape 4 : déployer votre API](#getting-started-rest-new-console-deploy)
+ [Étape 5 : Invoquer l’API](#getting-started-rest-new-console-invoke-api)
+ [(Facultatif) Étape 6 : nettoyer](#getting-started-cleanup-rest)
## Étape 1 : créer une fonction Lambda
Vous utilisez une fonction Lambda pour le backend de votre API. Lambda exécute le code uniquement lorsque cela est nécessaire et se met à l’échelle automatiquement, qu’il s’agisse de quelques requêtes par jour ou de milliers de requêtes par seconde.
Pour cet exercice, vous utilisez une fonction Node.js par défaut dans la console Lambda.
**Pour créer une fonction Lambda**
1. [Connectez-vous à la console Lambda à l'adresse /lambda. https://console.aws.amazon.com](https://console.aws.amazon.com/lambda)
1. Sélectionnez **Create function** (Créer une fonction).
1. Sous **Informations de base**, pour **Nom de la fonction**, entrez **my-function**.
1. Pour toutes les autres options, utilisez le paramètre par défaut.
1. Choisissez **Créer une fonction**.
Le code de la fonction Lambda par défaut devrait ressembler à ce qui suit :
```
export const handler = async (event) => {
const response = {
statusCode: 200,
body: JSON.stringify('The API Gateway REST API console is great!'),
};
return response;
};
```
Vous pouvez modifier votre fonction Lambda pour cet exercice, tant que la réponse de la fonction s’aligne sur le [format requis par API Gateway](set-up-lambda-proxy-integrations.md#api-gateway-simple-proxy-for-lambda-output-format).
Remplacez le corps de réponse par défaut (`Hello from Lambda!`) par `The API Gateway REST API console is great!`. Lorsque vous invoquez l’exemple de fonction, il renvoie une réponse `200` aux clients, ainsi que la réponse mise à jour.
## Étape 2 : Créer une API REST
Ensuite, vous créez une API REST avec une ressource racine (`/`).
**Pour créer une API REST**
1. Connectez-vous à la console API Gateway à l'adresse [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)
1. Effectuez l’une des actions suivantes :
+ Pour créer votre première API, pour **API REST**, choisissez **Création**.
+ Si vous avez déjà créé une API, choisissez **Créer une API**, puis **Création** pour **API REST**.
1. Sous **API name (Nom de l’API)**, saisissez **my-rest-api**.
1. (Facultatif) Sous **Description**, entrez une description.
1. Laissez **Type de point de terminaison d’API** défini sur **Régional**.
1. Pour le **type d'adresse IP**, sélectionnez **IPv4**.
1. Sélectionnez **Create API** (Créer une API).
## Étape 3 : créer une intégration de proxy Lambda
Ensuite, vous devez créer une méthode d’API pour votre API REST sur la ressource racine (`/`) et intégrer la méthode avec votre fonction Lambda à l’aide d’une intégration de proxy. Dans une intégration de proxy Lambda, API Gateway transmet la demande entrante du client directement à la fonction Lambda.
**Pour créer une intégration de proxy Lambda**
1. Sélectionnez la ressource `/`, puis choisissez **Créer une méthode**.
1. Pour **Type de méthode**, sélectionnez `ANY`.
1. Pour **Type d’intégration**, sélectionnez **Lambda**
1. Activez **Intégration de proxy Lambda**.
1. Pour **Fonction Lambda**, entrez **my-function**, puis sélectionnez votre fonction Lambda.
1. Choisissez **Créer une méthode**.
## Étape 4 : déployer votre API
Ensuite, vous devez créer un déploiement d’API et l’associer à une étape.
**Pour déployer votre API**
1. Sélectionnez **Deploy API (Déployer une API)**.
1. Pour **Étape**, sélectionnez **Nouvelle étape**.
1. Sous **Stage name (Nom de l’étape)**, entrez **Prod**.
1. (Facultatif) Sous **Description**, entrez une description.
1. Choisissez **Déployer**.
Les clients peuvent désormais appeler votre API. Pour tester votre API avant de la déployer, vous pouvez éventuellement choisir la méthode **ANY**, accéder à l’onglet **Tester**, puis choisir **Tester**.
## Étape 5 : Invoquer l’API
**Pour invoquer votre API**
1. Dans le panneau de navigation principal, choisissez **Étape**.
1. Sous **Détails de l'étape**, choisissez l'icône de copie pour copier l'URL d'invocation de votre API.
![\[Une fois que vous avez créé votre API REST, la console affiche l'URL d'invocation de votre API.\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/getting-started-rest-invoke-url.png)
1. Entrez cette URL d’invocation dans un navigateur Web.
L’URL complète doit ressembler à `https://abcd123.execute-api.us-east-2.amazonaws.com/Prod`.
Votre navigateur envoie une requête `GET` à l’API.
1. Vérifiez la réponse de votre API. Vous devriez voir le texte `"The API Gateway REST API console is great!"` dans votre navigateur.
## (Facultatif) Étape 6 : nettoyer
Pour éviter de vous faire supporter des coûts inutiles Compte AWS, supprimez les ressources que vous avez créées dans le cadre de cet exercice. Les étapes suivantes suppriment votre API REST, votre fonction Lambda, ainsi que les ressources associées.
**Pour supprimer votre API REST**
1. Dans le volet **Ressources**, choisissez **Actions d’API**, puis **Supprimer l’API**.
1. Dans la boîte de dialogue **Supprimer l’API**, entrez **confirm**, puis choisissez **Supprimer**.
**Pour supprimer votre fonction Lambda**
1. [Connectez-vous à la console Lambda à l'adresse /lambda. https://console.aws.amazon.com](https://console.aws.amazon.com/lambda)
1. Sur la page **Fonctions**, sélectionnez votre fonction. Sélectionnez **Actions**, **Supprimer**.
1. Dans la boîte de dialogue **Supprimer 1 fonctions**, entrez **delete**, puis choisissez **Supprimer**.
**Pour supprimer le groupe de journaux de votre fonction Lambda**
1. Ouvrez la [page Log groups](https://console.aws.amazon.com/cloudwatch/home#logs:) de la CloudWatch console Amazon.
1. Sur la page **Groupes de journaux**, sélectionnez le groupe de journaux de votre fonction (`/aws/lambda/my-function`). Ensuite, pour **Actions**, choisissez **Supprimer le ou les groupes de journaux**.
1. Dans la boîte de dialogue **Supprimer le ou les groupes de journaux**, choisissez **Supprimer**.
**Pour supprimer le rôle d’exécution de votre fonction Lambda**
1. Ouvrez la [page Roles](https://console.aws.amazon.com/iam/home?#/roles) (Rôles) de la console IAM.
1. (Facultatif) Sur la page **Rôles**, dans la zone de recherche, entrez **my-function**.
1. Sélectionnez le rôle de votre fonction (par exemple, `my-function-31exxmpl`), puis choisissez **Supprimer**.
1. Dans la boîte de dialogue **Supprimer `my-function-31exxmpl` ?**, entrez le nom du rôle, puis choisissez **Supprimer**.
**Astuce**
Vous pouvez automatiser la création et le nettoyage des AWS ressources à l'aide de AWS CloudFormation or AWS Serverless Application Model (AWS SAM). Pour des exemples de CloudFormation modèles, consultez les [exemples de modèles pour API Gateway](https://github.com/awsdocs/amazon-api-gateway-developer-guide/tree/main/cloudformation-templates) dans le référentiel **awsdocs** GitHub .