Udostępnij za pośrednictwem

Wycofywanie wersji interfejsu API (czerwiec 2024 r.)

  • Artykuł

DOTYCZY: Zużycie | Deweloper | Podstawowa | Standardowa | Premium

Usługa Azure API Management używa usługi Azure Resource Manager (ARM) do konfigurowania wystąpień usługi API Management. Wersja interfejsu API jest osadzona w użyciu szablonów opisujących infrastrukturę, narzędzi używanych do konfigurowania usługi oraz programów pisanych do zarządzania usługami Azure API Management.

Od 1 czerwca 2024 r. wszystkie wersje interfejsu API dla usługi Azure API Management przed 2021-08-01 są wycofywane (wyłączone). Wcześniej przekazana data wycofania wynosiła 30 września 2023 r. W dowolnym momencie po 1 czerwca 2024 r. wywołania interfejsu API korzystające z wersji interfejsu API wcześniejszej niż 2021-08-01 mogą zakończyć się niepowodzeniem bez powiadomienia. Nie będzie już można tworzyć usług API Management ani zarządzać nimi przy użyciu istniejących szablonów, narzędzi, skryptów i programów przy użyciu wycofanej wersji interfejsu API, dopóki nie zostaną zaktualizowane do korzystania z interfejsu API w wersji 2021-08-01 lub nowszej. Na operacje płaszczyzny danych (takie jak mediating żądań interfejsu API w bramie) nie będą miały wpływu na tę aktualizację, w tym po 1 czerwca 2024 r.

Czy na moją usługę ma to wpływ?

Chociaż twoja usługa nie ma wpływu na tę zmianę, żadne narzędzie, skrypt lub program korzystający z usługi Azure Resource Manager (na przykład interfejs wiersza polecenia platformy Azure, program Azure PowerShell, zestaw Azure API Management DevOps Resource Kit lub terraform) do interakcji z usługą API Management i wywoływanie wersji interfejsu API Management przed 2021-08-01 mają wpływ na tę zmianę. Po wycofaniu wersji interfejsu API nie będzie można pomyślnie uruchomić żadnych narzędzi, których dotyczy problem, chyba że zaktualizujesz narzędzia.

Jaki jest termin zmiany?

Wersje interfejsu API, których dotyczy problem, zostaną wycofane stopniowo od 1 czerwca 2024 r.

Po wycofaniu wersji interfejsu API, jeśli nie chcesz aktualizować odpowiednich narzędzi, skryptów i programów, usługi będą nadal działać. Nie będzie jednak można dodawać ani usuwać interfejsów API, zmieniać zasad interfejsu API ani w inny sposób konfigurować usługi API Management przy użyciu narzędzi, których dotyczy problem.

Wymagana akcja

Zaktualizuj narzędzia, skrypty i programy, korzystając ze szczegółowych informacji w poniższej sekcji.

Zalecamy również ustawienie minimalnej wersji interfejsu API w wystąpieniu usługi API Management.

Aktualizowanie narzędzi, skryptów i programów

  • Szablony arm, Bicep lub Terraform — zaktualizuj szablon, aby używał interfejsu API w wersji 2021-08-01 lub nowszej.

  • Interfejs wiersza polecenia platformy Azure — uruchom polecenie az version , aby sprawdzić wersję. Jeśli używasz wersji 2.42.0 lub nowszej, nie jest wymagana żadna akcja. az upgrade W razie potrzeby użyj polecenia , aby uaktualnić interfejs wiersza polecenia platformy Azure. Aby uzyskać więcej informacji, zobacz Jak zaktualizować interfejs wiersza polecenia platformy Azure.

  • Azure PowerShell — uruchom polecenie Get-Module -ListAvailable -Name Az , aby sprawdzić wersję. Jeśli używasz wersji 8.1.0 lub nowszej, nie jest wymagana żadna akcja. Użyj polecenia Update-Module -Name Az -Repository PSGallery , aby zaktualizować moduł w razie potrzeby. Aby uzyskać więcej informacji, zobacz Instalowanie modułu Azure Az PowerShell.

  • Inne narzędzia — użyj następujących wersji (lub nowszych):

    • Zestaw zasobów usługi API Management DevOps: 1.0.0
    • Dostawca azurerm narzędzia Terraform: 3.0.0

  • Zestawy SDK platformy Azure — zaktualizuj zestawy SDK usługi Azure API Management do najnowszych wersji lub co najmniej następujących wersji:

    • .NET: wersja 1.1.0
    • Przejdź: 1.0.0
    • Python: 3.0.0
    • JavaScript: 8.0.1
    • Java: 1.0.0-beta3

Aktualizowanie ustawienia minimalnej wersji interfejsu API w wystąpieniu usługi API Management

Zalecamy ustawienie minimalnej wersji interfejsu API dla wystąpienia usługi API Management przy użyciu witryny Azure Portal lub interfejsu API REST lub innych narzędzi. To ustawienie ogranicza wywołania interfejsu API płaszczyzny sterowania do wystąpienia do wersji interfejsu API równej lub nowszej niż ta wartość. Ustawiając tę wartość na 2021-08-01, możesz ocenić wpływ wycofania wersji interfejsu API na narzędzia.

Aby ustawić minimalną wersję interfejsu API w portalu:

  1. W witrynie Azure Portal przejdź do wystąpienia usługi API Management.
  2. W menu po lewej stronie w obszarze Wdrażanie i infrastruktura wybierz pozycję Interfejs API zarządzania.
  3. Wybierz kartę Ustawienia interfejsu API zarządzania.
  4. W obszarze Wymuszaj minimalną wersję interfejsu API wybierz pozycję Tak. Zostanie wyświetlona minimalna wersja interfejsu API.
  5. Wybierz pozycję Zapisz.

Ważne

Jeśli minimalna wersja interfejsu API w portalu jest wyszarana, możesz zaktualizować to ustawienie tylko programowo, na przykład przy użyciu interfejsu API REST lub polecenia az apim update w interfejsie wiersza polecenia platformy Azure.

Więcej informacji

Powiązana zawartość

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