Změny způsobující chybu pracovních prostorů, část 2 (březen 2025)

PLATÍ PRO: Premium

Důležité

V srpnu 2025 jsme oznámili, že některé změny způsobující chyby související s pracovními prostory popsané v tomto článku byly zrušeny. Podrobnosti najdete v oznámení.

Důležité

Tyto zásadní změny platí jenom pro pracovní prostory ve verzi Preview ve službě Azure API Management. Pokud jste vytvořili pracovní prostory po obecně dostupné verzi v srpnu 2024 a používali pracovní prostory s bránami pracovních prostorů, neměly by na tyto změny mít vliv.

Pracovní prostory služby Azure API Management jsou teď obecně dostupné a v této verzi jsme představili několik aktualizací funkcí. V rámci našeho průběžného vývoje pracovních prostorů odebíráme podporu náhledových pracovních prostorů vytvořených před srpnem 2024. Pokud jste ve službě Azure API Management vytvořili pracovní prostory ve verzi Preview a chcete je dál používat, musíte pracovní prostory migrovat do obecně dostupné verze.

Po 31. březnu 2025 můžou vaše pracovní prostory a rozhraní API spravované ve verzi Preview přestat fungovat, pokud jste nemigrovali na nejnovější možnosti pracovního prostoru. Tato změna nemá vliv na rozhraní API a prostředky spravované mimo pracovní prostory.

Týká se moje služba těmito změnami?

Pokud jste v instanci služby API Management vytvořili pracovní prostory ve verzi Preview, může to mít vliv na vaši službu ještě před obecně dostupnou verzí pracovních prostorů v srpnu 2024. Na pracovní prostory vytvořené po obecně dostupném datu vydání, které používají brány pracovních prostorů pro modul runtime rozhraní API, nebudou mít zásadní změny vliv.

Změny způsobující chyby

Následují zásadní změny, které vyžadují provedení akce při migraci pracovních prostorů Preview na obecně dostupnou verzi:

  • Je vyžadována brána rozhraní API pracovního prostoru – Každý pracovní prostor musí být přidružený k bráně rozhraní API pracovního prostoru, která izoluje provoz běhového prostředí pracovního prostoru. Ve verzi Preview pracovní prostory sdílely bránu se službou.
  • Spravované identity na úrovni služby se nepodporují – pokud chcete zlepšit zabezpečení pracovních prostorů, spravované identity přiřazené systémem a uživatelem, které jsou povolené na úrovni služby, se nedají používat v pracovních prostorech. Související funkce služby API Management, které jsou závislé na spravovaných identitách, jako je ukládání pojmenovaných hodnot a certifikátů ve službě Azure Key Vault a používání authentication-managed-identity zásad, se v pracovních prostorech nepodporují.

Poznámka:

Tyto zásadní změny jsou kromě zásadních změn z června 2024 pro pracovní prostory ve verzi Preview, které byly oznámeny dříve.

Jaký je konečný termín změny?

Zásadní změny budou vynuceny v pracovních prostorech ve verzi preview po 31. březnu 2025. Důrazně doporučujeme provést všechny požadované změny konfigurace pracovních prostorů ve verzi Preview před tímto datem.

Co musíme udělat?

Pokud jsou tyto změny ovlivněné vašimi pracovními prostory, musíte pracovní prostory migrovat, aby byly v souladu s obecně dostupnými možnostmi. Následující části obsahují pokyny k migraci pracovních prostorů.

Použití úrovně Premium pro instanci služby API Management

Ujistěte se, že vaše instance služby API Management běží na úrovni Premium , abyste mohli dál používat pracovní prostory. Jak už bylo oznámeno dříve, pokud je vaše instance na úrovni Standard nebo Developer , musíte upgradovat na úroveň Premium .

Potvrďte oblast vaší instance.

Přidání brány pracovního prostoru do pracovního prostoru vyžaduje, aby byla brána ve stejné oblasti jako vaše instance. V současné době se brány pracovních prostorů podporují v podmnožině oblastí , ve kterých je služba API Management dostupná. Oblasti s podporou bran pro pracovní prostory budou časem aktualizovány.

