Wycofanie platformy stv1 usługi API Management — globalna chmura platformy Azure (sierpień 2024 r.)

DOTYCZY: Developer | Podstawowa | Standardowa | Premia

As a cloud platform-as-a-service (PaaS), Azure API Management abstracts many details of the infrastructure used to host and run your service. Infrastruktura skojarzona z platformą obliczeniową usługi API Management stv1 zostanie wycofana z dnia 31 sierpnia 2024 r. w globalnej chmurze platformy Microsoft Azure. Dostępna jest już bardziej aktualna wersja platformy obliczeniowej (stv2) i zapewnia ulepszone możliwości usługi.

W poniższej tabeli przedstawiono podsumowanie platform obliczeniowych używanych obecnie dla wystąpień w różnych warstwach usługi API Management.

Aby zapewnić ciągłą pomoc techniczną i korzystać z nadchodzących funkcji, klienci muszą migrować swoje wystąpienia usługi Azure API Management z platformy obliczeniowej stv1 do platformy obliczeniowej stv2 . Platforma obliczeniowa zawiera dodatkowe funkcje i ulepszenia, takie jak obsługa stv2 usługi Azure Private Link i inne funkcje sieciowe.

Nowe wystąpienia utworzone w warstwach usług innych niż warstwa Zużycie są już hostowane na stv2 platformie. Istniejące wystąpienia na platformie obliczeniowej stv1 będą nadal działać normalnie do daty wycofania, ale te wystąpienia nie otrzymają najnowszych funkcji dostępnych dla stv2 platformy. Wsparcie dla stv1 wystąpień zostanie wycofane do 31 sierpnia 2024 r.

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

Jeśli wartość platformVersion właściwości usługi to stv1, jest hostowana na stv1 platformie. Zobacz Jak mogę wiedzieć, która platforma hostuje moje wystąpienie usługi API Management?

Jaki jest termin zmiany?

Obsługa wystąpień usługi API Management hostowanych na stv1 platformie zostanie wycofana do 31 sierpnia 2024 r.

Co muszę zrobić?

Przeprowadź migrację wszystkich istniejących wystąpień hostowanych na platformie obliczeniowej stv1 do platformy obliczeniowej stv2 .

Jeśli masz istniejące wystąpienia hostowane na stv1 platformie, postępuj zgodnie z naszym przewodnikiem migracji , aby zapewnić pomyślną migrację.

Co się dzieje po 31 sierpnia 2024 r.?

Wystąpienie stv1 nie zostanie zamknięte, zdezaktywowane ani usunięte. Jednak zobowiązanie UMOWY SLA dla wystąpienia zostanie zakończone, a każde stv1 wystąpienie po dacie wycofania zostanie zaplanowane na automatyczną migrację na platformę stv2 .

Zakończenie zobowiązania umowy SLA dla stv1 wystąpień

Od 1 września 2024 r. usługa API Management nie będzie już zapewniać żadnych gwarancji poziomu usług, a w przypadku problemów z wydajnością lub dostępnością związanych z wystąpieniami usługi Developer, Basic, Standard i Premium uruchomionymi na platformie obliczeniowej stv1 . Ponadto w platformie API Management stv1 nie zostaną wprowadzone żadne nowe inwestycje w zabezpieczenia i zgodność.

Dzięki ciągłemu używaniu wystąpienia hostowanego na stv1 platformie poza datą wycofania potwierdzasz, że platforma Azure nie zobowiązuje się do umowy SLA na 99,95% dla wycofanych wystąpień.

Automatyczna migracja

Po dacie wycofania automatycznie przeprowadzimy migrację pozostałych stv1 wystąpień usługi do platformy obliczeniowej stv2 . Wszyscy klienci, których dotyczy problem, zostaną powiadomieni o nadchodzącej automatycznej migracji z wyprzedzeniem tydzień. Automatyczna migracja może spowodować przestój dla użytkowników nadrzędnego interfejsu API. Możesz nadal migrować własne wystąpienia przed przeprowadzeniem automatycznej migracji.

Konfiguracja sieci wirtualnej może zostać usunięta podczas automatycznej migracji

W większości przypadków automatyczna migracja zachowuje ustawienia sieci wirtualnej wystąpienia usługi API Management, jeśli są skonfigurowane. W pewnych specjalnych warunkach konfiguracja stv1 sieci wirtualnej wystąpienia usługi jest usuwana podczas automatycznej migracji, a jako środek bezpieczeństwa dostęp do punktów końcowych usługi jest blokowany. Jeśli ustawienia sieciowe zostały usunięte podczas procesu migracji, w portalu zostanie wyświetlony komunikat podobny do: We have blocked access to all endpoints for your service.

Gdy dostęp jest zablokowany, dostęp do bramy interfejsu API, portalu dla deweloperów, bezpośredniego interfejsu API zarządzania i repozytorium Git jest wyłączony.

Przywracanie dostępu i konfiguracji sieci wirtualnej

Jeśli dostęp jest zablokowany, możesz przywrócić dostęp do punktów końcowych usługi i konfiguracji sieci wirtualnej przy użyciu portalu lub interfejsu wiersza polecenia platformy Azure.

APIM_NAME={name of your API Management instance}
RG_NAME={name of your resource group}
SUBNET_NAME={name of the subnet where your API Management instance was originally deployed}
VNET_NAME={name of the virtual network where your API Management instance was originally deployed}
VNET_TYPE={external or internal}

# Get resource ID of subnet
SUBNET_ID=$(az network vnet subnet show \
    --resource-group $RG_NAME \
    --name $SUBNET_NAME \
    --vnet-name $VNET_NAME \
    --query id --output tsv)

# Get resource ID of API Management instance
APIM_RESOURCE_ID=$(az apim show \
    --resource-group $RG_NAME --name $APIM_NAME \
    --query id --output tsv)

# Enable access to service endpoints and restore virtual network configuration
az rest --method PATCH --uri "$APIM_RESOURCE_ID?api-version=2024-05-01" --body '{
    "properties": {
        "virtualNetworkType": "'$VNET_TYPE'",
        "virtualNetworkConfiguration": {
            "subnetResourceId": "'$SUBNET_ID'"
        },
        "customProperties": {
            "Microsoft.WindowsAzure.ApiManagement.Service.Disabled": "False"
        }
    }
}'

Pomoc i wsparcie

Jesteśmy tutaj, aby pomóc Ci przeprowadzić migrację na platformę stv2 z minimalnymi zakłóceniami w Twoich usługach.

Jeśli masz pytania, uzyskaj szybkie odpowiedzi od ekspertów społeczności w usłudze Microsoft Q&A. Jeśli masz plan pomocy technicznej i potrzebujesz takiej pomocy, utwórz wniosek o pomoc techniczną.

1. W obszarze Podsumowanie wpisz opis problemu, na przykład "stv1 retirement".
2. Pod Typ zgłoszenia problemu, wybierz Techniczne.
3. W obszarze Subskrypcja wybierz swoją subskrypcję.
4. W obszarze Usługa wybierz pozycję Moje usługi, a następnie wybierz pozycję Usługa API Management.
5. W obszarze Zasób wybierz zasób platformy Azure, dla którego tworzysz wniosek o pomoc techniczną.
6. W polu Typ problemu wybierz pozycję Administracja i zarządzanie.
7. W obszarze Podtyp problemu wybierz pozycję Uaktualnij, Skaluj lub Zmiany jednostki SKU.

Powiązana treść

• Migrowanie z platformy stv1 do wersji stv2
• Zobacz wszystkie nadchodzące zmiany powodujące niezgodność i wycofywanie funkcji.