Breaking Changes für Arbeitsbereiche, Teil 2 (März 2025)

GILT FÜR: Premium

Azure API Management-Arbeitsbereiche sind jetzt allgemein verfügbar, und wir haben mit dieser Version einige Featureupdates eingeführt. Im Rahmen unserer kontinuierlichen Entwicklung von Arbeitsbereichen entfernen wir den Support für Vorschauarbeitsbereiche (die vor dem August 2024 erstellt wurden). Wenn Sie Vorschauarbeitsbereiche in Azure API Management erstellt haben und diese weiterhin verwenden möchten, müssen Sie die Arbeitsbereiche zur allgemein verfügbaren Version migrieren.

Nach dem 31. März 2025 funktionieren Ihre Vorschauarbeitsbereiche und die darin verwalteten APIs möglicherweise nicht mehr, wenn Sie nicht zu den neuesten Arbeitsbereichsfunktionen migriert wurden. APIs und Ressourcen, die außerhalb von Arbeitsbereichen verwaltet werden, sind von dieser Änderung nicht betroffen.

Ist mein Dienst von diesen Änderungen betroffen?

Ihr Dienst kann von diesen Änderungen betroffen sein, wenn Sie Vorschauarbeitsbereiche in Ihrer API Management-Instanz erstellt haben, bevor der allgemein verfügbare Release von Arbeitsbereichen im August 2024 verfügbar war. Arbeitsbereiche, die nach dem Freigabedatum der allgemein verfügbaren Version erstellt wurden und Arbeitsbereichsgateways für die API-Laufzeit verwendet, sind von den Breaking Changes nicht betroffen.

Wichtige Änderungen

Die folgenden Breaking Changes erfordern, dass Sie Maßnahmen ergreifen, um Ihre Vorschauarbeitsbereiche zur allgemein verfügbaren Version zu migrieren:

• Ein Arbeitsbereichs-API-Gateway ist erforderlich – Jeder Arbeitsbereich muss einem Arbeitsbereichs-API-Gateway zugeordnet sein, das den Laufzeitdatenverkehr des Arbeitsbereichs isoliert. In der Vorschau haben Arbeitsbereiche ein Gateway für den Dienst gemeinsam genutzt.
• Auf Dienstebene verwaltete Identitäten werden nicht unterstützt – Um die Sicherheit von Arbeitsbereichen zu verbessern, können auf Dienstebene aktivierte systemseitig und benutzerseitig zugewiesene verwaltete Identitäten nicht in Arbeitsbereichen verwendet werden. Derzeit werden verwandte API Management-Features, die sich auf verwaltete Identitäten stützen, z. B. das Speichern von benannten Werten und Zertifikaten in Azure Key Vault und die Verwendung der authentication-managed-identity-Richtlinie, in Arbeitsbereichen nicht unterstützt.

Wann wird die Änderung vorgenommen?

Die Breaking Changes werden nach dem 31. März 2025 in Vorschauarbeitsbereichen erzwungen. Es wird dringend empfohlen, vor diesem Datum alle erforderlichen Änderungen an der Konfiguration Ihrer Vorschauarbeitsbereiche vorzunehmen.

Wie muss ich vorgehen?

Wenn Ihre Arbeitsbereiche von diesen Änderungen betroffen sind, müssen Sie Ihre Arbeitsbereiche migrieren, um sie an die allgemein verfügbaren Funktionen anzupassen. In den folgenden Abschnitten finden Sie Anleitungen zum Migrieren Ihrer Arbeitsbereiche.

Verwenden der Premium-Ebene für Ihre API Management-Instanz

Stellen Sie sicher, dass Ihre API Management-Instanz auf der Premium-Ebene ausgeführt wird, um weiterhin Arbeitsbereiche verwenden zu können. Wie zuvor bereits angekündigt, müssen Sie ein Upgrade auf die Dienstebene Premium durchführen, wenn Sie für Ihre Instanz die Dienstebene Standard oder Entwickler nutzen.

Bestätigen der Region Ihrer Instanz

