FAQ sur la gestion des API Azure

  • Forum aux questions

Obtenez des réponses aux questions fréquentes sur API Management Azure.

Qu’est-ce que cela signifie lorsqu’une fonctionnalité est disponible en version préliminaire ?

Lorsqu’une fonctionnalité est disponible en version préliminaire, cela signifie que nous souhaitons avoir votre avis sur le fonctionnement de la fonctionnalité. Une fonctionnalité en version préliminaire est complète et opérationnelle, mais peut être modifiée par nos soins en réponse aux commentaires client. Nous vous recommandons de ne pas intégrer de manière définitive une fonctionnalité en version préliminaire à votre environnement de production.

Comment connaître les mises à jour et les modifications apportées à API Management ?

Abonnez-vous aux annonces de mises à jour publiées à ces emplacements :

Comment sécuriser la connexion entre la passerelle API Management et mes services principaux ?

Il existe plusieurs manières de sécuriser la connexion entre la passerelle de Gestion des API et vos services principaux :

Comment copier une instance de service Gestion des API vers une nouvelle instance ?

Vous disposez de plusieurs options :

  • Utiliser la fonctionnalité sauvegarde et restauration dans API Management.
  • Créez votre propre fonctionnalité de sauvegarde et restauration à l’aide de l’API REST API Management pour enregistrer et restaurer les entités requises à partir de votre instance de service souhaitée.
  • Télécharger la configuration du service à l’aide de Git et chargez-la vers une nouvelle instance.

Puis-je déplacer l’instance API Management d’un abonnement à un autre ?

Oui. Pour savoir comment procéder, consultez Déplacer des ressources vers un nouveau groupe de ressources ou un nouvel abonnement.

Puis-je gérer mon instance de gestion des API par programme ?

Oui, vous pouvez gérer API Management par programme à l’aide de divers outils, notamment :

Comment ajouter un utilisateur au groupe d’administrateurs ?

Le groupe Administrateurs est un groupe système immuable qui inclut les administrateurs d’abonnements Azure. Vous ne pouvez pas ajouter d’utilisateur à ce groupe. Pour plus d’informations, consultez la page Création et utilisation de groupes pour gérer les comptes de développeurs dans Gestion des API Azure.

Pourquoi la stratégie que je souhaite ajouter n’est-elle pas disponible dans l’éditeur de stratégie ?

Si la stratégie que vous souhaitez ajouter apparaît grisée dans l’éditeur de stratégie, vérifiez que vous êtes dans l’étendue correcte pour cette stratégie. Chaque instruction de stratégie est conçue pour être utilisée dans certaines étendues et sections de stratégie. Pour consulter les sections et les étendues d’une stratégie, consultez la section Utilisation de stratégie dans la Référence de la stratégie.

Comment configurer plusieurs environnements dans une seule API ?

Il existe deux manières de configurer plusieurs environnements, par exemple un environnement de test et un environnement de production, dans une seule API. Vous pouvez :

  • Hébergez différentes API sur la même instance API Management.
  • Héberger les mêmes API sur plusieurs instances.

API Management prend-elle uniquement en charge les back-ends d’API REST ?

API Management prend en charge les API REST ainsi que le passage aux API SOAP, WebSocket et GraphQL. API Management prend également en charge les API GraphQL synthétiques.

API Management s’intègre également aux offres de calcul Azure couramment utilisées pour la génération et l’hébergement d’API sur Azure, notamment Functions, Logic Apps, Container Apps et Web Apps.

Existe-t-il des restrictions liées à l’importation de mon API ?

Consultez Restrictions d’importation d’API et problèmes connus pour les formats OpenAPI (Swagger), WSDL et WADL.

Puis-je utiliser CI/CD pour le développement d’API ?

Oui. Pour plus d’informations, consultez Utiliser DevOps et CI/CD pour publier des API.

Pour obtenir des conseils sur l’architecture, consultez Accélérateur de zone d’atterrissage API Management Azure.

Quelle méthode de routage la gestion des API utilise-t-elle lors de déploiements sur plusieurs emplacements géographiques ?

API Management utilise la méthode de routage du trafic basé sur le niveau de performance lors de déploiements sur plusieurs emplacements géographiques. Pour en savoir plus, consultez Déployer une instance API Management Azure dans plusieurs régions Azure.

Le service Gestion des API est-il compatible avec Azure ExpressRoute ?

Oui.

Quelle est la taille minimale de sous-réseau requise pour le déploiement de la Gestion des API dans un réseau virtuel ?

La taille minimale de sous-réseau requise pour le déploiement de API Management est /29. En savoir plus sur l’utilisation de la Gestion des API dans desréseaux virtuels.

API Management fournit-il un pare-feu d’applications web (WAF) ?

Bien qu’API Management n’ait pas de composant WAF intégré, le déploiement d’un WAF en amont (devant) de l’instance API Management est fortement recommandé. Par exemple, utilisez Azure Application Gateway ou Azure Front Door.

Quelles sont les différences entre la passerelle managée et la passerelle auto-hébergée ?

Pour plus d’informations, consultez Passerelle API dans API Management et Vue d’ensemble de la passerelle auto-hébergée.

Comment API Management gère-t-il les barres obliques de fin lors de l’appel de services back-end ?

Historiquement et par convention, une URL se terminant par une barre oblique de fin est traitée comme un répertoire, par exemplehttps://contoso.com/sample/ tandis que la même URL sans barre oblique de fin, https://contoso.com/sample indique un fichier. Ce n’est pas autorisé ; certains systèmes considèrent ces deux URL comme uniques, les autres les considèrent comme étant les mêmes. API Management ne fait pas de distinction. Par conséquent, une seule opération resource accepte resource ou resource/. Toutefois, la distinction peut concerner l’hôte de back-end. Certains serveurs web redirigent automatiquement une URL sans barre oblique de fin vers la même URL avec une barre oblique de fin. API Management étant le client du back-end (serveur), une redirection automatique n’est pas toujours souhaitable. Si nécessaire, créez une stratégie de réécriture d’URL pour faire en sorte qu’une barre oblique de fin soit toujours ajoutée à l’appel back-end sortant.

Le nom d’une API Gestion des API peut-il être modifié ?

Non, vous ne pouvez pas modifier le nom (ou l’ID) d’une API dans Gestion des API Azure après sa création. Toutefois, vous pouvez modifier le nom complet.

Lorsque vous clonez une API, la nouvelle instance est créée avec une valeur générée par le système pour le nom, que vous ne pouvez pas modifier. Pour spécifier un nom pour l’API, créez manuellement une NOUVELLE API et importez la définition de l’API. Pour plus d’informations, consultez Modifier une API.