Dela via

Arbetsytor – icke-bakåtkompatibla ändringar (juni 2024)

  • Artikel

GÄLLER FÖR: Utvecklare | Standard | Premie

Viktigt!

Om du skapade arbetsytor efter den allmänt tillgängliga versionen av arbetsytor i juli 2024 bör dina arbetsytor inte påverkas av dessa ändringar.

Efter den 14 juni 2024, som en del av vår utveckling av arbetsytor i Azure API Management, introducerar vi flera icke-bakåtkompatibla ändringar.

Efter den 14 juni 2024 kan dina arbetsytor och API:er som hanteras i dem sluta fungera om de fortfarande förlitar sig på de funktioner som har angetts för att ändras. 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 konfigurerat arbetsytor (förhandsversion) i DIN API Management-instans. Den här funktionen introducerades på nivåerna Premium, Standard och Developer .

Icke-bakåtkompatibla ändringar

Granska följande icke-bakåtkompatibla ändringar för att avgöra om du behöver vidta åtgärder:

Ändra till tjänstnivåer som stöds

Följande tjänstnivåer stöder inte längre arbetsytor: Standard och Utvecklare. Arbetsytor kommer att vara tillgängliga på Premium-nivån .

Mer information om tillgänglighet på v2-nivåerna finns i Azure API Management v2-nivåer.

Ändringar i stöd för tilldelning av entiteter på tjänstnivå i arbetsytor

Följande tilldelningar av arbetsyteentiteter till entiteter på tjänstnivå stöds inte längre:

  • Tilldela arbetsyte-API:er till produkter på servicenivå

  • Tilldela arbetsyte-API:er till taggar på tjänstnivå

  • Tilldela arbetsyteprodukter till taggar på servicenivå

  • Tilldela servicenivågrupper till arbetsyteprodukter för synlighetskontroller

    Kommentar

    De inbyggda grupperna Gäster och Utvecklare fortsätter att vara tillgängliga på arbetsytor.

Ändringar i kontextobjekt som stöds

Följande context objekt stöds inte längre i arbetsyteprinciper eller i principen för alla API:er på tjänstnivå:

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

Objektet context.Workspace kan användas i stället.

Kommentar

Du kan fortsätta att referera till användare från tjänstnivån i context objektet i principer på arbetsytenivå.

Vilken är tidsfristen för ändringen?

De icke-bakåtkompatibla ändringarna kommer att införas efter den 14 juni 2024. Vi rekommenderar starkt att du gör alla nödvändiga ändringar i konfigurationen av arbetsytor före det datumet.

Vad behöver jag göra?

Om dina arbetsytor påverkas av dessa ändringar måste du uppdatera dina arbetsytekonfigurationer så att de överensstämmer med de nya funktionerna.

Standardnivåkunder

Om du använder arbetsytor på standardnivån uppgraderar du till Premium-nivån för att fortsätta använda arbetsytor.

Kunder på utvecklarnivå

Utvecklarnivån har utformats för användningsfall med en användare eller ett team. Det går inte att underlätta samarbete mellan flera team med arbetsytor på grund av begränsade databehandlingsresurser, brist på serviceavtal och ingen infrastrukturredundans. Om du använder förhandsversionen av arbetsytor på nivån Utvecklare kan du välja något av följande alternativ:

  • Aggregera i en Premium-nivåinstans

    Även om det är ett alternativ att uppgradera varje instans på utvecklarnivå till Premium-nivå bör du överväga att aggregera flera icke-produktionsmiljöer i en enda Premium-nivåinstans. Använd arbetsytor på Premium-nivån för att isolera de olika miljöerna.

  • Använda instanser på utvecklarnivå för utveckling, migrera till arbetsytor på Premium-nivå för produktion

    Du kan använda instanser på utvecklarnivå för utvecklingsmiljöer. För högre miljöer kan du migrera konfigurationen av varje tjänst på utvecklarnivå till en arbetsyta för en Premium-nivåtjänst, till exempel med hjälp av CI/CD-pipelines. Med den här metoden kan du stöta på problem eller konflikter när du hanterar konfigurationerna i olika miljöer.

    Om du för närvarande använder arbetsytor i en instans på utvecklarnivå kan du migrera arbetsytekonfigurationerna till en instans på utvecklarnivå utan arbetsytor:

    1. Exportera en Resource Manager-mall från din API Management-instans. Du kan exportera mallen från Azure Portal eller med hjälp av andra verktyg.
    2. Ta bort följande delsträng av resurs-ID-värdena: /workspaces/[^/]+
    3. Distribuera mallen. Mer information finns i Snabbstart: Skapa och distribuera ARM-mallar med hjälp av Azure Portal.

    Beroende på ditt användningsfall kan du behöva utföra andra konfigurationsändringar i DIN API Management-instans.

Tilldelning av entiteter på arbetsytenivå

Om du har tilldelat entiteter på arbetsytenivå till entiteter på tjänstnivå i förhandsversionen av arbetsytor läser du följande tabell för migreringsvägledning.

Tilldelning stöds inte längre Rekommenderat migreringssteg
Tilldela arbetsyte-API:er till produkter på servicenivå Använda produkter på arbetsytenivå
Tilldela arbetsyte-API:er eller produkter till taggar på servicenivå Använda taggar på arbetsytenivå

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.