Changements cassants des espaces de travail, partie 2 (mars 2025)
S’APPLIQUE À : premium
Important
Ces modifications cassants s’appliquent uniquement aux espaces de travail en préversion dans Gestion des API Azure. Si vous avez créé des espaces de travail après la version en disponibilité générale en août 2024 et que vous utilisez des espaces de travail avec des passerelles d’espace de travail, vos espaces de travail ne devraient pas être affectés par ces changements.
Les espaces de travail Gestion des API Azure sont désormais en disponibilité générale et nous avons introduit plusieurs mises à jour de fonctionnalités avec cette version. Dans le cadre de notre développement continu d’espaces de travail, nous supprimons la prise en charge des espaces de travail en préversion (créés avant août 2024). Si vous avez créé des espaces de travail en préversion dans Gestion des API Azure et que vous souhaitez continuer à les utiliser, vous devez migrer vos espaces de travail vers la version généralement disponible.
Après le 31 mars 2025, vos espaces de travail et API en préversion gérés peuvent cesser de fonctionner si vous n’avez pas migré vers les fonctionnalités les plus récentes de l’espace de travail. Les API et ressources gérées en dehors des espaces de travail ne sont pas affectées par cette modification.
Mon service est-il concerné par ces changements ?
Votre service peut être affecté par ces changements si vous avez créé des espaces de travail en préversion dans votre instance Gestion des API, avant la version en disponibilité générale des espaces de travail en août 2024. Les espaces de travail créés après la date de publication généralement disponible qui utilisent des passerelles d’espace de travail pour le runtime d’API ne sont pas affectés par les modifications cassantes.
Dernières modifications
Voici les modifications cassantes qui vous obligent à prendre des mesures pour migrer vos espaces de travail en préversion vers la version en disponibilité générale :
- La passerelle d’API d’espace de travail est requise : chaque espace de travail doit être associé à une passerelle d’API d’espace de travail qui isole le trafic d’exécution de l’espace de travail. En préversion, les espaces de travail ont partagé une passerelle avec le service.
- Les identités managées au niveau du service ne sont pas prises en charge : pour améliorer la sécurité des espaces de travail, les identités managées affectées par le système et affectées par l’utilisateur activées au niveau du service ne peuvent pas être utilisées dans les espaces de travail. Actuellement, les fonctionnalités de gestion des API associées qui dépendent d’identités managées, telles que le stockage de valeurs nommées et de certificats dans Azure Key Vault et l’utilisation de la stratégie
authentication-managed-identity, ne sont pas prises en charge dans les espaces de travail.
Remarque
Ces changements cassants sont ajoutés aux changements cassants de juin 2024 pour les espaces de travail en préversion qui ont été annoncés précédemment.
Quelle est la date limite pour effectuer ce changement ?
Les modifications cassants seront appliquées dans les espaces de travail en préversion après le 31 mars 2025. Nous vous recommandons vivement d’apporter toutes les modifications requises à la configuration de vos espaces de travail en préversion avant cette date.
Que dois-je faire ?
Si vos espaces de travail sont affectés par ces modifications, vous devez migrer vos espaces de travail pour s’aligner sur les fonctionnalités en disponibilité générale. Les sections suivantes fournissent des conseils sur la migration de vos espaces de travail.
Utiliser le niveau Premium pour votre instance Gestion des API
Vérifiez que votre instance Gestion des API s’exécute dans le niveau Premium pour continuer à utiliser des espaces de travail. Comme annoncé précédemment, si votre instance se trouve dans le niveau Standard ou Développeur, vous devez effectuer une mise à niveau vers le niveau Premium.
Confirmer la région de votre instance
L’ajout d’une passerelle d’espace de travail à un espace de travail nécessite que la passerelle se trouve dans la même région que votre instance. Actuellement, les passerelles d’espace de travail sont prises en charge dans un sous-ensemble de régions dans lesquelles gestion des API est disponible. Les régions prenant en charge les passerelles d’espace de travail seront mises à jour au fil du temps.
Pour déterminer si un espace de travail en préversion se trouve dans une région prise en charge :
- Dans le portail Azure, accédez à votre instance APIM.
- Dans le menu de gauche, sous API, sélectionnez Espaces de travail, puis sélectionnez un espace de travail.
- Si votre espace de travail se trouve dans une région qui ne prend pas en charge les passerelles d’espace de travail, vous verrez un message dans le portail similaire à « Les espaces de travail sont actuellement indisponibles dans la région de votre service Gestion des API ».
- Si vous voyez ce message, vous pouvez déplacer votre instance Gestion des API vers une région prise en charge.
- Si vous ne voyez pas ce message, votre espace de travail se trouve dans une région prise en charge et vous pouvez continuer à ajouter une passerelle d’espace de travail.
Ajouter une passerelle d’espace de travail à votre espace de travail
Les étapes suivantes sont abrégées pour ajouter une passerelle d’espace de travail à un espace de travail. Pour obtenir des options de mise en réseau de passerelle, des prérequis et des instructions détaillées, consultez Créer et gérer un espace de travail.
Remarque
- La passerelle d’espace de travail entraîne des frais supplémentaires. Pour plus d’informations, consultez la section Tarification de Gestion des API Azure.
- Nous introduisons la possibilité d’associer plusieurs espaces de travail à une passerelle d’espace de travail, ce qui aide les organisations à gérer les API avec des espaces de travail à moindre coût. Cette fonctionnalité est déployée à compter de décembre 2024. Il est possible qu’elle ne soit pas disponible pour tous les services éligibles avant janvier. En savoir plus
- Dans le portail Azure, accédez à votre instance APIM.
- Dans le menu de gauche, sous API, sélectionnez Espaces de travail.
- Sélectionnez un espace de travail.
- Dans le menu de gauche, sous Déploiement + infrastructure, sélectionnez Passerelles>+ Ajouter.
- Terminez l’Assistant pour créer une passerelle. Actuellement, l’approvisionnement de la passerelle peut prendre de plusieurs minutes à 3 heures ou plus.
- Une fois votre passerelle configurée, accédez à la page Vue d’ensemble de la passerelle. Notez la valeur du nom d’hôte Runtime. Utilisez cette valeur pour mettre à jour vos applications clientes qui appellent les API de votre espace de travail.
- Répétez les étapes précédentes pour vos espaces de travail restants.
Mettre à jour les applications clientes pour utiliser le nouveau nom d’hôte de passerelle
Après avoir ajouté une passerelle à votre espace de travail, vous devez mettre à jour vos applications clientes qui appellent les API de l’espace de travail pour utiliser le nouveau nom d’hôte de passerelle au lieu du nom d’hôte de passerelle de votre instance Gestion des API.
Remarque
Pour vous aider à migrer vos espaces de travail, les API des espaces de travail sont toujours accessibles au moment de l’exécution jusqu’en octobre 2024 à l’aide du nom d’hôte de passerelle de votre instance Gestion des API, même si une passerelle d’espace de travail est associée à un espace de travail. Nous vous recommandons vivement de terminer la migration avant cette date. Si vos passerelles d’espace de travail sont configurées avec un accès entrant privé et un accès sortant privé, assurez-vous que la connectivité à la passerelle intégrée de votre instance Gestion des API est également sécurisée.
Mettre à jour les dépendances sur les identités managées au niveau du service
Si vous utilisez des identités managées au niveau du service dans la configuration des entités d’espace de travail (par exemple, des valeurs nommées ou des certificats), vous devez mettre à jour les configurations. Les étapes recommandées varient en fonction de l’entité. Exemple : mettez à jour les valeurs nommées pour utiliser des valeurs secrètes au lieu des secrets stockés dans Azure Key Vault.
Aide et support
Si vous avez des questions, posez-les aux experts de la communauté dans Microsoft Q&A. Si vous disposez d’un plan de support et que vous avez besoin d’une aide technique, créez une demande de support.
Plus d’informations
Contenu connexe
Consultez l’ensemble des changements et mises hors service nets des fonctionnalités.