Partager via

Exposer des API serverless à partir de points de terminaison HTTP à l’aide de Gestion des API Azure

Azure Functions s’intègre à la gestion des API Azure dans le portail pour exposer les points de terminaison des fonctions déclencheurs HTTP en tant qu’API REST. Ces API sont 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 détails sur la façon dont les données de requête et de réponse de l’API doivent être structurées. En intégrant votre application fonctionnelle, vous pouvez utiliser la gestion des API pour générer ces définitions OpenAPI.

Cet article vous montre comment intégrer votre application de fonction à 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 de Gestion des API Azure.

Pour les fonctions de bibliothèque de classes C#, vous pouvez également utiliser Visual Studio pour créer et publier une API serverless qui s’intègre à Gestion des API.

Créer l’instance Gestion des API

Pour créer une instance Gestion des API liée à votre application de fonction :

  1. Sélectionnez l’application de fonction, choisissez Gestion des API dans le menu de gauche, puis sélectionnez Créer sous Gestion des API.

  2. Utilisez les paramètres gestion des API comme spécifié dans le tableau suivant :

    Réglage Valeur suggérée Descriptif
    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.
    Région Emplacement du service Envisagez de choisir le même emplacement que votre application de fonction.
    Nom de la ressource Nom unique au monde Un nom est généré en fonction du nom de votre application de fonction.
    Nom de l’organisation Contoso Nom de l’organisation utilisée dans le portail des développeurs et pour les notifications par e-mail.
    E-mail de l’administrateur votre e-mail Email 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 plus d’informations sur la tarification, consultez la page de tarification Gestion des API

  3. Choisissez Vérifier + créer , puis Créer pour créer l’instance Gestion des API, ce qui peut prendre plusieurs minutes.

Importer des fonctions

Une fois l'instance de gestion des API créée, vous pouvez importer vos points de terminaison de fonction déclenchés par HTTP. Cet exemple importe un point de terminaison nommé TurbineRepair.

  1. Dans la page Gestion des API, sélectionnez API Lien.

  2. La fenêtre Importer Azure Functions s’ouvre avec la fonction TurbineRepair en surbrillance. Choisissez Sélectionner pour continuer.

  3. Dans la page Créer à partir de l’application de fonction , 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 Gestion des API.

  1. Sélectionnez Télécharger la définition OpenAPI en haut de la page.

    Télécharger la définition OpenAPI

  2. Enregistrez le fichier JSON téléchargé, puis ouvrez-le. Passez en revue 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.

Modifier la définition OpenAPI dans la Gestion des API