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.
Tutoriel : Création d'une calculatrice REST API avec deux intégrations AWS de services et une intégration Lambda sans proxy
Ils Tutoriel : Création d'RESTAPIune intégration Lambda sans proxy utilisent exclusivement Lambda Function
l'intégration. Lambda Function
L'intégration est un cas particulier du type d'AWS
Service
intégration qui effectue une grande partie de la configuration de l'intégration pour vous, par exemple en ajoutant automatiquement les autorisations basées sur les ressources requises pour appeler la fonction Lambda. Ici, deux des trois intégrations utilisent l'intégration AWS Service
. Dans ce type d'intégration, vous avez plus de contrôle, mais vous devrez effectuer manuellement des tâches telles que la création et la spécification d'un IAM rôle contenant les autorisations appropriées.
Dans ce didacticiel, vous allez créer une fonction Calc
Lambda qui implémente des opérations arithmétiques de base, en acceptant et en renvoyant des entrées et des sorties JSON formatées. Vous allez ensuite créer un REST API et l'intégrer à la fonction Lambda de la manière suivante :
-
En exposant une méthode
GET
sur la ressource/calc
pour appeler la fonction Lambda, en fournissant l'entrée en tant que paramètres de chaîne de requête. (IntégrationAWS Service
) -
En exposant une méthode
POST
sur la ressource/calc
pour appeler la fonction Lambda, en fournissant l'entrée dans la charge utile de la demande de méthode. (IntégrationAWS Service
) -
En exposant une méthode
GET
sur les ressources/calc/{operand1}/{operand2}/{operator}
imbriquées pour appeler la fonction Lambda, en fournissant les données d'entrée en tant que paramètres de chemin. (IntégrationLambda Function
)
En plus d'essayer ce didacticiel, vous souhaiterez peut-être étudier le fichier de API définition ouvert pour le Calc
API, que vous pouvez importer dans API Gateway en suivant les instructions deDéveloppez REST APIs à l'aide d'Open API in API Gateway.
Rubriques
- Création d'un rôle IAM assumable
- Création d'une fonction Lambda Calc
- Test de la fonction Lambda Calc
- Créez un Calc API
- Intégration 1 : Création d'une méthode GET avec des paramètres de requête pour appeler la fonction Lambda
- Intégration 2 : créer une POST méthode avec une JSON charge utile pour appeler la fonction Lambda
- Intégration 3 : Création d'une méthode GET avec des paramètres de chemin pour appeler la fonction Lambda
- APIDéfinitions ouvertes d'un échantillon API intégré à une fonction Lambda
Création d'un rôle IAM assumable
Pour pouvoir invoquer votre API fonction Calc
Lambda, vous devez disposer d'un rôle assumable de API passerelle, qui est un IAM IAM rôle doté de la relation de confiance suivante :
{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "apigateway.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
Le rôle que vous créez doit disposer de l'autorisation Lambda InvokeFunction. Dans le cas contraire, l'APIappelant recevra une 500 Internal Server Error
réponse. Pour accorder cette autorisation au rôle, vous devez y associer la IAM politique suivante :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "lambda:InvokeFunction", "Resource": "*" } ] }
Voici comment procéder :
Création d'un rôle assumable IAM de API passerelle
-
Connectez-vous à la console IAM.
-
Sélectionnez Roles.
-
Choisissez Create Role (Créer le rôle).
-
Sous Sélectionner un type d’entité de confiance, choisissez AWS Service.
-
Sous Choose the service that will use this role (Choisir le service qui utilisera ce rôle), choisissez Lambda.
-
Sélectionnez Next: Permissions (Suivant : autorisations).
-
Choisissez Create Policy (Créer une politique).
Une nouvelle fenêtre de console Create Policy (Créer une politique) s'ouvre. Dans cette fenêtre, procédez de la façon suivante :
-
Dans l'JSONonglet, remplacez la politique existante par la suivante :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "lambda:InvokeFunction", "Resource": "*" } ] }
-
Choisissez Examiner une politique.
-
Sous Review Policy (Examiner une politique), procédez comme suit :
-
Pour Nom, tapez un nom, par exemple
lambda_execute
. -
Choisissez Créer une politique.
-
-
-
Dans la fenêtre de console d'origine Create Role (Créer un rôle), procédez comme suit :
-
Sous Attach permissions policies (Attacher des politiques d'autorisations), choisissez votre politique
lambda_execute
dans la liste déroulante.Si votre politique n'est pas répertoriée dans la liste, cliquez sur le bouton d'actualisation en haut de la liste. (N'actualisez pas la page du navigateur.)
-
Choisissez Next:Tags (Suivant : balises).
-
Choisissez Next: Review (Suivant : vérifier).
-
Sous Role name (Nom du rôle), saisissez un nom tel que
lambda_invoke_function_assume_apigw_role
. -
Sélectionnez Créer un rôle.
-
-
Choisissez votre rôle
lambda_invoke_function_assume_apigw_role
dans la liste. -
Choisissez l'onglet Trust relationships.
-
Choisissez Modifier la relation d'approbation.
-
Remplacez la stratégie existante comme suit :
{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": [ "lambda.amazonaws.com", "apigateway.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] }
-
Choisissez Update Trust Policy.
-
Notez le rôle ARN pour le rôle que vous venez de créer. Vous en aurez besoin ultérieurement.
Création d'une fonction Lambda Calc
Vous créerez ensuite une fonction Lambda à l'aide de la console Lambda.
-
Dans la console Lambda, choisissez Create function (Créer une fonction).
-
Choisissez Créer à partir de zéro.
-
Pour Nom, saisissez
Calc
. -
Pour Exécution, choisissez le dernier environnement d’exécution Node.js ou Python compatible.
Pour toutes les autres options, utilisez le paramètre par défaut.
-
Sélectionnez Create function (Créer une fonction).
-
Copiez la fonction Lambda suivante dans votre environnement d’exécution préféré et collez-la dans l’éditeur de code de la console Lambda.
-
Sous Execution role (Rôle d'exécution), choisissez Choose an existing role (Choisir un rôle existant).
-
Entrez le rôle correspondant ARN au
lambda_invoke_function_assume_apigw_role
rôle que vous avez créé précédemment. -
Choisissez Deploy (Déployer).
Cette fonction nécessite deux opérandes (a
et b
) et un opérateur (op
) à partir du paramètre d'entrée event
. L'entrée est un JSON objet au format suivant :
{ "a": "Number" | "String", "b": "Number" | "String", "op": "String" }
Cette fonction renvoie le résultat calculé (c
) et les données d'entrée. En cas d'entrée non valide, la fonction renvoie la valeur null ou la chaîne « Opération non valide » en tant que résultat. La sortie est au JSON format suivant :
{ "a": "Number", "b": "Number", "op": "String", "c": "Number" | "String" }
Vous devez tester la fonction dans la console Lambda avant de l'intégrer API à l'étape suivante.
Test de la fonction Lambda Calc
Voici comment tester la fonction Calc
dans la console Lambda :
-
Choisissez l’onglet Test.
-
Entrez comme nom de l'événement de tes
calc2plus5
. -
Remplacez la définition de l'événement de test par ce qui suit :
{ "a": "2", "b": "5", "op": "+" }
-
Choisissez Save (Enregistrer).
-
Sélectionnez Test (Tester).
-
Développez Résultat de l'exécution : réussite. Vous devez voir ce qui suit :
{ "a": 2, "b": 5, "op": "+", "c": 7 }
Créez un Calc
API
La procédure suivante montre comment créer un API pour la fonction Calc
Lambda que vous venez de créer. Dans les sections suivantes, vous allez y ajouter des ressources et des méthodes.
Pour créer un API
Connectez-vous à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway.
-
Si c'est la première fois que vous utilisez API Gateway, une page vous présentant les fonctionnalités du service s'affiche. Sous RESTAPI, choisissez Build. Lorsque la API fenêtre contextuelle Create Example apparaît, cliquez sur OK.
Si ce n'est pas la première fois que vous utilisez API Gateway, choisissez Create API. Sous RESTAPI, choisissez Build.
Pour APIle nom, entrez
LambdaCalc
.(Facultatif) Sous Description, entrez une description.
Conservez le type de API point de terminaison défini sur Régional.
Choisissez Créer API.
Intégration 1 : Création d'une méthode GET
avec des paramètres de requête pour appeler la fonction Lambda
En créant une GET
méthode qui transmet les paramètres de chaîne de requête à la fonction Lambda, vous permettez API à celle-ci d'être invoquée depuis un navigateur. Cette approche peut être utile, en particulier si APIs elle permet le libre accès.
Après avoir créé unAPI, vous créez une ressource. Généralement, les API ressources sont organisées dans une arborescence de ressources conformément à la logique de l'application. Pour cette étape, vous créez une ressource /calc.
Pour créer une ressource /calc
Choisissez Créer une ressource.
Maintenez Ressource proxy désactivée.
Conservez Chemin de la ressource sous la forme
/
.Sous Resource Name (Nom de la ressource), entrez
calc
.Maintenez CORS(Cross Origin Resource Sharing) désactivé.
Choisissez Créer une ressource.
En créant une GET
méthode qui transmet les paramètres de chaîne de requête à la fonction Lambda, vous permettez API à celle-ci d'être invoquée depuis un navigateur. Cette approche peut être utile, en particulier si APIs elle permet le libre accès.
Dans cette méthode, Lambda exige que la requête POST
soit utilisée pour invoquer une fonction Lambda. Cet exemple montre que la HTTP méthode d'une demande de méthode frontale peut être différente de la demande d'intégration du backend.
Pour créer une méthode GET
Sélectionnez la ressource /calc, puis choisissez Créer une méthode.
Pour Type de méthode, sélectionnez GET.
Pour Type d’intégration, sélectionnez AWS service.
Pour Région AWS, sélectionnez l' Région AWS endroit où vous avez créé votre fonction Lambda.
Pour AWS service, sélectionnez Lambda.
Laissez Sous-domaine AWS vide.
Pour la HTTPméthode, sélectionnez POST.
Pour Type d’action, sélectionnez Utiliser un remplacement de chemin. Cette option nous permet de spécifier ARN l'action Invoke pour exécuter notre
Calc
fonction.Pour Remplacement de chemin, saisissez
2015-03-31/functions/arn:aws:lambda:
. Pourus-east-2
:account-id
:function:Calc/invocationsaccount-id
, entrez l' Région AWS endroit où vous avez créé votre fonction Lambda.us-east-2
Pour Rôle d'exécution, entrez le rôle ARN pour
lambda_invoke_function_assume_apigw_role
.Ne modifiez pas les paramètres de Cache d’informations d’identification et de Délai d’attente par défaut.
Choisissez les paramètres de demande de méthode.
Pour Validateur de requête, sélectionnez Valider les paramètres de chaîne de requête et les en-têtes.
Ce paramètre renvoie un message d’erreur si le client ne spécifie pas les paramètres requis.
Choisissez les paramètres de la chaîne de URL requête.
Vous configurez maintenant les paramètres de chaîne de requête pour la GETméthode sur la ressource /calc afin qu'elle puisse recevoir des entrées au nom de la fonction Lambda principale.
Pour créer les paramètres de chaîne de requête, procédez comme suit :
Sélectionnez Add query string (Ajouter une chaîne de requêtes).
Pour Name (Nom), saisissez
operand1
.Activez Obligatoire.
Maintenez Mise en cache désactivée.
Répétez les mêmes étapes et créez une chaîne de requête nommée
operand2
et une chaîne de requête nomméeoperator
.Choisissez Créer une méthode.
Maintenant, vous créez un modèle de mappage afin de convertir les chaînes de requête fournies par le client en la charge utile de requête d’intégration, comme requis par la fonction Calc
. Ce modèle fait correspondre les trois paramètres de chaîne de requête déclarés dans la demande de méthode aux valeurs de propriété désignées de l'JSONobjet en tant qu'entrée de la fonction Lambda principale. L'JSONobjet transformé sera inclus en tant que charge utile de la demande d'intégration.
Pour mapper les paramètres d’entrée à la requête d’intégration
Dans l’onglet Requête d’intégration, sous Paramètres de requête d’intégration, choisissez Modifier.
Pour Transmission du corps de requête, sélectionnez Lorsqu’aucun modèle n’est défini (recommandé).
Choisissez Modèles de mappage.
Sélectionnez Add mapping template.
Pour Type de contenu, entrez
application/json
.Pour Corps du modèle, entrez le code suivant :
{ "a": "$input.params('operand1')", "b": "$input.params('operand2')", "op": "$input.params('operator')" }
Choisissez Save (Enregistrer).
Vous pouvez maintenant tester votre méthode GET
pour vérifier qu’elle a été correctement configurée pour invoquer la fonction Lambda.
Pour tester la méthode GET
-
Choisissez l’onglet Test. Vous devrez peut-être choisir la flèche droite pour afficher l'onglet.
Pour Chaînes de requête, saisissez
operand1=2&operand2=3&operator=+
.-
Sélectionnez Test.
Les résultats doivent ressembler à ce qui suit :
Intégration 2 : créer une POST
méthode avec une JSON charge utile pour appeler la fonction Lambda
En créant une POST
méthode avec une JSON charge utile pour appeler la fonction Lambda, vous faites en sorte que le client doive fournir les entrées nécessaires à la fonction principale dans le corps de la demande. Pour vous assurer que le client charge les données d'entrée correctes, vous allez activer la validation de demande sur la charge utile.
Pour créer une POST
méthode avec une JSON charge utile
Sélectionnez la ressource /calc, puis choisissez Créer une méthode.
Pour Type de méthode, sélectionnez POST.
Pour Type d’intégration, sélectionnez AWS service.
Pour Région AWS, sélectionnez l' Région AWS endroit où vous avez créé votre fonction Lambda.
Pour AWS service, sélectionnez Lambda.
Laissez Sous-domaine AWS vide.
Pour la HTTPméthode, sélectionnez POST.
Pour Type d’action, sélectionnez Utiliser un remplacement de chemin. Cette option nous permet de spécifier ARN l'action Invoke pour exécuter notre
Calc
fonction.Pour Remplacement de chemin, saisissez
2015-03-31/functions/arn:aws:lambda:
. Pourus-east-2
:account-id
:function:Calc/invocationsaccount-id
, entrez l' Région AWS endroit où vous avez créé votre fonction Lambda.us-east-2
Pour Rôle d'exécution, entrez le rôle ARN pour
lambda_invoke_function_assume_apigw_role
.Ne modifiez pas les paramètres de Cache d’informations d’identification et de Délai d’attente par défaut.
Choisissez Créer une méthode.
Maintenant, vous créez un modèle d’entrée pour décrire la structure des données d’entrée et valider le corps de la requête entrante.
Pour créer un modèle d’entrée
-
Dans le volet de navigation principal, choisissez Modèles.
-
Sélectionnez Create model.
-
Pour Name (Nom), saisissez
input
. -
Pour Type de contenu, entrez
application/json
.Si aucun type de contenu correspondant n'est trouvé, la validation de demande n'est pas effectuée. Pour utiliser le même modèle quel que soit le type de contenu, saisissez
$default
. -
Pour Schéma du modèle, saisissez le modèle qui suit :
{ "type":"object", "properties":{ "a":{"type":"number"}, "b":{"type":"number"}, "op":{"type":"string"} }, "title":"input" }
Sélectionnez Create model.
Vous créez maintenant un modèle de sortie. Ce modèle décrit la structure de données de la sortie calculée à partir du serveur principal. Elle peut être utilisée pour mapper les données de réponse d'intégration à un autre modèle. Ce didacticiel s'appuie sur le comportement de transmission et n'utilise pas ce modèle.
Pour créer un modèle de sortie
-
Sélectionnez Create model.
-
Pour Name (Nom), saisissez
output
. -
Pour Type de contenu, entrez
application/json
.Si aucun type de contenu correspondant n'est trouvé, la validation de demande n'est pas effectuée. Pour utiliser le même modèle quel que soit le type de contenu, saisissez
$default
. -
Pour Schéma du modèle, saisissez le modèle qui suit :
{ "type":"object", "properties":{ "c":{"type":"number"} }, "title":"output" }
Sélectionnez Create model.
Vous créez maintenant un modèle de résultat. Ce modèle décrit la structure de données des données de réponse renvoyées. Il fait référence aux schémas d'entrée et de sortie définis dans votreAPI.
Pour créer un modèle de résultat
-
Sélectionnez Create model.
-
Pour Name (Nom), saisissez
result
. -
Pour Type de contenu, entrez
application/json
.Si aucun type de contenu correspondant n'est trouvé, la validation de demande n'est pas effectuée. Pour utiliser le même modèle quel que soit le type de contenu, saisissez
$default
. -
Pour Schéma du modèle, entrez le modèle suivant avec votre
restapi-id
. Votrerestapi-id
est répertorié entre parenthèses en haut de la console dans le flux suivant :API Gateway > APIs > LambdaCalc (
abc123
).{ "type":"object", "properties":{ "input":{ "$ref":"https://apigateway.amazonaws.com/restapis/
restapi-id
/models/input" }, "output":{ "$ref":"https://apigateway.amazonaws.com/restapis/restapi-id
/models/output" } }, "title":"result" } Sélectionnez Create model.
Vous configurez maintenant la demande de méthode de votre POST méthode pour activer la validation de la demande sur le corps de la demande entrante.
Pour activer la validation des demandes sur la POST méthode
-
Dans le volet de navigation principal, choisissez Ressources, puis sélectionnez la méthode
POST
dans l’arborescence de ressources. -
Dans l'onglet Demande de méthode, sous Paramètres de demande de méthode, choisissez Modifier.
Pour Validateur de requête, sélectionnez Valider le corps.
Choisissez Corps de la requête, puis choisissez Ajouter un modèle.
Pour Type de contenu, entrez
application/json
.Si aucun type de contenu correspondant n'est trouvé, la validation de demande n'est pas effectuée. Pour utiliser le même modèle quel que soit le type de contenu, saisissez
$default
.Pour Modèle, sélectionnez entrée.
Choisissez Save (Enregistrer).
Vous pouvez maintenant tester votre méthode POST
pour vérifier qu’elle a été correctement configurée pour invoquer la fonction Lambda.
Pour tester la méthode POST
-
Choisissez l’onglet Test. Vous devrez peut-être choisir la flèche droite pour afficher l'onglet.
Pour le corps de la demande, entrez la JSON charge utile suivante.
{ "a": 1, "b": 2, "op": "+" }
-
Sélectionnez Tester).
Vous devriez voir la sortie suivante :
{ "a": 1, "b": 2, "op": "+", "c": 3 }
Intégration 3 : Création d'une méthode GET
avec des paramètres de chemin pour appeler la fonction Lambda
Vous allez maintenant créer une méthode GET
sur une ressource spécifiée par une séquence de paramètres de chemin pour appeler la fonction Lambda du backend. Les valeurs de paramètre de chemin spécifient les données d'entrée de la fonction Lambda. Vous allez utiliser un modèle de mappage afin de mapper les valeurs de paramètres de chemin entrantes à la charge utile de demande d'intégration requise.
La structure de API ressources qui en résultera ressemblera à ceci :
![Création d'une API passerelle API intégrée en tant que proxy Lambda](images/aws_proxy_lambda_create_api_resources_new_console.png)
Pour créer une ressource /{operand1}/{operand2}/{operator}
Choisissez Créer une ressource.
Pour Chemin de ressource, sélectionnez
/calc
.Sous Resource Name (Nom de la ressource), entrez
{operand1}
.Maintenez CORS(Cross Origin Resource Sharing) désactivé.
Choisissez Créer une ressource.
Pour Chemin de ressource, sélectionnez
/calc/{operand1}/
.Sous Resource Name (Nom de la ressource), entrez
{operand2}
.Maintenez CORS(Cross Origin Resource Sharing) désactivé.
Choisissez Créer une ressource.
Pour Chemin de ressource, sélectionnez
/calc/{operand1}/{operand2}/
.Sous Resource Name (Nom de la ressource), entrez
{operator}
.Maintenez CORS(Cross Origin Resource Sharing) désactivé.
Choisissez Créer une ressource.
Cette fois, vous allez utiliser l'intégration Lambda intégrée dans la console API Gateway pour configurer l'intégration des méthodes.
Pour configurer une intégration de méthode
Sélectionnez la ressource/{operand1}/{operand2}/{operator}, puis choisissez Créer une méthode.
Pour Type de méthode, sélectionnez GET.
Pour Type d'intégration, sélectionnez Lambda
Maintenez Intégration proxy Lambda désactivée.
Pour la fonction Lambda, sélectionnez l' Région AWS endroit où vous avez créé votre fonction Lambda et entrez.
Calc
Maintenez Délai d’expiration par défaut activé.
Choisissez Créer une méthode.
Vous créez maintenant un modèle de mappage pour mapper les trois paramètres de URL chemin, déclarés lors de la création de la ressource /calc/ {operand1}/{operand2}/{operator}, aux valeurs de propriété désignées dans l'objet. JSON Comme URL les chemins doivent être URL codés, l'opérateur de division doit être spécifié comme étant %2F
au lieu de/
. Ce modèle convertit %2F
en '/'
avant de le transmettre à la fonction Lambda.
Pour créer un modèle de mappage
Dans l’onglet Requête d’intégration, sous Paramètres de requête d’intégration, choisissez Modifier.
Pour Transmission du corps de requête, sélectionnez Lorsqu’aucun modèle n’est défini (recommandé).
Choisissez Modèles de mappage.
Pour Type de contenu, entrez
application/json
.Pour Corps du modèle, entrez le code suivant :
{ "a": "$input.params('operand1')", "b": "$input.params('operand2')", "op": #if($input.params('operator')=='%2F')"/"#{else}"$input.params('operator')"#end }
Choisissez Save (Enregistrer).
Vous pouvez maintenant tester votre méthode GET
pour vérifier qu’elle a été correctement configurée pour invoquer la fonction Lambda et transmettre le résultat d’origine via la réponse d’intégration sans mappage.
Pour tester la méthode GET
-
Choisissez l’onglet Test. Vous devrez peut-être choisir la flèche droite pour afficher l'onglet.
-
Pour Chemin, procédez comme suit :
Pour opérande 1, saisissez
1
.Pour opérande 2, saisissez
1
.Pour opérateur, saisissez
+
.
-
Sélectionnez Test.
-
Le résultat doit se présenter comme suit :
Ensuite, vous modélisez la structure de données de la charge utile de réponse de méthode après le schéma result
.
Par défaut, un modèle vide est attribué au corps de réponse de méthode. Cela entraînera la transmission du corps de réponse d'intégration sans mappage. Cependant, lorsque vous générez un SDK pour l'un des langages les plus courants, tels que Java ou Objective-C, vos SDK utilisateurs recevront un objet vide en conséquence. Pour garantir que le REST client et les SDK clients reçoivent le résultat souhaité, vous devez modéliser les données de réponse à l'aide d'un schéma prédéfini. Ici, vous allez définir un modèle pour le corps de réponse de méthode et construire un modèle de mappage pour traduire le corps de réponse d'intégration en corps de réponse de méthode.
Pour créer une réponse de méthode
-
Dans l’onglet Méthode de réponse, sous Réponse 200, choisissez Modifier.
-
Sous Corps de la réponse, choisissez Ajouter un modèle.
-
Pour Type de contenu, entrez
application/json
. -
Pour Modèle, sélectionnez Résultat.
-
Choisissez Save (Enregistrer).
La définition du modèle pour le corps de réponse de la méthode garantit que les données de réponse seront converties dans l'result
objet d'une donnéeSDK. Pour vous assurer que les données de réponse d'intégration sont mappées en conséquence, un modèle de mappage est nécessaire.
Pour créer un modèle de mappage
Dans l’onglet Réponse d’intégration, sous Par défaut - Réponse, choisissez Modifier.
Choisissez Modèles de mappage.
Pour Type de contenu, entrez
application/json
.Pour Corps du modèle, entrez le code suivant :
#set($inputRoot = $input.path('$')) { "input" : { "a" : $inputRoot.a, "b" : $inputRoot.b, "op" : "$inputRoot.op" }, "output" : { "c" : $inputRoot.c } }
Choisissez Save (Enregistrer).
Pour tester le modèle de mappage
-
Choisissez l’onglet Test. Vous devrez peut-être choisir la flèche droite pour afficher l'onglet.
-
Pour Chemin, procédez comme suit :
Pour opérande 1, saisissez
1
.Pour opérande 2, saisissez
2
.Pour opérateur, saisissez
+
.
-
Sélectionnez Tester).
-
Le résultat ressemble à ce qui suit :
{ "input": { "a": 1, "b": 2, "op": "+" }, "output": { "c": 3 } }
À ce stade, vous pouvez uniquement appeler la API fonction Test de la console API Gateway. Pour le mettre à la disposition des clients, vous devez déployer votreAPI. Assurez-vous de toujours redéployer le vôtre API chaque fois que vous ajoutez, modifiez ou supprimez une ressource ou une méthode, que vous mettez à jour un mappage de données ou que vous mettez à jour les paramètres de stage. Dans le cas contraire, les nouvelles fonctionnalités ou mises à jour ne seront pas disponibles pour vos API clients, comme suit :
Pour déployer l'API
Choisissez DeployAPI (Déployer).
Pour Étape, sélectionnez Nouvelle étape.
Sous Stage name (Nom de l'étape), entrez
Prod
.(Facultatif) Sous Description, entrez une description.
Choisissez Deploy (Déployer).
-
(Facultatif) Sous Détails de l'étapeURL, pour Invoke, vous pouvez choisir l'icône de copie pour copier votre API appelURL. Vous pouvez l'utiliser avec des outils tels que Postman
et c URL pour tester votreAPI.
Note
Redéployez toujours le vôtre API chaque fois que vous ajoutez, modifiez ou supprimez une ressource ou une méthode, que vous mettez à jour un mappage de données ou que vous mettez à jour les paramètres de stage. Dans le cas contraire, les nouvelles fonctionnalités ou mises à jour ne seront pas disponibles pour vos clientsAPI.