Share via


Werkruimten- belangrijke wijzigingen (juni 2024)

VAN TOEPASSING OP: Ontwikkelaar | Standaard | Premium

Na 14 juni 2024 introduceren we enkele belangrijke wijzigingen als onderdeel van onze ontwikkeling van werkruimten (preview) in Azure API Management.

Na 14 juni 2024 werken uw werkruimten en API's die erin worden beheerd mogelijk niet meer als ze nog steeds afhankelijk zijn van de mogelijkheden die zijn ingesteld om te wijzigen. API's en resources die buiten werkruimten worden beheerd, worden niet beïnvloed door deze wijziging.

Wordt mijn service beïnvloed door deze wijzigingen?

Uw service kan worden beïnvloed door deze wijzigingen als u werkruimten (preview) hebt geconfigureerd in uw API Management-exemplaar. Deze functie is geïntroduceerd in de lagen Premium, Standard en Developer .

Wijzigingen die fouten veroorzaken

Bekijk de volgende belangrijke wijzigingen om te bepalen of u actie moet ondernemen:

Wijzigen in ondersteunde servicelagen

De volgende servicelagen bieden geen ondersteuning meer voor werkruimten: Standard en Developer. Werkruimten zijn beschikbaar in de Premium-laag .

Zie Azure API Management v2-lagen voor beschikbaarheid in de v2-lagen.

Wijzigingen in ondersteuning voor het toewijzen van entiteiten op serviceniveau in werkruimten

De volgende toewijzingen van werkruimte-entiteiten aan entiteiten op serviceniveau worden niet meer ondersteund:

  • Werkruimte-API's toewijzen aan producten op serviceniveau

  • Werkruimte-API's toewijzen aan tags op serviceniveau

  • Werkruimteproducten toewijzen aan tags op serviceniveau

  • Groepen op serviceniveau toewijzen aan werkruimteproducten voor zichtbaarheidsbesturingselementen

    Notitie

    De ingebouwde groepen Gasten en Ontwikkelaars blijven beschikbaar in werkruimten.

Wijzigingen in ondersteunde contextobjecten

De volgende context objecten worden niet meer ondersteund in werkruimtebeleid of in het beleid voor alle API's op serviceniveau:

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

Het context.Workspace object kan in plaats daarvan worden gebruikt.

Notitie

U kunt blijven verwijzen naar gebruikers van het serviceniveau in het context object in beleidsregels op werkruimteniveau.

Wat is de deadline voor de wijziging?

De belangrijke wijzigingen worden geïntroduceerd na 14 juni 2024. We raden u ten zeerste aan alle vereiste wijzigingen aan te brengen in de configuratie van werkruimten vóór die datum.

Wat moet ik hiervoor doen?

Als uw werkruimten worden beïnvloed door deze wijzigingen, moet u uw werkruimteconfiguraties bijwerken zodat deze overeenkomen met de nieuwe mogelijkheden.

Klanten in de Standard-laag

Als u werkruimten in de Standard-laag gebruikt, voert u een upgrade uit naar de Premium-laag om werkruimten te blijven gebruiken.

Klanten in de ontwikkelaarslaag

De developer-laag is ontworpen voor use cases voor één gebruiker of één team. Het is niet mogelijk om samenwerking tussen meerdere teams met werkruimten mogelijk te maken vanwege de beperkte rekenresources, het gebrek aan SLA en geen infrastructuurredundantie. Als u de preview-versie van werkruimten gebruikt in de developer-laag , kunt u een van de volgende opties kiezen:

  • Aggregeren in een premiumlaagexemplaren

    Tijdens het upgraden van elk exemplaar van de Developer-laag naar de Premium-laag is een optie, kunt u overwegen om meerdere niet-productieomgevingen in één Exemplaar van de Premium-laag te aggregeren. Gebruik werkruimten in de Premium-laag om de verschillende omgevingen te isoleren.

  • Instanties van ontwikkelaarslagen gebruiken voor ontwikkeling, migreren naar werkruimten in de Premium-laag voor productie

    U kunt exemplaren van de developer-laag gebruiken voor ontwikkelomgevingen. Voor hogere omgevingen kunt u de configuratie van elke Developer-tier-service migreren naar een werkruimte van een Premium-laagservice, bijvoorbeeld met behulp van CI/CD-pijplijnen. Met deze benadering kunt u problemen of conflicten ondervinden bij het beheren van de configuraties in verschillende omgevingen.

    Als u momenteel werkruimten gebruikt in een instantie van de developer-laag, kunt u de werkruimteconfiguraties migreren naar een exemplaar van de developer-laag zonder werkruimten:

    1. Exporteer een Resource Manager-sjabloon uit uw API Management-exemplaar. U kunt de sjabloon exporteren vanuit Azure Portal of met behulp van andere hulpprogramma's.
    2. Verwijder de volgende subtekenreeks van de resource-id-waarden: /workspaces/[^/]+
    3. De sjabloon implementeren. Zie de quickstart: ARM-sjablonen maken en implementeren met behulp van Azure Portal voor meer informatie.

    Afhankelijk van uw use-case moet u mogelijk andere configuratiewijzigingen uitvoeren in uw API Management-exemplaar.

Toewijzing van entiteiten op werkruimteniveau

Als u entiteiten op werkruimteniveau hebt toegewezen aan entiteiten op serviceniveau in de preview-versie van werkruimten, raadpleegt u de volgende tabel voor migratierichtlijnen.

Toewijzing wordt niet meer ondersteund Aanbevolen migratiestap
Werkruimte-API's toewijzen aan producten op serviceniveau Producten op werkruimteniveau gebruiken
Werkruimte-API's of -producten toewijzen aan tags op serviceniveau Tags op werkruimteniveau gebruiken

Help en ondersteuning

Als u vragen hebt, kunt u antwoorden krijgen van community-experts in Microsoft Q&A. Dien een ondersteuningsaanvraag in als u over een ondersteuningsplan beschikt en technische ondersteuning nodig hebt.

Meer informatie

Bekijk alle aanstaande belangrijke wijzigingen en functie-buitengebruikstelling.