Exposer des API serverless à partir de points de terminaison HTTP à l’aide du service Gestion des API Azure
Azure Functions s’intègre au service Gestion des API Azure dans le portail pour vous permettre d’exposer vos points de terminaison de fonction de déclencheur HTTP en tant qu’API REST. Les API REST sont souvent décrites à l’aide d’une définition OpenAPI. Ce fichier JSON (ou YAML) contient des informations sur les opérations disponibles dans une API. Il inclut des informations sur la façon de structurer les données de requête et de réponse pour l’API. En intégrant votre application de fonction, vous pouvez faire en sorte que le service Gestion des API génère ces définitions OpenAPI.
Cet article explique comment intégrer votre application de fonction au service Gestion des API. Cette intégration fonctionne pour les applications de fonction développées dans n’importe quel langage pris en charge. Vous pouvez également importer votre application de fonction à partir du service Gestion des API Azure.
Pour les fonctions de bibliothèque de classes C#, vous pouvez également utiliser Visual Studio pour créer et publier des API serverless qui s’intègrent au service Gestion des API.
Créer une instance du service Gestion des API
Pour créer une instance du service Gestion des API liée à votre application de fonction :
Sélectionnez l’application de fonction, choisissez Gestion des API dans le menu de gauche, puis sélectionnez Créer nouveau sous Gestion des API.
Utilisez les paramètres de Gestion des API de la manière spécifiée dans le tableau suivant :
Paramètre Valeur suggérée Description Nom Nom globalement unique Un nom est généré sur la base du nom de votre application de fonction. Abonnement Votre abonnement Abonnement sous lequel cette nouvelle ressource est créée. Groupe de ressources myResourceGroup Même ressource que votre application de fonction, qui doit être définie pour vous. Lieu Emplacement du service Nous vous conseillons de choisir le même emplacement que votre application de fonction. Nom de l’organisation Contoso Nom de l’organisation utilisé dans le portail des développeurs et pour les notifications par e-mail. E-mail de l’administrateur votre e-mail E-mail ayant reçu les notifications système de la Gestion des API. Niveau tarifaire Consommation Le niveau Consommation n’est pas disponible dans toutes les régions. Pour des informations tarifaires complètes, voir la page de tarification de la Gestion des API. Choisissez Exporter pour créer l’instance Gestion des API, ce qui peut prendre plusieurs minutes.
Une fois qu’Azure a créé l’instance, l’option Activer Application Insights est disponible sur la page. Sélectionnez-la pour envoyer les journaux au même emplacement que l’application de fonction.
Importer des fonctions
Une fois l’instance du service Gestion des API créée, vous pouvez importer les points de terminaison de vos fonctions déclenchées par HTTP. Cet exemple importe un point de terminaison nommé TurbineRepair.
Dans la page Gestion des API, sélectionnez Lier l’API.
La fenêtre Importer Azure Functions s’ouvre avec la fonction TurbineRepair en surbrillance. Cliquez sur Sélectionner pour continuer.
Dans la page Créer à partir de Function App, acceptez les valeurs par défaut, puis sélectionnez Créer.
Azure crée l’API pour la fonction.
Télécharger la définition OpenAPI
Une fois vos fonctions importées, vous pouvez télécharger la définition OpenAPI à partir de l’instance du service Gestion des API.
Sélectionnez Télécharger la définition OpenAPI en haut de la page.
Enregistrez le fichier JSON téléchargé, puis ouvrez-le. Vérifiez la définition.
Étapes suivantes
Vous pouvez maintenant affiner la définition dans la page Gestion des API du portail. Vous pouvez aussi en savoir plus sur la Gestion des API.