Wenn einem Arbeitsbereich ein Arbeitsbereichsgateways hinzugefügt wird, muss sich das Gateway in derselben Region wie Ihre Instanz befinden. Derzeit werden Arbeitsbereichsgateways in einer Teilmenge von Regionen unterstützt, in denen API Management verfügbar ist. Die Regionen, in denen Arbeitsbereichsgateways unterstützt werden, werden im Laufe der Zeit aktualisiert.

So ermitteln Sie, ob sich ein Vorschauarbeitsbereich in einer unterstützten Region befindet:

1. Navigieren Sie im Azure-Portal zu Ihrer API Management-Instanz.
2. Wählen Sie im linken Menü unter APIs die Option Arbeitsbereiche und dann einen Arbeitsbereich aus.
3. Wenn sich Ihr Arbeitsbereich in einer Region befindet, in der Arbeitsbereichsgateways nicht unterstützt werden, wird im Portal eine Meldung wie „Arbeitsbereiche sind derzeit in der Region Ihres API Management-Dienstes nicht verfügbar“ angezeigt.
   • Wenn diese Meldung angezeigt wird, können Sie Ihre API Management-Instanz in eine unterstützte Region verschieben.
   • Wird diese Meldung nicht angezeigt, dann befindet sich Ihr Arbeitsbereich in einer unterstützten Region, und Sie können mit dem Hinzufügen eines Arbeitsbereichsgateways fortfahren.

Hinzufügen eines Arbeitsbereichsgateways zu Ihrem Arbeitsbereich

Im Folgenden werden die Schritte zum Hinzufügen eines Arbeitsbereichsgateways zu einem Arbeitsbereich verkürzt dargestellt. Informationen zu Gateway-Netzwerkoptionen, Voraussetzungen und eine detaillierte Anleitung finden Sie unter Erstellen und Verwalten eines Arbeitsbereichs.

1. Navigieren Sie im Azure-Portal zu Ihrer API Management-Instanz.
2. Wählen Sie im linken Menü unter APIs die Option Arbeitsbereiche aus.
3. Wählen Sie einen Arbeitsbereich aus.
4. Wählen Sie im Menü unter Bereitstellung und Infrastruktur die Option Gateways>+ Hinzufügen aus.
5. Schließen Sie den Assistenten ab, um ein Gateway zu erstellen. Derzeit kann die Bereitstellung des Gateways mehrere Minuten bis zu 3 Stunden oder mehr in Anspruch nehmen.
6. Wechseln Sie nach der Bereitstellung Ihres Gateways zur Seite Übersicht des Gateways. Notieren Sie sich den Wert des Felds Runtime-Hostname. Verwenden Sie diesen Wert, um die Client-Apps, die die APIs Ihres Arbeitsbereichs aufrufen, zu aktualisieren.
7. Wiederholen Sie die obigen Schritte für Ihre restlichen Arbeitsbereiche.

Aktualisieren von Client-Apps für die Verwendung des neuen Gatewayhosts

Nachdem Sie Ihrem Arbeitsbereich ein Gateway hinzugefügt haben, müssen Sie Ihre Client-Apps, die die APIs des Arbeitsbereichs aufrufen, aktualisieren, damit sie den neuen Gateway-Hostnamen anstelle des Gateway-Hostnamens Ihrer API Management-Instanz verwenden.

Aktualisieren der Abhängigkeiten von verwalteten Identitäten auf Dienstebene

Wenn Sie auf Dienstebene verwaltete Identitäten in der Konfiguration von Arbeitsbereichsentitäten verwenden (z. B. benannte Werte oder Zertifikate), müssen Sie die Konfigurationen aktualisieren. Die empfohlenen Schritte variieren je nach Entität. Beispiel: Aktualisieren Sie benannte Werte so, dass geheime Werte anstelle von geheimen Schlüsseln verwendet werden, die in Azure Key Vault gespeichert sind.

Hilfe und Support

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

Weitere Informationen

• Übersicht über Arbeitsbereiche
• Breaking Changes für Arbeitsbereiche (Juni 2024)

Zugehöriger Inhalt

Sehen Sie sich alle bevorstehenden Breaking Changes und Funktionseinstellungen an.