Partager via

FAQ sur la gestion des API Azure

Obtenez des réponses aux questions courantes sur gestion des API 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é d'une version d'évaluation est fonctionnellement complète, mais des modifications cassantes peuvent être apportées en réponse aux commentaires des clients. Nous vous déconseillons de dépendre d’une fonctionnalité en préversion dans votre environnement de production.

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

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

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

Vous avez plusieurs options pour sécuriser la connexion entre la passerelle Gestion des API et vos services principaux, notamment :

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.

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 ou estompée dans l’éditeur de stratégie, assurez-vous que vous êtes dans le champ d'application correct de la 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.

Gestion des API s’intègre également aux services de calcul Azure couramment utilisés pour créer et héberger des API sur Azure, notamment Azure Functions, Azure Logic Apps, Azure Container Apps et Azure 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 du sous-réseau nécessaire lors du déploiement de 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 Gestion des API dans les réseaux virtuels.

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

Bien que gestion des API n’inclut pas de composant WAF, le déploiement d’un WAF en amont (en amont) de l’instance Gestion des API est 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, par exemple https://contoso.com/sample/, est traitée comme un répertoire, tandis que la même URL sans barre oblique de fin (https://contoso.com/sample) indique un fichier. Cette convention n’est pas obligatoire. Certains systèmes considèrent ces deux URL uniques, mais d’autres les considèrent comme les mêmes. La gestion des API ne fait pas de distinction, si bien qu'une seule opération resource acceptera soit resource soit resource/. Toutefois, la distinction peut être importante pour l’hôte back-end. Certains serveurs web redirigent automatiquement une URL ne se terminant pas par une barre oblique vers la même URL avec une barre oblique de fin. Étant donné que gestion des API est le client vers le serveur principal (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 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.

Puis-je intégrer gestion des API directement à des solutions de base de données Azure ?

Oui, vous pouvez intégrer gestion des API directement avec d’autres services Azure sans intermédiaire. Par exemple, gestion des API peut s’intégrer directement aux API REST Azure Cosmos DB pour les opérations CRUD, ce qui élimine le besoin de services intermédiaires comme Azure Functions.