Freigeben über

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

  • Artikel

GILT FÜR: Premium

Wichtig

Diese Breaking Changes betreffen nur Vorschauversionen der Arbeitsbereiche in Azure API Management. Wenn Sie Arbeitsbereiche nach dem allgemein verfügbaren Release im August 2024 erstellt haben und Arbeitsbereiche mit Arbeitsbereichsgateways verwenden, sollten Ihre Arbeitsbereiche von diesen Änderungen nicht betroffen sein.

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.

Hinweis

Diese Breaking Changes gelten zusätzlich zu den Breaking Changes vom Juni 2024 für Vorschauarbeitsbereiche, die zuvor angekündigt wurden.

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.

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.

Hinweis

  • Für das Arbeitsbereichsgateway fallen zusätzliche Gebühren an. Weitere Informationen finden Sie unter API Management-Preise.
  • Wir führen die Möglichkeit ein, mehrere Arbeitsbereiche einem Arbeitsbereichsgateway zuzuordnen und Organisationen dabei zu helfen, APIs mit Arbeitsbereichen zu niedrigeren Kosten zu verwalten. Dieses Feature wird ab Dezember 2024 eingeführt und ist möglicherweise nicht für alle geeigneten Dienste vor Januar verfügbar. Weitere Informationen
  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.

Hinweis

Um die Migration Ihrer Arbeitsbereiche zu erleichtern, können Sie bis Oktober 2024 selbst dann weiterhin über den Gateway-Hostnamen Ihrer API Management-Instanz zur Laufzeit auf die APIs in Arbeitsbereichen zugreifen, wenn einem Arbeitsbereich ein Arbeitsbereichsgateway zugeordnet ist. Es wird dringend empfohlen, die Migration vor diesem Datum abzuschließen. Wenn Ihre Arbeitsbereichsgateways mit privatem eingehendem Zugriff und privatem ausgehenden Zugriff konfiguriert sind, stellen Sie sicher, dass auch Verbindungen mit dem integrierten Gateway der API Management-Instanz geschützt sind.

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

Zugehöriger Inhalt

Sehen Sie sich alle bevorstehenden Breaking Changes und Funktionseinstellungen an.