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.

Commencez à utiliser la REST API console

Dans cet exercice de démarrage, vous allez créer un serveur sans serveur à REST API l'aide de la REST API console 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.

Vous commencez par créer une fonction Lambda à l'aide de la console Lambda. Ensuite, vous créez un REST API à l'aide de la REST API console API Gateway. Ensuite, vous créez une API méthode et vous l'intégrez à une fonction Lambda à l'aide d'une intégration de proxy Lambda. Enfin, vous déployez et invoquez votreAPI.

Lorsque vous invoquez votre RESTAPI, API Gateway achemine la demande vers votre fonction Lambda. Lambda exécute la fonction et renvoie une réponse à API Gateway. APIGateway 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 de plus amples informations, veuillez consulter Configuration pour utiliser 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, à condition que la réponse de la fonction corresponde au format requis par Gateway. API

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éation d'un REST API

Ensuite, vous créez un REST API avec une ressource racine (/).

Étape 3 : Créer une intégration de proxy Lambda

Ensuite, vous créez une API méthode pour votre REST API ressource racine (/) et vous l'intégrez à votre fonction Lambda à l'aide d'une intégration par proxy. Dans une intégration de proxy Lambda, API Gateway transmet la demande entrante du client directement à la fonction Lambda.

Étape 4 : Déployez votre API

Ensuite, vous créez un API déploiement et vous l'associez à une étape.

Les clients peuvent désormais appeler votreAPI. Pour tester le vôtre API avant de le déployer, vous pouvez éventuellement choisir la ANYméthode, accéder à l'onglet Test, puis sélectionner Test.

Étape 5 : Invoquez votre 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 RESTAPI, votre fonction Lambda et les ressources associées.