Dela via

Ändringar som bryter mot arbetsytor, del 2 (mars 2025)

  • Artikel

GÄLLER FÖR: Premium

Viktigt!

Dessa icke-bakåtkompatibla ändringar gäller endast för förhandsversioner av arbetsytor i Azure API Management. Om du skapade arbetsytor efter den allmänt tillgängliga versionen i augusti 2024 och använder arbetsytor med arbetsytegatewayer bör dina arbetsytor inte påverkas av dessa ändringar.

Azure API Management-arbetsytor är nu allmänt tillgängliga och vi introducerade flera funktionsuppdateringar med den versionen. Som en del av vår fortsatta utveckling av arbetsytor tar vi bort stöd för förhandsgranskningsarbetsytor (skapade före augusti 2024). Om du har skapat förhandsgranskningsarbetsytor i Azure API Management och vill fortsätta använda dem måste du migrera dina arbetsytor till den allmänt tillgängliga versionen.

Efter den 31 mars 2025 kan dina förhandsgranskningsarbetsytor och API:er som hanteras i dem sluta fungera om du inte har migrerat till de senaste funktionerna för arbetsytor. API:er och resurser som hanteras utanför arbetsytor påverkas inte av den här ändringen.

Påverkas min tjänst av dessa ändringar?

Tjänsten kan påverkas av dessa ändringar om du har skapat förhandsgranskningsarbetsytor i DIN API Management-instans innan den allmänt tillgängliga versionen av arbetsytor i augusti 2024. Arbetsytor som skapats efter det allmänt tillgängliga lanseringsdatumet som använder arbetsytegatewayer för API-körning påverkas inte av de icke-bakåtkompatibla ändringarna.

Icke-bakåtkompatibla ändringar

Följande är icke-bakåtkompatibla ändringar som kräver att du vidtar åtgärder för att migrera dina förhandsgranskningsarbetsytor till den allmänt tillgängliga versionen:

  • API-gateway för arbetsyta krävs – Varje arbetsyta måste associeras med en API-gateway för arbetsytan som isolerar arbetsytans körningstrafik. I förhandsversionen delade arbetsytor en gateway med tjänsten.
  • Hanterade identiteter på tjänstnivå stöds inte – För att förbättra säkerheten för arbetsytor kan systemtilldelade och användartilldelade hanterade identiteter som är aktiverade på tjänstnivå inte användas på arbetsytor. För närvarande stöds inte relaterade API Management-funktioner som är beroende av hanterade identiteter, till exempel lagring av namngivna värden och certifikat i Azure Key Vault och användning av authentication-managed-identity principen, i arbetsytor.

Kommentar

Dessa icke-bakåtkompatibla ändringar är utöver de icke-bakåtkompatibla ändringarna i juni 2024 för förhandsgranskningsarbetsytor som tillkännagavs tidigare.

Vilken är tidsfristen för ändringen?

De icke-bakåtkompatibla ändringarna tillämpas i förhandsgranskningsarbetsytor efter den 31 mars 2025. Vi rekommenderar starkt att du gör alla nödvändiga ändringar i konfigurationen av dina förhandsgranskningsarbetsytor före det datumet.

Vad behöver jag göra?

Om dina arbetsytor påverkas av dessa ändringar måste du migrera dina arbetsytor så att de överensstämmer med de allmänt tillgängliga funktionerna. Följande avsnitt innehåller vägledning om hur du migrerar dina arbetsytor.

Använda Premium-nivån för din API Management-instans

Se till att DIN API Management-instans körs på Premium-nivån för att fortsätta använda arbetsytor. Som tidigare meddelats måste du uppgradera till Premium-nivån om din instans är på standard- eller utvecklarnivån.

Bekräfta regionen för din instans

Om du lägger till en arbetsytegateway till en arbetsyta måste gatewayen vara i samma region som din instans. För närvarande stöds arbetsytegatewayer i en delmängd av regioner där API Management är tillgängligt. De regioner som har stöd för arbetsytegatewayer uppdateras med tiden.