Určení, jestli je pracovní prostor ve verzi Preview v podporované oblasti:

  1. Na webu Azure Portal přejděte k vaší instanci služby API Management.
  2. V nabídce vlevo v části Rozhraní API vyberte Pracovní prostory a vyberte pracovní prostor.
  3. Pokud je váš pracovní prostor v oblasti, která nepodporuje brány pracovních prostorů, zobrazí se na portálu zpráva typu Pracovní prostory jsou momentálně nedostupné v oblasti vaší služby API Management.
    • Pokud se zobrazí tato zpráva, můžete přesunout instanci služby API Management do podporované oblasti.
    • Pokud tuto zprávu nevidíte, váš pracovní prostor je v podporované oblasti a můžete pokračovat přidáním brány pracovního prostoru.

Přidání brány pracovního prostoru do pracovního prostoru

Následuje zkrácený postup přidání brány pracovního prostoru do pracovního prostoru. Informace o možnostech sítě brány, požadavcích a podrobných pokynech najdete v tématu Vytvoření a správa pracovního prostoru.

Poznámka:

  • Za bránu pracovního prostoru se účtují další poplatky. Další informace najdete v tématu o cenách služby API Management.
  • Představujeme možnost přidružit více pracovních prostorů k bráně pro pracovní prostory, což pomáhá organizacím spravovat rozhraní API prostřednictvím pracovních prostorů za nižší náklady. Tato funkce se zavádí od prosince 2024 a nemusí být k dispozici pro všechny oprávněné služby před lednem. Další informace
  1. Na webu Azure Portal přejděte k vaší instanci služby API Management.
  2. V nabídce vlevo v části Rozhraní API vyberte Pracovní prostory.
  3. Výběr pracovního prostoru.
  4. V nabídce vlevo v části Nasazení a infrastruktura vyberte Brány>+ Přidat.
  5. Dokončením průvodce vytvořte novou bránu nebo přidružte existující bránu. Zřízení nové brány v současné době může trvat několik minut až 3 hodiny nebo déle.
  6. Po přidání brány přejděte na stránku Přehled brány. Poznamenejte si hodnotu názvu hostitele modulu runtime. Tuto hodnotu použijte k aktualizaci klientských aplikací, které volají rozhraní API pracovního prostoru.
  7. Opakujte předchozí kroky pro zbývající pracovní prostory.

Aktualizace klientských aplikací tak, aby používaly nový název hostitele brány

Po přidání brány do pracovního prostoru je potřeba aktualizovat klientské aplikace, které volají rozhraní API pracovního prostoru, aby místo názvu hostitele vaší instance služby API Management používala nový název hostitele brány.

Poznámka:

Pro pomoc při migraci pracovních prostorů mohou být rozhraní API v pracovních prostorech stále přístupná až do října 2024 pomocí názvu hostitele brány vaší instance služby API Management, i když je brána pracovního prostoru přiřazena pracovnímu prostoru. Důrazně doporučujeme dokončit migraci před tímto datem. Pokud jsou brány pracovního prostoru nakonfigurované s privátním příchozím přístupem a privátním odchozím přístupem, ujistěte se, že je zabezpečené také připojení k integrované bráně služby API Management.

Aktualizace závislostí na spravovaných identitách na úrovni služby

Pokud používáte spravované identity na úrovni služby v konfiguraci entit pracovního prostoru (například pojmenované hodnoty nebo certifikáty), je potřeba aktualizovat konfigurace. Doporučené kroky se liší v závislosti na entitě. Příklad: Aktualizujte pojmenované hodnoty tak, aby místo tajemství uložených v Azure Key Vault používaly tajné hodnoty.

Nápověda a podpora

Pokud máte další dotazy, získejte odpovědi od odborníků z komunity prostřednictvím Microsoft Q&A. Pokud máte plán podpory a potřebujete technickou pomoc, vytvořte žádost o podporu.

Více informací

Související obsah

Podívejte se na všechny nadcházející zásadní změny a vyřazení funkcí.

  • Last updated on