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

PLATÍ PRO: Premium

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 pracovních prostorů ve verzi Preview (vytvořenou 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:

  • Vyžaduje se 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 modulu runtime 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?

Změny způsobující chybu se vynucují v pracovních prostorech 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 brána byla 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 pracovních prostorů se časem aktualizují.

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.
  • API Management v současné době podporuje vyhrazenou bránu pouze pro každý pracovní prostor. Pokud to má vliv na vaše plány migrace, podívejte se na plán pracovních prostorů v oznámení ga pracovních prostorů.
  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čete průvodce a vytvořte bránu. Zřizování brány v současné době může trvat několik minut až 3 hodiny nebo déle.
  6. Po zřízení 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:

Aby bylo možné migrovat pracovní prostory, můžou 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, a to i v případě, že je brána pracovního prostoru přidružená k 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 tajných kódů uložených ve službě 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í

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