API REST serverless utilisant Azure Functions
Azure Functions est un service de calcul essentiel que vous utilisez pour générer des API REST serverless. Les déclencheurs HTTP exposent des points de terminaison REST qui peuvent être appelés par vos clients, tels que les navigateurs, les applications mobiles et d’autres services principaux. Avec la prise en charge native des itinéraires, une seule fonction déclenchée par HTTP peut exposer une API REST hautement fonctionnelle. Functions fournit également son propre schéma d’autorisation basé sur des clés de base pour limiter l’accès aux clients spécifiques uniquement. Pour plus d’informations, consultez Déclencheur HTTP Azure Functions
Dans certains scénarios, vous pouvez avoir besoin de votre API pour prendre en charge un ensemble plus complexe de comportements REST. Par exemple, vous devrez peut-être combiner plusieurs points de terminaison de fonction HTTP en une seule API. Vous pouvez également transmettre des requêtes à un ou plusieurs services REST back-end. Enfin, vos API peuvent nécessiter un degré de sécurité plus élevé qui vous permet de monétiser son utilisation.
Aujourd’hui, l’approche recommandée pour créer des API plus complexes et robustes basées sur vos fonctions consiste à utiliser les services d’API complets fournis par Azure API Management. API Management utilise un modèle basé sur une stratégie pour vous permettre de contrôler l’intégration du routage, de la sécurité et d’OpenAPI. Il prend également en charge des stratégies avancées, telles que la monétisation de limitation du débit. Les versions précédentes du runtime Functions utilisaient la fonctionnalité héritée Proxys de fonctions.
Important
Les proxys Azure Functions sont une fonctionnalité héritée des versions 1.x à 3.x du runtime Azure Functions. La prise en charge des proxys peut être réactivée dans la version 4.x pour que vous puissiez mettre à niveau vos applications Functions vers la dernière version du runtime. Dès que possible, vous devez basculer vers l’intégration de vos applications de fonction avec Gestion des API Azure. Gestion des API vous permet de tirer parti d’un ensemble plus complet de fonctionnalités pour définir, sécuriser, gérer et monétiser vos API basées sur Functions. Pour plus d’informations, consultez Intégration de Gestion des API.
Pour savoir comment réactiver la prise en charge des proxys dans Functions version 4.x, consultez Réactiver les proxys dans Functions v4.x.
Passer des proxys de fonctions à API Management
Lorsque vous passez des proxys de fonctions à l’utilisation d’API Management, vous devez intégrer votre application de fonction à une instance d’API Management, puis configurer l’instance d’API Management pour qu’elle se comporte comme le proxy précédent. La section suivante fournit des liens vers les articles pertinents qui vous aident à utiliser API Management avec Azure Functions.
Si vous rencontrez des difficultés à passer des proxys ou si Azure Gestion des API ne répond pas à vos scénarios spécifiques, publiez une demande dans le forum de commentaires Gestion des API.
Intégration du service Gestion des API
API Management vous permet d’importer une application de fonction existante. Après l’importation, chaque point de terminaison de fonction déclenché par HTTP devient une API que vous pouvez modifier et gérer. Après l’importation, vous pouvez également utiliser API Management pour générer un fichier de définition OpenAPI pour vos API. Lors de l’importation, tous les points de terminaison avec un admin niveau d’autorisation sont ignorés. Pour plus d’informations sur l’utilisation d’API Management avec Functions, consultez les articles suivants :
| Article | Description |
|---|---|
| Exposer des API serverless à partir de points de terminaison HTTP à l’aide du service Gestion des API Azure | Montre comment créer une instance d’API Management à partir d’une application de fonction existante dans le Portail Azure. Prend en charge tous les langages. |
| Créer des API serverless dans Visual Studio à l’aide d’Azure Functions et de l’intégration d’API Management | Montre comment utiliser Visual Studio pour créer un projet C# qui utilise l’extension OpenAPI. L’extension OpenAPI vous permet de définir vos API .NET en appliquant des attributs directement à votre code C#. |
| Démarrage rapide : Créer une instance du service Gestion des API Azure avec le portail Azure | Créez une nouvelle instance d’API Management dans le portail. Après avoir créé une instance d’API Management, vous pouvez la connecter à votre application de fonction. D’autres méthodes de création hors portail sont prises en charge. |
| Importer une application de fonction Azure en tant qu’API dans API Management | Montre comment importer une application de fonction existante pour exposer des points de terminaison de déclencheur HTTP existants en tant qu’API managée. Cet article prend en charge la création d’une API et l’ajout des points de terminaison à une API managée existante. |
Une fois que les points de terminaison de votre application de fonction sont exposés à l’aide d’API Management, les articles suivants fournissent des informations générales sur la procédure de gestion de vos API basées sur Functions dans l’instance d’API Management.
| Article | Description |
|---|---|
| Modifier une API | Montre comment utiliser une API existante hébergée dans API Management. |
| Stratégies dans Gestion des API Azure | Dans Gestion des API Azure, les éditeurs d’API peuvent modifier le comportement des API par le biais d’une configuration à l’aide de stratégies. Les stratégies sont un ensemble d'instructions qui sont exécutées de manière séquentielle sur demande ou sur réponse d'une API. |
| Référence des stratégies de gestion des API | Référence qui détaille toutes les stratégies d’API Management prises en charge. |
| Exemples de stratégie dans la Gestion des API | Collection utile d’exemples utilisant des stratégies d’API Management dans des scénarios clés. |
Proxys de fonctions hérités
La fonctionnalité Azure Functions Proxies héritée fournit également un ensemble de fonctionnalités d’API de base pour la version 3.x et l’ancienne version du runtime Functions.
Important
Les proxys Azure Functions sont une fonctionnalité héritée des versions 1.x à 3.x du runtime Azure Functions. La prise en charge des proxys peut être réactivée dans la version 4.x pour que vous puissiez mettre à niveau vos applications Functions vers la dernière version du runtime. Dès que possible, vous devez basculer vers l’intégration de vos applications de fonction avec Gestion des API Azure. Gestion des API vous permet de tirer parti d’un ensemble plus complet de fonctionnalités pour définir, sécuriser, gérer et monétiser vos API basées sur Functions. Pour plus d’informations, consultez Intégration de Gestion des API.
Pour savoir comment réactiver la prise en charge des proxys dans Functions version 4.x, consultez Réactiver les proxys dans Functions v4.x.
Quelques conseils de base pour effectuer des tâches équivalentes à l’aide d’API Management ont été ajoutés à l’article Proxys de fonctions. Actuellement, nous n’avons pas de documentation ni d’outils pour vous aider à migrer une implémentation de proxys de fonctions existants vers API Management.