Munkaterületek kompatibilitástörő változásai, 2. rész (2025. március)

A KÖVETKEZŐKRE VONATKOZIK: Prémium

Fontos

2025 augusztusában bejelentettük, hogy a cikkben ismertetett munkaterületekkel kapcsolatos kompatibilitástörő változások némelyikét visszavonták. Részletekért tekintse meg a közleményt

Fontos

Ezek a kompatibilitástörő módosítások csak az Azure API Management előzetes verziójú munkaterületeire vonatkoznak. Ha az általánosan elérhető 2024. augusztusi kiadás után létrehozott munkaterületeket, és munkaterület-átjárókkal rendelkező munkaterületeket használ, a munkaterületeket nem érintik ezek a módosítások.

Az Azure API Management-munkaterületek már általánosan elérhetők, és számos funkciófrissítést vezettünk be ezzel a kiadással. A munkaterületek folyamatos fejlesztésének részeként megszüntetjük a (2024 augusztusa előtt létrehozott) előzetes verziójú munkaterületek támogatását. Ha előzetes verziójú munkaterületeket hozott létre az Azure API Managementben, és továbbra is használni szeretné őket, át kell telepítenie a munkaterületeket az általánosan elérhető verzióra.

2025. március 31-e után a bennük felügyelt előzetes munkaterületek és API-k leállhatnak, ha nem migrált a legújabb munkaterületi képességekre. A munkaterületeken kívül felügyelt API-kat és erőforrásokat ez a változás nem érinti.

A szolgáltatásomat érintik ezek a változások?

A szolgáltatásra hatással lehetnek ezek a módosítások, ha előzetes verziójú munkaterületeket hozott létre az API Management-példányban, mielőtt a munkaterületek 2024 augusztusában általánosan elérhetővé válnak. Az API-futtatókörnyezethez munkaterület-átjárókat használó általánosan elérhető kiadási dátum után létrehozott munkaterületeket nem érintik a kompatibilitástörő változások.

Kompatibilitástörő változások

Az alábbi kompatibilitástörő módosítások megkövetelik, hogy az előzetes verziójú munkaterületeket az általánosan elérhető verzióra migrálja:

  • Munkaterületi API-átjáró szükséges – Minden munkaterületet egy munkaterületi API-átjáróhoz kell társítani, amely elkülöníti a munkaterület futásidejű forgalmát. Előzetes verzióban a munkaterületek megosztottak egy átjárót a szolgáltatással.
  • A szolgáltatásszintű felügyelt identitások nem támogatottak – A munkaterületek biztonságának javítása érdekében a szolgáltatásszinten engedélyezett rendszer által hozzárendelt és felhasználó által hozzárendelt felügyelt identitások nem használhatók a munkaterületeken. A munkaterületeken jelenleg nem támogatottak a felügyelt identitásoktól függő kapcsolódó API Management-funkciók, például a névvel ellátott értékek és tanúsítványok tárolása az Azure Key Vaultban, valamint a authentication-managed-identity szabályzat használata.

Feljegyzés

Ezek a kompatibilitástörő változások a korábban bejelentett, előzetes verziójú munkaterületekre vonatkozó 2024. júniusi kompatibilitástörő változások mellett jelentkeznek.

Mi a változás határideje?

A kompatibilitástörő módosításokat 2025. március 31-e után kényszerítjük ki az előzetes verziójú munkaterületeken. Határozottan javasoljuk, hogy minden szükséges módosítást végezze el az előzetes verziójú munkaterületek konfigurációján az adott dátum előtt.

Mi a teendőm?

Ha a munkaterületeket érintik ezek a változások, migrálnia kell a munkaterületeket az általánosan elérhető képességeknek megfelelően. A következő szakaszok útmutatást nyújtanak a munkaterületek migrálásához.

Prémium szint használata az API Management-példányhoz

Győződjön meg arról, hogy az API Management-példány a Prémium szintre van állítva, hogy folytathassa a munkaterületek használatát. A korábban bejelentett módon, ha a példány a Standard vagy a Fejlesztői szinten van, frissítenie kell a Prémium szintre.

A példány régiójának megerősítése

Munkaterület-átjáró munkaterülethez való hozzáadásához az átjárónak ugyanabban a régióban kell rendelkeznie, mint a példánya. Jelenleg a munkaterületi átjárók támogatottak azon régiók egy részhalmazában , amelyekben az API Management elérhető. A munkaterület-átjárók támogatását élvező régiók idővel frissülnek.

