Delen via


Wijzigingen die fouten veroorzaken in werkruimten, deel 2 (maart 2025)

VAN TOEPASSING OP: Premium

Belangrijk

Deze belangrijke wijzigingen zijn alleen van toepassing op preview-werkruimten in Azure API Management. Als u werkruimten hebt gemaakt na de algemeen beschikbare release in augustus 2024 en werkruimten met werkruimtegateways gebruikt, mogen uw werkruimten niet worden beïnvloed door deze wijzigingen.

Azure API Management-werkruimten zijn nu algemeen beschikbaar en we hebben verschillende functie-updates geïntroduceerd met die release. Als onderdeel van onze voortdurende ontwikkeling van werkruimten verwijderen we de ondersteuning voor preview-werkruimten (gemaakt vóór augustus 2024). Als u preview-werkruimten hebt gemaakt in Azure API Management en deze wilt blijven gebruiken, moet u uw werkruimten migreren naar de algemeen beschikbare versie.

Na 31 maart 2025 werken uw preview-werkruimten en API's die erin worden beheerd mogelijk niet meer als u niet bent gemigreerd naar de nieuwste werkruimtemogelijkheden. 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 preview-werkruimten hebt gemaakt in uw API Management-exemplaar, vóór de algemeen beschikbare release van werkruimten in augustus 2024. Werkruimten die zijn gemaakt na de algemeen beschikbare releasedatum die gebruikmaken van werkruimtegateways voor API-runtime, worden niet beïnvloed door de wijzigingen die fouten veroorzaken.

Wijzigingen die fouten veroorzaken

Hier volgen belangrijke wijzigingen waarvoor u actie moet ondernemen om uw preview-werkruimten te migreren naar de algemeen beschikbare versie:

  • Werkruimte-API-gateway is vereist : elke werkruimte moet worden gekoppeld aan een werkruimte-API-gateway waarmee het runtimeverkeer van de werkruimte wordt geïsoleerd. In preview hebben werkruimten een gateway gedeeld met de service.
  • Beheerde identiteiten op serviceniveau worden niet ondersteund : om de beveiliging van werkruimten te verbeteren, kunnen door het systeem toegewezen en door de gebruiker toegewezen beheerde identiteiten op serviceniveau niet worden gebruikt in werkruimten. Momenteel worden gerelateerde API Management-functies die afhankelijk zijn van beheerde identiteiten, zoals het opslaan van benoemde waarden en certificaten in Azure Key Vault en het gebruik van het authentication-managed-identity beleid, niet ondersteund in werkruimten.

Notitie

Deze belangrijke wijzigingen zijn naast de wijzigingen die fouten veroorzaken in juni 2024 voor preview-werkruimten die eerder zijn aangekondigd.

Wat is de deadline voor de wijziging?

De belangrijke wijzigingen worden na 31 maart 2025 afgedwongen in preview-werkruimten. We raden u ten zeerste aan alle vereiste wijzigingen aan te brengen in de configuratie van uw preview-werkruimten vóór die datum.

Wat moet ik hiervoor doen?

Als uw werkruimten worden beïnvloed door deze wijzigingen, moet u uw werkruimten migreren om te worden afgestemd op de algemeen beschikbare mogelijkheden. De volgende secties bevatten richtlijnen voor het migreren van uw werkruimten.

Premium-laag gebruiken voor uw API Management-exemplaar

Zorg ervoor dat uw API Management-exemplaar wordt uitgevoerd in de Premium-laag om werkruimten te blijven gebruiken. Zoals eerder aangekondigd, moet u upgraden naar de Premium-laag als uw exemplaar zich in de Standard- of Developer-laag bevindt.

De regio voor uw exemplaar bevestigen

Als u een werkruimtegateway aan een werkruimte toevoegt, moet de gateway zich in dezelfde regio bevinden als uw exemplaar. Momenteel worden werkruimtegateways ondersteund in een subset van regio's waarin API Management beschikbaar is. De regio's met ondersteuning voor werkruimtegateways worden na verloop van tijd bijgewerkt.

