Niveaux v2 du service Gestion des API Azure
S’applique à : Essentiel v2 | Standard v2 | Premium v2
Les niveaux (SKU) v2 de la Gestion des API reposent sur une nouvelle plate-forme plus fiable et évolutive et sont conçus pour rendre la Gestion des API accessible à un ensemble plus large de clients et offrir des options flexibles pour une plus grande variété de scénarios. Les niveaux v2 complètent les niveaux classiques existants (Développeur, Essentiel, Standard et Premium) et le niveau Consommation. Voir une comparaison détaillée des niveaux de la Gestion des API.
Les niveaux v2 suivants sont désormais en disponibilité générale :
De base v2 – le niveau Basic v2 est conçu pour les scénarios de développement et de test et est pris en charge avec un SLA.
Standard v2 – Standard v2 est un niveau prêt pour la production avec prise en charge des back-ends isolés du réseau.
Le niveau v2 suivant est en préversion :
Premium v2 : ce niveau offre des fonctionnalités d’entreprise, notamment l’isolement complet du réseau virtuel et la mise à l’échelle pour les charges de travail à volume élevé.
Remarque
Le niveau Premium v2 est actuellement en préversion limitée. Pour vous inscrire, remplissez ce formulaire.
Fonctionnalités clés
Déploiement, configuration et mise à l'échelle plus rapides – déployez une instance de Gestion des API prête pour la production en quelques minutes. Appliquez rapidement des configurations telles que les mises à jour de certificats et de noms d'hôte. Faites évoluer rapidement une instance De base v2 ou Standard v2 jusqu'à 10 unités pour répondre aux besoins de vos charges de travail de gestion d'API. Mettez à l’échelle une instance Premium v2 jusqu’à 30 unités.
Mise en réseau simplifiée : les niveaux Standard v2 et Premium v2 fournissent des options de mise en réseau pour isoler le trafic entrant et sortant de la Gestion des API.
Plus d'options pour les charges de travail de production – les niveaux v2 sont tous pris en charge avec un SLA.
Options du portail des développeurs – activez le portail des développeurs lorsque vous êtes prêt à permettre aux consommateurs d'API de découvrir vos API.
Fonctionnalités
Version de l'API
Les fonctionnalités les plus récentes des niveaux v2 sont prises en charge dans l’API Gestion des API version 2024-05-01 ou ultérieure.
Options réseau
Les niveaux Standard v2 et Premium v2 prennent en charge l’intégration de réseau virtuel pour permettre à votre instance de la Gestion des API d’atteindre les back-ends d’API qui sont isolés dans un seul réseau virtuel connecté. La passerelle de Gestion des API, le plan de gestion et le portail des développeurs restent accessibles au public depuis Internet. Le réseau virtuel doit être dans la même région et le même abonnement Azure que l’instance de la Gestion des API. Plus d’informations
Le niveau Premium v2 prend également en charge l’injection de réseau virtuel simplifiée pour isoler complètement le trafic de passerelle entrant et sortant sans nécessiter de règles de groupe de sécurité réseau, de tables de routage ou de points de terminaison de service. Le réseau virtuel doit être dans la même région et le même abonnement Azure que l’instance de la Gestion des API. Plus d’informations
Régions prises en charge
Pour obtenir la liste actuelle des régions où les niveaux v2 sont disponibles, consultez Disponibilité des niveaux v2 et des passerelles d’espace de travail.
Disponibilité des fonctionnalités classiques
La plupart des fonctionnalités des niveaux classiques de Gestion des API sont prises en charge dans les niveaux v2. Toutefois, les fonctionnalités suivantes ne sont pas prises en charge dans les niveaux v2 :
- Configuration du service API Management à l’aide de Git
- Sauvegarde et restauration de l’instance API Management
- Activation d’Azure DDoS Protection
- Accès direct à l’API Gestion
Limites
Les fonctionnalités Gestion des API suivantes sont actuellement indisponibles dans les niveaux v2.
Infrastructures et réseaux
- Déploiement multi-régions
- Prise en charge des zones de disponibilité
- Noms de domaine personnalisés multiples
- Métrique de capacité : remplacée par les métriques Pourcentage d’UC de la passerelle et Pourcentage de mémoire de la passerelle
- Analytique intégrée : remplacée par le tableau de bord basé sur Azure Monitor
- Mise à l’échelle automatique
- Connexion entrante utilisant un point de terminaison privé
- Mettre à niveau vers les niveaux v2 à partir de niveaux classiques
- Certificats de l’autorité de certification
Portail des développeurs
- Rapports
- Widget de code HTML personnalisé et widget personnalisé
- Portail des développeurs auto-hébergé
Passerelle
- Passerelle auto-hébergée
- Stratégie de quota par clé
- Configuration du chiffrement
- Renégociation du certificat client
- Certificat TLS managé gratuit
- Requêtes à la passerelle via localhost
Limites des ressources
Les limites de ressources suivantes s’appliquent aux niveaux v2.
Pour réclamer un relèvement de la limite, créez une demande de support dans le Portail Azure. Pour plus d’informations, consultez les Plans de support Azure.
| Ressource | De base v2 | Standard v2 | Premium v2 |
|---|---|---|---|
| Nombre maximal d’unités d’échelle | 10 | 10 | 30 |
| Taille maximale du cache par instance de service | 250 Mo | 1 Go | 5 Go |
| Nombre maximal d’API par instance de service | 150 | 500 | 2 500 |
| Nombre maximal d’opérations d’API par instance de service | 3 000 | 10 000 | 20 000 |
| Nombre maximal d’abonnements par instance de service | 500 | 2 000 | 4 000 |
| Nombre maximal de produits par instance de service | 50 | 200 | 400 |
| Nombre maximal d’utilisateurs par instance de service | 300 | 2 000 | 4 000 |
| Nombre maximal de groupes par instance de service | 20 | 100 | 200 |
| Nombre maximal de serveurs d’autorisation par instance de service | 10 | 500 | 500 |
| Nombre maximal de fragments de stratégie par instance de service | 50 | 50 | 100 |
| Nombre maximal de fournisseurs OpenID Connect par instance de service | 10 | 10 | 20 |
| Nombre maximal de certificats par instance de service | 100 | 100 | 100 |
| Nombre maximal de back-ends par instance de service | 100 | 100 | 100 |
| Nombre maximal de caches par instance de service | 100 | 100 | 100 |
| Nombre maximal de valeurs nommées par instance de service | 100 | 100 | 100 |
| Nombre maximal d’enregistreurs d’événements par instance de service | 100 | 100 | 100 |
| Nombre maximal de schémas par instance de service | 100 | 100 | 100 |
| Nombre maximal de schémas par API | 100 | 100 | 100 |
| Nombre maximal d’étiquettes par instance de service | 100 | 100 | 100 |
| Nombre maximal d’étiquettes par API | 100 | 100 | 100 |
| Nombre maximal d’ensembles de versions par instance de service | 100 | 100 | 100 |
| Nombre maximal de versions par API | 100 | 100 | 100 |
| Nombre maximal d’opérations par API | 100 | 100 | 100 |
| Nombre maximal de résolveurs GraphQL par instance de service | 100 | 100 | 100 |
| Nombre maximal de résolveurs GraphQL par API | 100 | 100 | 100 |
| Nombre maximal d’API par produit | 100 | 100 | 100 |
| Nombre maximal d’API par abonnement | 100 | 100 | 100 |
| Nombre maximal de produits par abonnement | 100 | 100 | 100 |
| Nombre maximal de groupes par produit | 100 | 100 | 100 |
| Nombre maximal d’étiquettes par produit | 100 | 100 | 100 |
| Connexions back-ends simultanées1 par autorité HTTP | 2 048 | 2 048 | 2 048 |
| Taille maximale de la réponse mise en cache | 2 Mio | 2 Mio | 2 Mio |
| Taille maximale du document de stratégie | 256 Kio | 256 Kio | 256 Kio |
| Taille maximale de la charge utile de requête | 1 Gio | 1 Gio | 1 Gio |
| Taille maximale de la charge utile mise en mémoire tampon | 2 Mio | 2 Mio | 2 Mio |
| Taille maximale de la charge utile de requête/réponse dans les journaux de diagnostic | 8,192 octets | 8,192 octets | 8,192 octets |
| Taille maximale de l’URL de requête2 | 16 384 octets | 16 384 octets | 16 384 octets |
| Longueur maximale du segment de chemin d’accès de l’URL | 1 024 caractères | 1 024 caractères | 1 024 caractères |
| Longueur maximale du caractère de la valeur nommée | 4 096 caractères | 4 096 caractères | 4 096 caractères |
| Taille maximale du corps de la requête ou de la réponse dans la stratégie de validation du contenu | 100 Kio | 100 Kio | 100 Kio |
| Taille maximale du schéma d’API utilisé par la stratégie de validation | 4 Mo | 4 Mo | 4 Mo |
| Nombre maximal de connexions WebSocket actives par unité : 3 | 5 000 | 5 000 | 5 000 |
1 Les connexions sont groupées et réutilisées, sauf si elles sont explicitement fermées par le back-end.
2 Inclut une chaîne de requête pouvant comprendre jusqu’à 2 048 octets.
3, jusqu’à un maximum de 60 000 connexions par instance de service.
Limites applicables au portail des développeurs
Les limites suivantes s’appliquent au portail des développeurs pour les niveaux v2.
| Article | De base v2 | Standard v2 | Premium v2 |
|---|---|---|---|
| Nombre maximal de fichiers multimédias à charger | 15 | 15 | 15 |
| Taille maximale d’un fichier multimédia | 500 Ko | 500 Ko | 500 Ko |
| Nombre maximal de pages | 30 | 50 | 50 |
| Nombre maximal de widgets1 | 30 | 50 | 50 |
| Taille maximale des métadonnées par page | 350 KB | 350 KB | 350 KB |
| Taille maximale des métadonnées par widget1 | 350 KB | 350 KB | 350 KB |
| Nombre maximal de requêtes client par minute | 200 | 200 | 200 |
1 Limite applicable aux widgets intégrés (texte, images, liste d’API, etc.). Actuellement, les widgets personnalisés et les widgets de code HTML personnalisés ne sont pas pris en charge dans les niveaux v2.
Déploiement
Déployez une instance de niveau v2 à l’aide du Portail Azure ou à l’aide d’outils tels que l’API REST Azure, Azure Resource Manager, un modèle Bicep ou Terraform.
Forum aux questions
Q : Puis-je migrer de mon instance de Gestion des API existante vers une nouvelle instance de niveau v2 ?
R : Non. Actuellement, vous ne pouvez pas migrer une instance de Gestion des API existante (au niveau Consommation, Développeur, De base, Standard ou Premium) vers une nouvelle instance de niveau v2. Actuellement, les niveaux v2 sont disponibles uniquement pour les instances de service nouvellement créées.
Q : Quelle est la relation entre la plate-forme de calcul stv2 et les niveaux v2 ?
R : Ils ne sont pas liés. stv2 est une version de plate-forme de calcul des instances de service de niveau Développeur, De base, Standard et Premium. stv2 est un successeur de la plateforme de calcul stv1 qui a été mise hors service en 2024.
Q : Puis-je toujours approvisionner des services de niveau Développeur, Essentiel, Standard ou Premium ?
R : Oui, il n’existe aucune modification des niveaux Développeur, Essentiel, Standard ou Premium classiques.
Q : Quelle est la différence entre l’intégration de réseau virtuel dans le niveau Standard v2 et l’injection de réseau virtuel dans les niveaux Premium et Premium v2 ?
R : Une instance de service Standard v2 peut être intégrée à un réseau virtuel pour fournir un accès sécurisé aux back-ends qui y résident. Une instance de service Standard v2 intégrée à un réseau virtuel a une adresse IP publique pour l’accès entrant.
Les niveaux Premium et Premium v2 prennent en charge l’isolement réseau complet par déploiement (injection) dans un réseau virtuel sans exposer d’adresse IP publique. En savoir plus sur les options de mise en réseau dans la Gestion des API.
Q : Puis-je déployer une instance du niveau Essentiel v2 ou Standard v2 entièrement dans mon réseau virtuel ?
R : Non, un tel déploiement n’est pris en charge que dans les niveaux Premium et Premium v2.
Contenu connexe
- Comparez les différents niveaux du service Gestion des API.
- En savoir plus sur les passerelles réseau du service Gestion des API
- Consultez les tarifs du service Gestion des API.