Freigeben über

Arbeitsbereiche – Unterbrechungsänderungen (Juni 2024)

  • Artikel

GILT FÜR: Developer | Standard | Premium

Nach dem 14. Juni 2024 führen wir im Rahmen unserer Entwicklung von Arbeitsbereichen (Vorschau) in Azure API Management mehrere wichtige Änderungen ein.

Nach dem 14. Juni 2024 funktionieren Ihre darin verwalteten Arbeitsbereiche und APIs möglicherweise nicht mehr, wenn sie weiterhin auf die zu ändernden Funktionen angewiesen sind. 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 Arbeitsbereiche (Vorschau) in Ihrer API-Verwaltungsinstanz konfiguriert haben. Dieses Feature wurde in den Stufen Premium, Standard und Entwickler eingeführt.

Wichtige Änderungen

Überprüfen Sie die folgenden wichtigen Änderungen, um festzustellen, ob Sie Maßnahmen ergreifen müssen:

Wechseln zu unterstützten Dienstebenen

Die folgenden Dienstebenen unterstützen arbeitsbereiche nicht mehr: Standard und Entwickler. Arbeitsbereiche sind in der Premium-Stufe verfügbar.

Die Verfügbarkeit in den v2-Ebenen finden Sie unter Azure API Management v2-Ebenen.

Änderungen an der Unterstützung für das Zuweisen von Entitäten auf Dienstebene in Arbeitsbereichen

Die folgenden Zuordnungen von Arbeitsbereichsentitäten zu Entitäten auf Dienstebene werden nicht mehr unterstützt:

  • Zuweisen von Arbeitsbereich-APIs zu Produkten auf Dienstebene

  • Zuweisen von Arbeitsbereich-APIs zu Tags auf Dienstebene

  • Zuweisen von Arbeitsbereichsprodukten zu Tags auf Dienstebene

  • Zuweisen von Gruppen auf Dienstebene zu Arbeitsbereichsprodukten für Sichtbarkeitssteuerelemente

    Hinweis

    Die integrierten Gäste- und Entwicklergruppen sind weiterhin in Arbeitsbereichen verfügbar.

Änderungen an unterstützten Kontextobjekten

Die folgenden context Objekte werden in Arbeitsbereichsrichtlinien oder in der Richtlinie für alle APIs auf Dienstebene nicht mehr unterstützt:

  • context.Api.Workspace
  • context.Product.Workspace

Das context.Workspace Objekt kann stattdessen verwendet werden.

Hinweis

Sie können weiterhin auf Benutzer von der Dienstebene im Objekt in context Richtlinien auf Arbeitsbereichsebene verweisen.

Wann wird die Änderung vorgenommen?

Die änderungen werden nach dem 14. Juni 2024 eingeführt. Es wird dringend empfohlen, alle erforderlichen Änderungen an der Konfiguration von Arbeitsbereichen vor diesem Datum vorzunehmen.

Wie muss ich vorgehen?

Wenn Ihre Arbeitsbereiche von diesen Änderungen betroffen sind, müssen Sie Ihre Arbeitsbereichskonfigurationen aktualisieren, um sie an die neuen Funktionen auszurichten.

Standardebenenkunden

Wenn Sie Arbeitsbereiche auf der Standardebene verwenden, aktualisieren Sie auf die Premium-Stufe, um weiterhin Arbeitsbereiche zu verwenden.

Entwicklerebenenkunden

Die Entwicklerebene wurde für Einzelbenutzer- oder Einzelteamanwendungsfälle entwickelt. Es ist nicht in der Lage, die Zusammenarbeit mit mehreren Teams mit Arbeitsbereichen aufgrund der eingeschränkten Computerressourcen, des Mangels an SLA und keine Infrastrukturredundanz zu erleichtern. Wenn Sie die Arbeitsbereichsvorschau auf der Entwicklerebene verwenden, können Sie eine der folgenden Optionen auswählen:

  • Aggregieren in einer Premium-Ebene-Instanz

    Beim Upgrade jeder Entwicklerebene auf die Premium-Stufe ist eine Option zum Aggregieren mehrerer Nichtproduktionsumgebungen in einer einzelnen Premium-Ebene-Instanz in Betracht gezogen. Verwenden Sie Arbeitsbereiche auf der Premium-Ebene, um die verschiedenen Umgebungen zu isolieren.

  • Verwenden von Entwicklerebeneninstanzen für die Entwicklung, Migrieren zu Arbeitsbereichen auf Premium-Ebene für die Produktion

    Sie können Entwicklerebeneninstanzen für Entwicklungsumgebungen verwenden. Für höhere Umgebungen können Sie die Konfiguration jedes Diensts auf Entwicklerebene in einen Arbeitsbereich eines Premium-Diensts migrieren, z. B. mithilfe von CI/CD-Pipelines. Bei diesem Ansatz treten bei der Verwaltung der Konfigurationen möglicherweise Probleme oder Konflikte auf.

    Wenn Sie derzeit Arbeitsbereiche in einer Instanz der Entwicklerebene verwenden, können Sie die Arbeitsbereichskonfigurationen ohne Arbeitsbereiche zu einer Instanz der Entwicklerebene migrieren:

    1. Exportieren Sie eine Ressourcen-Manager-Vorlage aus Ihrer API-Verwaltungsinstanz. Sie können die Vorlage aus dem Azure-Portal oder mit anderen Tools exportieren.
    2. Entfernen Sie die folgende Teilzeichenfolge der Ressourcen-ID-Werte: /workspaces/[^/]+
    3. Stellen Sie die Vorlage bereit. Weitere Informationen finden Sie in der Schnellstartanleitung: Erstellen und Bereitstellen von ARM-Vorlagen mithilfe der Azure-Portal.

    Je nach Anwendungsfall müssen Sie möglicherweise andere Konfigurationsänderungen in Ihrer API-Verwaltungsinstanz vornehmen.

Zuweisung von Entitäten auf Arbeitsbereichsebene

Wenn Sie Entitäten auf Arbeitsbereichsebene Entitäten in der Arbeitsbereichsvorschau zugewiesen haben, finden Sie in der folgenden Tabelle Anleitungen zur Migration.

Zuordnung wird nicht mehr unterstützt Empfohlener Migrationsschritt
Zuweisen von Arbeitsbereich-APIs zu Produkten auf Dienstebene Verwenden von Produkten auf Arbeitsbereichsebene
Zuweisen von Arbeitsbereich-APIs oder -Produkten zu Tags auf Dienstebene Verwenden von Tags auf Arbeitsbereichsebene

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.