Annak megállapításához, hogy egy előzetes verziójú munkaterület támogatott régióban van-e:

  1. Az Azure Portalon keresse meg az API Management-példányt.
  2. A bal oldali menü API-k csoportjában válassza a Munkaterületek lehetőséget, és válasszon egy munkaterületet.
  3. Ha a munkaterület olyan régióban található, amely nem támogatja a munkaterület-átjárókat, a portálon a következőhöz hasonló üzenet jelenik meg: "A munkaterületek jelenleg nem érhetők el az API Management szolgáltatás régiójában".
    • Ha megjelenik ez az üzenet, áthelyezheti az API Management-példányt egy támogatott régióba.
    • Ha nem látja ezt az üzenetet, a munkaterület egy támogatott régióban található, és folytathatja a munkaterület-átjáró hozzáadását.

Munkaterület-átjáró hozzáadása a munkaterülethez

Az alábbiakban rövidített lépéseket követve adhat hozzá munkaterület-átjárót egy munkaterülethez. Az átjárók hálózatkezelési beállításairól, előfeltételeiről és részletes utasításairól lásd : Munkaterület létrehozása és kezelése.

Feljegyzés

  • A munkaterület-átjáró további díjakat von maga után. További információkért tekintse meg az API Management díjszabását.
  • Bevezetjük azt a lehetőséget, hogy több munkaterületet társítsunk egy munkaterület-átjáróhoz, így a szervezetek alacsonyabb költséggel kezelhetik az API-kat a munkaterületekkel. Ez a funkció 2024 decemberétől lesz elérhető, és lehet, hogy január előtt nem minden jogosult szolgáltatás számára érhető el. Tudj meg többet
  1. Az Azure Portalon keresse meg az API Management-példányt.
  2. A bal oldali menü API-k csoportjában válassza a Munkaterületek lehetőséget.
  3. Jelöljön ki egy munkaterületet.
  4. A bal oldali menü Üzembe helyezés + infrastruktúra területén válassza az Átjárók>+ Hozzáadás lehetőséget.
  5. Fejezze be a varázsló lépéseit egy új átjáró létrehozásához vagy egy meglévő átjáró kapcsolásához. Az új átjáró kiépítése jelenleg több perctől akár 3 óráig is eltarthat.
  6. Az átjáró hozzáadása után lépjen az átjáró Áttekintés lapjára. Jegyezze fel a Futtatókörnyezet gazdagépnév értékét. Ezzel az értékkel frissítheti a munkaterület API-jait meghívó ügyfélalkalmazásokat.
  7. Ismételje meg az előző lépéseket a fennmaradó munkaterületek esetében.

Az ügyfélalkalmazások frissítése az új átjáró gazdagépnevének használatára

Miután hozzáadott egy átjárót a munkaterülethez, frissítenie kell azokat az ügyfélalkalmazásokat, amelyek meghívják a munkaterület API-jait, hogy az API Management-példány átjáró-állomásneve helyett az új átjáró gazdanevét használják.

Feljegyzés

A munkaterületek migrálásának elősegítése érdekében a munkaterületeken lévő API-k 2024 októbere után is elérhetők futtatókörnyezetben az API Management-példány átjárójának gazdanevével, még akkor is, ha egy munkaterület-átjáró egy munkaterülethez van társítva. Határozottan javasoljuk, hogy végezze el a migrálást a dátum előtt. Ha a munkaterületi átjárók privát bejövő hozzáféréssel és privát kimenő hozzáféréssel vannak konfigurálva, győződjön meg arról, hogy az API Management-példány beépített átjárójához való csatlakozás is biztonságos.

A szolgáltatásszintű felügyelt identitások függőségeinek frissítése

Ha szolgáltatásszintű felügyelt identitásokat használ a munkaterület-entitások (például elnevezett értékek vagy tanúsítványok) konfigurációjában, frissítenie kell a konfigurációkat. Az ajánlott lépések az entitástól függően változnak. Példa: Névvel ellátott értékek frissítése titkos értékek használatára az Azure Key Vaultban tárolt titkos kódok helyett.

Súgó és támogatás

Ha kérdései vannak, válaszokat kaphat a Microsoft Q&A közösségi szakértőitől. Ha rendelkezik támogatási csomaggal, és technikai segítségre van szüksége, hozzon létre egy támogatási kérést.

További információ

Kapcsolódó tartalom

Tekintse meg az összes közelgő kompatibilitástörő változást és a funkciók megszüntetését.

  • Last updated on