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.

Bien démarrer avec 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. Les API sans serveur vous permettent de vous concentrer sur vos applications, plutôt que de passer du temps à provisionner et gérer des serveurs. Cet exercice devrait prendre moins de 20 minutes et peut être réalisé avec l'offre gratuite AWS.

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 à 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.

Pour effectuer cet exercice, vous avez besoin d'un utilisateur Compte AWS et d'un AWS Identity and Access Management (IAM) ayant accès à la console. Pour plus d’informations, consultez Prérequis pour démarrer avec API Gateway.

É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.

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.

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 (/).

É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 à 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.

Étape 4 : Déployer votre API

Ensuite, vous devez créer un déploiement d'API et l'associer à une étape.

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

(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.