Serveurs principaux dans Gestion des API

  • Article
  • 2 minutes de lecture

Un service principal (ou API back-end) dans Gestion des API est un service HTTP qui implémente votre API frontale et ses opérations.

Lors de l’importation de certaines API, Gestion des API configure automatiquement l’API back-end. Par exemple, le service Gestion des API configure le back-end lors de l’importation :

La Gestion des API prend également en charge l’utilisation d’autres ressources Azure, comme un back-end d’API, par exemple :

Les back-ends personnalisés nécessitent une configuration supplémentaire pour autoriser les informations d’identification des requêtes adressées au service back-end et définir des opérations d’API. Configurez et gérez les back-ends personnalisés dans le portail Azure, ou bien à l’aide d’API ou d’outils Azure.

Une fois le back-end créé, vous pouvez le référencer dans vos API. Utilisez la stratégie set-backend-service pour rediriger une requête API entrante vers le serveur principal personnalisé au lieu du serveur principal par défaut pour cette API.

Notes

Lorsque vous utilisez la stratégie set-backend-service pour rediriger les requêtes vers un back-end personnalisé, reportez-vous au back-end par son nom (backend-id) et non par son URL.

Avantages des serveurs principaux

Un serveur principal personnalisé présente plusieurs avantages, notamment :

  • Résumé des informations sur le service back-end, promotion de la réutilisabilité entre les API et amélioration de la gouvernance.
  • Facilité d’utilisation en configurant une stratégie de transformation sur une API existante.
  • Utilisation de la fonctionnalité de Gestion des API pour gérer les secrets dans Azure Key Vault si des valeurs nommées sont configurées pour l’authentification de paramètre de requête ou d’en-tête.

Limitation

Pour les niveaux Développeur et Premium, une instance Gestion des API déployée dans un réseau virtuel interne peut générer des erreurs HTTP 500 BackendConnectionFailure quand l’URL du point de terminaison de passerelle et l’URL du back-end sont identiques. Si vous rencontrez cette limitation, suivez les instructions fournies dans l’article Limitation des demandes de la Gestion des API autochaînées en mode réseau virtuel interne du blog de la communauté technique.

Étapes suivantes