Obszary robocze — zmiany powodujące niezgodność (czerwiec 2024 r.)

DOTYCZY: Developer | Standardowa | Premium

Po 14 czerwca 2024 r. w ramach tworzenia obszarów roboczych (wersja zapoznawcza) w usłudze Azure API Management wprowadzamy kilka zmian powodujących niezgodność.

Po 14 czerwca 2024 r. obszary robocze i interfejsy API zarządzane w nich mogą przestać działać, jeśli nadal korzystają z możliwości ustawionych na zmianę. 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 skonfigurowano obszary robocze (wersja zapoznawcza) w wystąpieniu usługi API Management. Ta funkcja została wprowadzona w warstwach Premium, Standardowa i Developer .

Zmiany powodujące niezgodność

Przejrzyj następujące zmiany powodujące niezgodność, aby określić, czy chcesz podjąć działania:

Zmiana na obsługiwane warstwy usług

Następujące warstwy usług nie będą już obsługiwać obszarów roboczych: Standardowa i Deweloper. Obszary robocze będą dostępne w warstwie Premium .

Aby uzyskać informacje o dostępności w warstwach w wersji 2, zobacz Warstwy usługi Azure API Management w wersji 2.

Zmiany obsługi przypisywania jednostek na poziomie usługi w obszarach roboczych

Następujące przypisania jednostek obszaru roboczego do jednostek na poziomie usługi nie będą już obsługiwane:

  • Przypisywanie interfejsów API obszaru roboczego do produktów na poziomie usługi

  • Przypisywanie interfejsów API obszaru roboczego do tagów na poziomie usługi

  • Przypisywanie produktów obszaru roboczego do tagów na poziomie usługi

  • Przypisywanie grup na poziomie usługi do produktów obszaru roboczego na potrzeby kontroli widoczności

    Uwaga

    Wbudowane grupy gości i deweloperów będą nadal dostępne w obszarach roboczych.

Zmiany w obsługiwanych obiektach kontekstu

Następujące context obiekty nie będą już obsługiwane w zasadach obszaru roboczego ani w zasadach wszystkich interfejsów API na poziomie usługi:

  • context.Api.Workspace
  • context.Product.Workspace

context.Workspace Zamiast tego można użyć obiektu.

Uwaga

Możesz nadal odwoływać się do użytkowników z poziomu usługi w obiekcie w context zasadach na poziomie obszaru roboczego.

Jaki jest termin zmiany?

Zmiany powodujące niezgodność zostaną wprowadzone po 14 czerwca 2024 r. Zdecydowanie zalecamy wprowadzenie wszystkich wymaganych zmian w konfiguracji obszarów roboczych przed tą datą.

Co należy zrobić?

Jeśli te zmiany mają wpływ na twoje obszary robocze, należy zaktualizować konfiguracje obszaru roboczego, aby dostosować je do nowych możliwości.

Klienci w warstwie Standardowa

Jeśli używasz obszarów roboczych w warstwie Standardowa, przejdź do warstwy Premium, aby kontynuować korzystanie z obszarów roboczych.

Klienci warstwy deweloperów

Warstwa Deweloper została zaprojektowana dla przypadków użycia pojedynczego użytkownika lub jednego zespołu. Nie jest w stanie ułatwić współpracy obejmującej wiele zespołów z obszarami roboczymi ze względu na ograniczone zasoby obliczeniowe, brak umowy SLA i brak nadmiarowości infrastruktury. Jeśli używasz wersji zapoznawczej obszarów roboczych w warstwie Deweloper , możesz wybrać jedną z następujących opcji:

  • Agregowanie w wystąpieniu warstwy Premium

    Podczas uaktualniania każdego wystąpienia warstwy dewelopera do warstwy Premium jest opcją, rozważ agregowanie wielu środowisk nieprodukcyjnych w jednym wystąpieniu warstwy Premium. Użyj obszarów roboczych w warstwie Premium, aby odizolować różne środowiska.

  • Używanie wystąpień warstwy deweloperów na potrzeby programowania, migrowanie do obszarów roboczych w warstwie Premium na potrzeby środowiska produkcyjnego

    Możesz użyć wystąpień warstwy dewelopera dla środowisk deweloperskich. W przypadku wyższych środowisk można migrować konfigurację każdej usługi warstwy dewelopera do obszaru roboczego usługi warstwy Premium, na przykład przy użyciu potoków ciągłej integracji/ciągłego wdrażania. W przypadku tego podejścia mogą wystąpić problemy lub konflikty podczas zarządzania konfiguracjami w różnych środowiskach.

    Jeśli obecnie używasz obszarów roboczych w wystąpieniu warstwy dewelopera, możesz przeprowadzić migrację konfiguracji obszaru roboczego do wystąpienia warstwy Deweloper bez obszarów roboczych:

    1. Wyeksportuj szablon usługi Resource Manager z wystąpienia usługi API Management. Szablon można wyeksportować z witryny Azure Portal lub przy użyciu innych narzędzi.
    2. Usuń następujące podciąganie wartości identyfikatora zasobu: /workspaces/[^/]+
    3. Wdrażanie szablonu. Aby uzyskać więcej informacji, zobacz Szybki start: tworzenie i wdrażanie szablonów usługi ARM przy użyciu witryny Azure Portal.

    W zależności od przypadku użycia może być konieczne wykonanie innych zmian konfiguracji w wystąpieniu usługi API Management.

Przypisywanie jednostek na poziomie obszaru roboczego

Jeśli przypisano jednostki na poziomie obszaru roboczego do jednostek na poziomie usługi w wersji zapoznawczej obszarów roboczych, zapoznaj się z poniższą tabelą, aby uzyskać wskazówki dotyczące migracji.

Przypisanie nie jest już obsługiwane Zalecany krok migracji
Przypisywanie interfejsów API obszaru roboczego do produktów na poziomie usługi Korzystanie z produktów na poziomie obszaru roboczego
Przypisywanie interfejsów API lub produktów obszaru roboczego do tagów na poziomie usługi Używanie tagów na poziomie obszaru roboczego

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

Zobacz wszystkie nadchodzące zmiany powodujące niezgodność i wycofywanie funkcji.