Så här avgör du om en förhandsgranskningsarbetsyta finns i en region som stöds:

  1. I Azure Portal navigerar du till din API Management-instans.
  2. I den vänstra menyn, under API:er, väljer du Arbetsytor och väljer en arbetsyta.
  3. Om din arbetsyta finns i en region som inte stöder arbetsytegatewayer visas ett meddelande i portalen som liknar "Arbetsytor är för närvarande inte tillgängliga i regionen för din API Management-tjänst".
    • Om du ser det här meddelandet kan du flytta DIN API Management-instans till en region som stöds.
    • Om du inte ser det här meddelandet finns arbetsytan i en region som stöds och du kan fortsätta att lägga till en arbetsytegateway.

Lägga till en arbetsytegateway till din arbetsyta

Följande är förkortade steg för att lägga till en arbetsytegateway till en arbetsyta. För alternativ för gatewaynätverk, krav och detaljerade instruktioner, se Skapa och hantera en arbetsyta.

Kommentar

  • Arbetsytegatewayen medför ytterligare avgifter. Mer information finns i PRISSÄTTNING FÖR API Management.
  • Vi introducerar möjligheten att associera flera arbetsytor med en arbetsytegateway, vilket hjälper organisationer att hantera API:er med arbetsytor till en lägre kostnad. Den här funktionen lanseras från och med december 2024 och den kanske inte är tillgänglig för alla berättigade tjänster före januari. Läs mer
  1. I Azure Portal navigerar du till din API Management-instans.
  2. I den vänstra menyn går du till API:er och väljer Arbetsytor.
  3. Välj en arbetsyta.
  4. I den vänstra menyn går du till Distribution + infrastruktur och väljer Gateways>+ Lägg till.
  5. Slutför guiden för att skapa en gateway. För närvarande kan etableringen av gatewayen ta från flera minuter till upp till 3 timmar eller längre.
  6. När din gateway har etablerats går du till gatewayens översiktssida. Observera värdet för Runtime-värdnamnet. Använd det här värdet för att uppdatera dina klientappar som anropar arbetsytans API:er.
  7. Upprepa föregående steg för återstående arbetsytor.

Uppdatera klientappar så att de använder det nya gateway-värdnamnet

När du har lagt till en gateway till din arbetsyta måste du uppdatera dina klientappar som anropar arbetsytans API:er för att använda det nya gateway-värdnamnet i stället för gatewayens värdnamn för din API Management-instans.

Kommentar

För att hjälpa dig att migrera dina arbetsytor kan API:er på arbetsytor fortfarande nås vid körning till oktober 2024 med hjälp av gateway-värdnamnet för din API Management-instans, även om en arbetsytegateway är associerad med en arbetsyta. Vi rekommenderar starkt att du slutför migreringen före det här datumet. Om dina arbetsytegatewayer har konfigurerats med privat inkommande åtkomst och privat utgående åtkomst kontrollerar du att anslutningen till API Management-instansens inbyggda gateway också är skyddad.

Uppdatera beroenden för hanterade identiteter på tjänstnivå

Om du använder hanterade identiteter på tjänstnivå i konfigurationen av arbetsyteentiteter (till exempel namngivna värden eller certifikat) måste du uppdatera konfigurationerna. Rekommenderade steg varierar beroende på entitet. Exempel: Uppdatera namngivna värden för att använda hemliga värden i stället för hemligheter som lagras i Azure Key Vault.

Hjälp och support

Om du har frågor kan du få svar från communityexperter i Vanliga frågor och svar om Microsoft. Om du har ett supportavtal och behöver teknisk hjälp kan du skapa en supportbegäran.

Mer information

Relaterat innehåll

Se alla kommande icke-bakåtkompatibla ändringar och funktionsavbrott.