Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
DOTYCZY: Premium
Ważne
Te istotne zmiany dotyczą tylko obszarów roboczych w wersji zapoznawczej w usłudze Azure API Management. Jeśli utworzono obszary robocze po wersji ogólnodostępnej wydanej w sierpniu 2024 r. i korzystasz z obszarów roboczych z bramami, te zmiany nie powinny mieć wpływu na te 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. Interfejsy API i zasoby zarządzane poza obszarami roboczymi nie są dotknięte tą zmianą.
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 łamiące zgodność
Poniżej przedstawiono istotne zmiany, które wymagają działania, aby przeprowadzić migrację obszarów roboczych z wersji zapoznawczej do wersji ogólnie dostępnej.
- 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 współdzieliły bramę z usługą.
-
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, takie jak przechowywanie nazwanych wartości i certyfikatów w usłudze Azure Key Vault oraz korzystanie z polityki
authentication-managed-identity
, nie są obsługiwane w środowiskach pracy.
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 instancja API Management działa w warstwie Premium, aby kontynuować korzystanie z obszarów roboczych. Jak ogłoszono wcześniej, jeśli twoja instancja znajduje się na poziomie Standard lub Developer, musisz przejść na poziom Premium.
Potwierdź region dla swojej instancji
Dodanie bramy do obszaru roboczego wymaga, aby brama znajdowała się w tym samym regionie co Twoje 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 obsługujące bramy obszarów roboczych zostaną zaktualizowane z czasem.
Aby określić, czy obszar roboczy w wersji zapoznawczej znajduje się w obsługiwanym regionie:
- W portalu Azure, przejdź do sekcji zarządzania wystąpieniem API.
- 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ść instancję zarządzania interfejsem API 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.
Dodaj bramę obszaru roboczego do swojego obszaru roboczego
Poniżej przedstawiono skrócone kroki dodawania bramy 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ść łączenia wielu przestrzeni roboczych z bramą przestrzeni roboczych, co pozwala organizacjom efektywniej zarządzać interfejsami API i obniżać koszty zarządzania. 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 portalu Azure, przejdź do sekcji zarządzania wystąpieniem API.
- 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 kreatora, aby utworzyć nową bramę lub powiązać istniejącą bramę. Obecnie aprowizowanie nowej bramy może potrwać od kilku minut do 3 godzin lub dłużej.
- Po dodaniu 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.
Zaktualizuj aplikacje klienckie, aby używać nowej nazwy hosta bramy.
Po dodaniu bramy do obszaru roboczego, należy zaktualizować aplikacje klienckie, które wywołują interfejsy API tego obszaru roboczego, aby używały nowej nazwy hosta bramy, zamiast nazwy hosta bramy dla wystąpienia zarządzania API.
Uwaga
Aby ułatwić migrację obszarów roboczych, interfejsy API w obszarach roboczych nadal mogą być dostępne podczas działania do października 2024 r. przy użyciu nazwy hosta bramy wystąpienia systemu zarządzania API, nawet jeśli brama dla 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ć tajnych wartości zamiast tajemnic 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.