Einstellung der API-Verwaltung stv1-Plattform – Globale Azure-Cloud (August 2024)

GILT FÜR: Developer | Basic | Standard | Premium

Als Cloud-Plattform-as-a-Service (PaaS) abstrahiert Azure API Management viele Details der Infrastruktur, die zum Hosten und Ausführen Ihres Dienstes verwendet wird. Die Infrastruktur, die der API Management stv1 Compute Platform-Version zugeordnet ist, wird am 31. August 2024 in der globalen Microsoft Azure-Cloud eingestellt. Eine aktuellere Version der Computeplattform (stv2) ist bereits verfügbar und bietet erweiterte Dienstfunktionen.

In der folgenden Tabelle werden die Computeplattformen zusammengefasst, die derzeit für Instanzen in den verschiedenen API Management-Diensttarifen verwendet werden.

Um weiterhin Unterstützung zu erhalten und bevorstehende Features nutzen zu können, müssen stv2. Die Computeplattform stv2 umfasst zusätzliche Features und Verbesserungen wie Unterstützung für Azure Private Link und andere Netzwerkfeatures.

Neue Instanzen, die in anderen Dienstebenen als im Tarif „Verbrauch“ (Consumption) erstellt wurden, werden bereits vorwiegend auf der Plattform stv2 gehostet. Vorhandene Instanzen auf der stv1 Computeplattform funktionieren weiterhin normal bis zum Deaktivierungsdatum, aber diese Instanzen erhalten nicht die neuesten Features, die für die stv2 Plattform verfügbar sind. Unterstützung für stv1-Instanzen wird am 31. August 2024 eingestellt.

Ist mein Dienst davon betroffen?

Wenn der Wert der platformVersion -Eigenschaft Ihres Diensts stv1 ist, wird er auf der stv1 -Plattform gehostet. Siehe Gewusst wie: Welche Plattform hostet meine API Management-Instanz?.

Wann wird die Änderung vorgenommen?

Unterstützung für API Management-Instanzen, die auf der Plattform stv1 gehostet werden, wird am 31. August 2024 eingestellt.

Was muss ich tun?

Migrieren Sie alle vorhandenen Instanzen, die auf der stv1 Computeplattform gehostet werden, zur stv2 Computeplattform.

Wenn Sie vorhandene Instanzen auf der stv1 -Plattform gehostet haben, folgen Sie unserem Migrationsleitfaden, um eine erfolgreiche Migration sicherzustellen.

Was geschieht nach dem 31. August 2024?

Ihre stv1 Instanz wird nicht heruntergefahren, deaktiviert oder gelöscht. Die SLA-Verpflichtung für die Instanz endet jedoch, und jede stv1 Instanz nach dem Deaktivierungsdatum wird für die automatische Migration auf die stv2 Plattform geplant.

Ende der SLA-Verpflichtung für stv1 Instanzen

Ab dem 1. September 2024 stellt API Management keine Servicelevelgarantien mehr bereit und durch Erweiterungs-Serviceguthaben für Leistungs- oder Verfügbarkeitsprobleme im Zusammenhang mit den auf der stv1 Computeplattform ausgeführten Dienstinstanzen für Entwickler, Basic, Standard und Premium. Außerdem werden in der API-Verwaltungsplattform stv1 keine neuen Sicherheits- und Complianceinvestitionen getätigt.

Durch fortgesetzte Nutzung einer Instanz, die über das Einstellungsdatum hinaus auf der stv1 Plattform gehostet wird, bestätigen Sie, dass Azure für die eingestellten Instanzen keinen Commit für die SLA von 99,95 % übernimmt.

Automatische Migration

Nach dem Einstellungsdatum werden verbleibende stv1- Dienstinstanzen automatisch zur stv2-Computeplattform migriert. Alle betroffenen Kunden werden eine Woche im Voraus über die bevorstehende automatische Migration benachrichtigt. Die automatische Migration kann zu Downtime bei Ihren Upstream-API-Consumern führen. Sie können ihre eigenen Instanzen weiterhin migrieren, bevor die automatische Migration stattfindet.

Die Konfiguration des virtuellen Netzwerks kann während der automatischen Migration entfernt werden.

In den meisten Fällen behält die automatische Migration die Einstellungen des virtuellen Netzwerks Ihrer API-Verwaltungsinstanz bei, wenn sie konfiguriert sind. Unter bestimmten besonderen Bedingungen wird die Konfiguration des virtuellen Netzwerks Ihrer stv1-Dienstinstanz während der automatischen Migration entfernt, und der Zugriff auf Ihre Dienstendpunkte wird als Sicherheitsmaßnahme blockiert. Wenn die Netzwerkeinstellungen während des Migrationsprozesses entfernt wurden, wird im Portal eine Meldung wie die folgende angezeigt: We have blocked access to all endpoints for your service.

Während der Zugriff blockiert ist, ist der Zugriff auf das API-Gateway, das Entwicklerportal, die Direktverwaltungs-API und das Git-Repository deaktiviert.

Wiederherstellen des Zugriffs und der Konfiguration des virtuellen Netzwerks

Wenn der Zugriff blockiert ist, können Sie den Zugriff auf Ihre Dienstendpunkte und Ihre Konfiguration des virtuellen Netzwerks mithilfe des Portals oder der Azure CLI wiederherstellen.

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"
        }
    }
}'

Hilfe und Support

Wir helfen Ihnen bei der Migration zur stv2-Plattform mit minimalen Unterbrechungen für Ihre Dienste.

Bei Fragen können Sie schnelle Antworten von Communityexperten auf Microsoft Q&A erhalten. Wenn Sie über einen Supportplan verfügen und technische Hilfe benötigen, erstellen Sie eine Supportanfrage.

1. Geben Sie als Zusammenfassung eine Beschreibung Ihres Problems ein, z. B. „stv1 Einstellung“.
2. Wählen Sie unter Problemtyp die Option Technisch aus.
3. Wählen Sie im Abschnitt Abonnement Ihr Abonnement aus.
4. Wählen Sie unter Dienst die Option Meine Dienste und dann API Management-Dienst aus.
5. Wählen Sie unter Ressource die Azure-Ressource aus, für die Sie eine Supportanfrage erstellen.
6. Wählen Sie als Problemtyp die Option Administration und Verwaltung aus.
7. Wählen Sie als Problemuntertyp die Option Upgrade, Skalierung oder SKU-Änderungen aus.

Verwandte Inhalte

• Migrieren von stv1-Plattform zu stv2
• Sehen Sie sich alle bevorstehenden Breaking Changes und Funktionseinstellungen an.