Zmiany powodujące niezgodność obszarów roboczych, część 2 (marzec 2025 r.)
DOTYCZY: Premium
Ważne
Te istotne zmiany dotyczą tylko obszarów roboczych w wersji zapoznawczej w usłudze Azure API Management. Jeśli obszary robocze zostały utworzone po ogólnie dostępnej wersji w sierpniu 2024 r. i używają obszarów roboczych z bramami obszarów roboczych, te zmiany nie powinny mieć wpływu na obszary robocze.
Obszary robocze usługi Azure API Management są teraz ogólnie dostępne i wprowadziliśmy kilka aktualizacji funkcji w tej wersji. W ramach ciągłego opracowywania obszarów roboczych usuwamy obsługę obszarów roboczych w wersji zapoznawczej (utworzonych przed sierpniem 2024 r.). Jeśli utworzono obszary robocze w wersji zapoznawczej w usłudze Azure API Management i chcesz nadal z nich korzystać, musisz przeprowadzić migrację obszarów roboczych do ogólnie dostępnej wersji.
Po 31 marca 2025 r. obszary robocze i interfejsy API w wersji zapoznawczej zarządzane w nich mogą przestać działać, jeśli nie przeprowadzono migracji do najnowszych funkcji obszaru roboczego. Ta zmiana nie ma wpływu na interfejsy API i zasoby zarządzane poza obszarami roboczymi.
Czy na moją usługę mają wpływ te zmiany?
Na twoją usługę mogą mieć wpływ te zmiany, jeśli utworzono obszary robocze w wersji zapoznawczej w wystąpieniu usługi API Management przed ogólnie dostępną wersją obszarów roboczych w sierpniu 2024 r. Obszary robocze utworzone po ogólnie dostępnej dacie wydania, które używają bram obszarów roboczych dla środowiska uruchomieniowego interfejsu API, nie mają wpływu na zmiany powodujące niezgodność.
Zmiany powodujące niezgodność
Poniżej przedstawiono zmiany powodujące niezgodność, które wymagają podjęcia akcji w celu przeprowadzenia migracji obszarów roboczych w wersji zapoznawczej do ogólnie dostępnej wersji:
- Brama interfejsu API obszaru roboczego jest wymagana — każdy obszar roboczy musi być skojarzony z bramą interfejsu API obszaru roboczego, która izoluje ruch środowiska uruchomieniowego obszaru roboczego. W wersji zapoznawczej obszary robocze udostępniły bramę usłudze.
- Tożsamości zarządzane na poziomie usługi nie są obsługiwane — aby zwiększyć bezpieczeństwo obszarów roboczych, tożsamości zarządzane przypisane przez system i przypisane przez użytkownika na poziomie usługi nie mogą być używane w obszarach roboczych. Obecnie powiązane funkcje usługi API Management, które zależą od tożsamości zarządzanych, takich jak przechowywanie nazwanych wartości i certyfikatów w usłudze Azure Key Vault i korzystanie z
authentication-managed-identityzasad, nie są obsługiwane w obszarach roboczych.
Uwaga
Te zmiany powodujące niezgodność są dodatkiem do zmian powodujących niezgodność z czerwca 2024 r. dla obszarów roboczych w wersji zapoznawczej, które zostały wcześniej ogłoszone.
Jaki jest termin zmiany?
Zmiany powodujące niezgodność zostaną wymuszone w obszarach roboczych w wersji zapoznawczej po 31 marca 2025 r. Zdecydowanie zalecamy wprowadzenie wszystkich wymaganych zmian w konfiguracji obszarów roboczych w wersji zapoznawczej przed tą datą.
Co należy zrobić?
Jeśli te zmiany mają wpływ na obszary robocze, należy przeprowadzić migrację obszarów roboczych w celu dostosowania ich do ogólnie dostępnych możliwości. Poniższe sekcje zawierają wskazówki dotyczące sposobu migrowania obszarów roboczych.
Używanie warstwy Premium dla wystąpienia usługi API Management
Upewnij się, że wystąpienie usługi API Management działa w warstwie Premium , aby kontynuować korzystanie z obszarów roboczych. Jak ogłoszono wcześniej, jeśli wystąpienie znajduje się w warstwie Standardowa lub Deweloper , musisz przeprowadzić uaktualnienie do warstwy Premium .
Potwierdzanie regionu dla wystąpienia
Dodanie bramy obszaru roboczego do obszaru roboczego wymaga, aby brama znajduje się w tym samym regionie co wystąpienie. Obecnie bramy obszarów roboczych są obsługiwane w podzestawie regionów , w których usługa API Management jest dostępna. Regiony z obsługą bram obszarów roboczych zostaną zaktualizowane wraz z upływem czasu.
Aby określić, czy obszar roboczy w wersji zapoznawczej znajduje się w obsługiwanym regionie:
- W witrynie Azure Portal przejdź do wystąpienia usługi API Management.
- W menu po lewej stronie w obszarze Interfejsy API wybierz pozycję Obszary robocze i wybierz obszar roboczy.
- Jeśli obszar roboczy znajduje się w regionie, który nie obsługuje bram obszarów roboczych, w portalu zostanie wyświetlony komunikat podobny do "Obszary robocze są obecnie niedostępne w regionie usługi API Management".
- Jeśli widzisz ten komunikat, możesz przenieść wystąpienie usługi API Management do obsługiwanego regionu.
- Jeśli ten komunikat nie jest widoczny, obszar roboczy znajduje się w obsługiwanym regionie i możesz kontynuować dodawanie bramy obszaru roboczego.
Dodawanie bramy obszaru roboczego do obszaru roboczego
Poniżej przedstawiono skrócone kroki dodawania bramy obszaru roboczego do obszaru roboczego. Aby zapoznać się z opcjami sieci bramy, wymaganiami wstępnymi i szczegółowymi instrukcjami, zobacz Tworzenie obszaru roboczego i zarządzanie nim.
Uwaga
- Brama obszaru roboczego wiąże się z dodatkowymi opłatami. Aby uzyskać więcej informacji, zobacz Cennik usługi API Management.
- Wprowadzamy możliwość skojarzenia wielu obszarów roboczych z bramą obszaru roboczego, pomagając organizacjom zarządzać interfejsami API za pomocą obszarów roboczych po niższych kosztach. Ta funkcja jest wdrażana od grudnia 2024 r. i może nie być dostępna dla wszystkich kwalifikujących się usług przed styczniem. Dowiedz się więcej
- W witrynie Azure Portal przejdź do wystąpienia usługi API Management.
- W menu po lewej stronie w obszarze Interfejsy API wybierz pozycję Obszary robocze.
- Wybieranie obszaru roboczego.
- W menu po lewej stronie w obszarze Wdrażanie i infrastruktura wybierz pozycję Bramy>+ Dodaj.
- Ukończ pracę kreatora, aby utworzyć bramę. Obecnie aprowizowanie bramy może potrwać od kilku minut do 3 godzin lub dłużej.
- Po aprowizacji bramy przejdź do strony Przegląd bramy. Zanotuj wartość nazwy hosta środowiska uruchomieniowego. Użyj tej wartości, aby zaktualizować aplikacje klienckie wywołujące interfejsy API obszaru roboczego.
- Powtórz powyższe kroki dla pozostałych obszarów roboczych.
Aktualizowanie aplikacji klienckich w celu używania nowej nazwy hosta bramy
Po dodaniu bramy do obszaru roboczego należy zaktualizować aplikacje klienckie wywołujące interfejsy API obszaru roboczego, aby użyć nowej nazwy hosta bramy zamiast nazwy hosta bramy wystąpienia usługi API Management.
Uwaga
Aby ułatwić migrację obszarów roboczych, interfejsy API w obszarach roboczych nadal mogą być dostępne w czasie wykonywania do października 2024 r. przy użyciu nazwy hosta bramy wystąpienia usługi API Management, nawet jeśli brama obszaru roboczego jest skojarzona z obszarem roboczym. Zdecydowanie zalecamy ukończenie migracji przed tą datą. Jeśli bramy obszaru roboczego są skonfigurowane z prywatnym dostępem przychodzącym i prywatnym dostępem wychodzącym, upewnij się, że łączność z wbudowaną bramą wystąpienia usługi API Management jest również zabezpieczona.
Aktualizowanie zależności od tożsamości zarządzanych na poziomie usługi
Jeśli używasz tożsamości zarządzanych na poziomie usługi w konfiguracji jednostek obszaru roboczego (na przykład nazwanych wartości lub certyfikatów), musisz zaktualizować konfiguracje. Zalecane kroki różnią się w zależności od jednostki. Przykład: Zaktualizuj nazwane wartości, aby używać wartości wpisów tajnych zamiast wpisów tajnych przechowywanych w usłudze Azure Key Vault.
Pomoc i obsługa techniczna
Jeśli masz pytania, poszukaj odpowiedzi od ekspertów ze społeczności w witrynie Microsoft Q&A. Jeśli masz plan pomocy technicznej i potrzebujesz takiej pomocy, utwórz wniosek o pomoc techniczną.
Więcej informacji
Powiązana zawartość
Zobacz wszystkie nadchodzące zmiany powodujące niezgodność i wycofywanie funkcji.