Om te bepalen of een preview-werkruimte zich in een ondersteunde regio bevindt:

  1. Blader in Azure Portal naar uw API Management-exemplaar.
  2. Selecteer werkruimten in het linkermenu onder API's en selecteer een werkruimte.
  3. Als uw werkruimte zich in een regio bevindt die geen ondersteuning biedt voor werkruimtegateways, ziet u een bericht in de portal dat lijkt op 'Werkruimten zijn momenteel niet beschikbaar in de regio van uw API Management-service'.
    • Als u dit bericht ziet, kunt u uw API Management-exemplaar verplaatsen naar een ondersteunde regio.
    • Als u dit bericht niet ziet, bevindt uw werkruimte zich in een ondersteunde regio en kunt u doorgaan met het toevoegen van een werkruimtegateway.

Een werkruimtegateway toevoegen aan uw werkruimte

Hieronder volgen de verkorte stappen voor het toevoegen van een werkruimtegateway aan een werkruimte. Zie Een werkruimte maken en beheren voor opties voor gatewaynetwerken, vereisten en gedetailleerde instructies.

Notitie

  • Voor de werkruimtegateway worden extra kosten in rekening gebracht. Zie prijzen voor API Management voor meer informatie.
  • We introduceren de mogelijkheid om meerdere werkruimten te koppelen aan een werkruimtegateway, zodat organisaties API's met werkruimten tegen lagere kosten kunnen beheren. Deze functie wordt vanaf december 2024 geïmplementeerd en is mogelijk niet beschikbaar voor alle in aanmerking komende services vóór januari. Meer informatie
  1. Blader in Azure Portal naar uw API Management-exemplaar.
  2. Selecteer werkruimten in het linkermenu onder API's.
  3. Selecteer een werkruimte.
  4. Selecteer Gateways>+ Toevoegen in het linkermenu onder Implementatie en infrastructuur.
  5. Voltooi de wizard om een gateway te maken. Op dit moment kan het inrichten van de gateway enkele minuten tot 3 uur of langer duren.
  6. Nadat uw gateway is ingericht, gaat u naar de pagina Overzicht van de gateway. Noteer de waarde van runtime-hostnaam. Gebruik deze waarde om uw client-apps bij te werken die de API's van uw werkruimte aanroepen.
  7. Herhaal de voorgaande stappen voor de resterende werkruimten.

Client-apps bijwerken om de nieuwe gatewayhostnaam te gebruiken

Nadat u een gateway aan uw werkruimte hebt toegevoegd, moet u uw client-apps bijwerken die de API's van de werkruimte aanroepen om de nieuwe gatewayhostnaam te gebruiken in plaats van de hostnaam van de gateway van uw API Management-exemplaar.

Notitie

Om u te helpen bij het migreren van uw werkruimten, kunnen API's in werkruimten nog steeds worden geopend tijdens runtime tot en met oktober 2024 met behulp van de hostnaam van de gateway van uw API Management-exemplaar, zelfs als een werkruimtegateway is gekoppeld aan een werkruimte. We raden u ten zeerste aan om de migratie vóór deze datum te voltooien. Als uw werkruimtegateways zijn geconfigureerd met privé-binnenkomende toegang en privé-uitgaande toegang, moet u ervoor zorgen dat de connectiviteit met de ingebouwde gateway van uw API Management-exemplaar ook is beveiligd.

Afhankelijkheden van beheerde identiteiten op serviceniveau bijwerken

Als u beheerde identiteiten op serviceniveau gebruikt in de configuratie van werkruimte-entiteiten (bijvoorbeeld benoemde waarden of certificaten), moet u de configuraties bijwerken. De aanbevolen stappen variëren afhankelijk van de entiteit. Voorbeeld: Benoemde waarden bijwerken om geheime waarden te gebruiken in plaats van geheimen die zijn opgeslagen in Azure Key Vault.

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.