Partager via

Espaces de travail - changements cassants (juin 2024)

  • Article

S’APPLIQUE À : Développeur | Standard | Premium

Important

Si vous avez créé des espaces de travail après la mise en production générale des espaces de travail en juillet 2024, vos espaces de travail ne doivent pas être affectés par ces modifications.

Après le 14 juin 2024, dans le cadre de notre développement d’espaces de travail dans Azure Gestion des API, nous introduisons plusieurs changements cassants.

Après le 14 juin 2024, vos espaces de travail et API gérés peuvent cesser de fonctionner s’ils s’appuient toujours sur les fonctionnalités définies pour changer. 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 modifications si vous avez configuré des espaces de travail (préversion) dans votre instance de Gestion des API. Cette fonctionnalité a été introduite dans les niveaux Premium, Standard et Développeur .

Dernières modifications

Passez en revue les modifications cassants suivantes pour déterminer si vous devez prendre des mesures :

Passer aux niveaux de service pris en charge

Les niveaux de service suivants ne prennent plus en charge les espaces de travail : Standard et Développeur. Les espaces de travail seront disponibles dans le niveau Premium .

Pour connaître la disponibilité dans les niveaux v2, consultez Azure Gestion des API niveaux v2.

Modifications apportées à la prise en charge de l’attribution d’entités au niveau du service dans les espaces de travail

Les affectations suivantes d’entités d’espace de travail aux entités de niveau de service ne seront plus prises en charge :

  • Affecter des API d’espace de travail à des produits de niveau de service

  • Affecter des API d’espace de travail à des balises de niveau de service

  • Affecter des produits d’espace de travail à des balises de niveau de service

  • Affecter des groupes de niveau de service aux produits d’espace de travail pour les contrôles de visibilité

    Remarque

    Les groupes invités et développeurs intégrés continueront d’être disponibles dans les espaces de travail.

Modifications apportées aux objets de contexte pris en charge

Les objets suivants context ne seront plus pris en charge dans les stratégies d’espace de travail ou dans la stratégie toutes les API au niveau du service :

  • context.Api.Workspace
  • context.Product.Workspace

L’objet peut être utilisé à la context.Workspace place.

Remarque

Vous pouvez continuer à référencer des utilisateurs du niveau de service dans l’objet dans les stratégies au niveau de l’espace context de travail.

Quelle est la date limite pour effectuer ce changement ?

Les changements cassants seront introduits après le 14 juin 2024. Nous vous recommandons vivement d’apporter toutes les modifications requises à la configuration des espaces de travail avant cette date.

Que dois-je faire ?

Si vos espaces de travail sont affectés par ces modifications, vous devez mettre à jour vos configurations d’espace de travail pour s’aligner sur les nouvelles fonctionnalités.

Clients de niveau Standard

Si vous utilisez des espaces de travail au niveau Standard , effectuez une mise à niveau vers le niveau Premium pour continuer à utiliser des espaces de travail.

Clients de niveau développeur

Le niveau Développeur a été conçu pour les cas d’usage mono-utilisateur ou d’équipe unique. Il n’est pas en mesure de faciliter la collaboration multi-équipe avec les espaces de travail en raison des ressources informatiques limitées, du manque de contrat SLA et de la redondance de l’infrastructure. Si vous utilisez l’aperçu des espaces de travail dans le niveau Développeur , vous pouvez choisir l’une des options suivantes :

  • Agréger dans une instance de niveau Premium

    Lors de la mise à niveau de chaque instance de niveau Développeur vers le niveau Premium, envisagez d’agréger plusieurs environnements hors production dans une seule instance de niveau Premium. Utilisez des espaces de travail dans le niveau Premium pour isoler les différents environnements.

  • Utiliser des instances de niveau Développeur pour le développement, migrer vers des espaces de travail dans le niveau Premium pour la production

    Vous pouvez utiliser des instances de niveau Développeur pour les environnements de développement. Pour les environnements plus élevés, vous pouvez migrer la configuration de chaque service de niveau Développeur vers un espace de travail d’un service de niveau Premium, par exemple, à l’aide de pipelines CI/CD. Avec cette approche, vous pouvez rencontrer des problèmes ou des conflits lors de la gestion des configurations entre les environnements.

    Si vous utilisez actuellement des espaces de travail dans une instance de niveau Développeur, vous pouvez migrer les configurations de l’espace de travail vers une instance de niveau Développeur sans espaces de travail :

    1. Exportez un modèle Resource Manager à partir de votre instance de Gestion des API. Vous pouvez exporter le modèle à partir du Portail Azure ou à l’aide d’autres outils.
    2. Supprimez la sous-chaîne suivante des valeurs d’ID de ressource : /workspaces/[^/]+
    3. Déployez le modèle. Pour plus d’informations, consultez Démarrage rapide : Créer et déployer des modèles ARM à l’aide du Portail Azure.

    Selon votre cas d’usage, vous devrez peut-être effectuer d’autres modifications de configuration dans votre instance de Gestion des API.

Affectation d’entités au niveau de l’espace de travail

Si vous avez affecté des entités au niveau de l’espace de travail aux entités au niveau du service dans la préversion des espaces de travail, consultez le tableau suivant pour obtenir des conseils de migration.

Affectation non prise en charge Étape de migration recommandée
Affecter des API d’espace de travail à des produits de niveau de service Utiliser des produits au niveau de l’espace de travail
Affecter des API ou des produits d’espace de travail à des balises de niveau de service Utiliser des balises au niveau de l’espace de travail

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.