Übersicht über die API-Unterstützung in Azure Static Web Apps

  • Artikel

Front-End-Webanwendungen rufen häufig Back-End-APIs für Daten und Dienste auf. Azure Static Web Apps stellt über eine Integration in Azure-Dienste serverlose API-Endpunkte bereit.

Zu den wichtigsten Features von Azure Static Web Apps APIs gehören folgende:

  • Integrierte Sicherheit mit direktem Zugriff auf Benutzerdaten für die Authentifizierung und rollenbasierte Autorisierung

  • Nahtloses Routing, durch das die /api-Back-End-Route ganz ohne benutzerdefinierte CORS-Regeln für die Front-End-Web-App verfügbar gemacht wird.

API-Optionen

Die folgenden Azure-Dienste können in Azure Static Web Apps integriert werden:

Dienst Verwaltet Bring Your Own
Azure-Funktionen ✔ ✔
Azure API Management ✔
Azure App Service ✔
Azure Container Apps ✔
  • Verwaltete APIs: Azure Static Web Apps wird standardmäßig automatisch als API-Back-End in Azure Functions integriert. Sie stellen eine API mit Ihrer statischen Web-App bereit, ohne eine separate Azure Functions-Ressource verwalten zu müssen.
  • Bring Your Own APIs: Sie können Ihre statische Web-App in vorhandene, in Azure Functions, API Management, App Service oder Container Apps gehostete APIs integrieren. Die API-Ressourcen werden von Ihnen selbst verwaltet und bereitgestellt.

Hinweis

„Bring Your Own APIs“ ist nur im Azure Static Web Apps-Standardplan verfügbar. Integrierte, verwaltete Azure Functions-APIs sind in allen Azure Static Web Apps-Plänen verfügbar.

API-Einschränkungen

Die folgenden Einschränkungen gelten für alle API-Back-Ends:

  • Jede statische Web-App-Umgebung kann jeweils nur mit einer Art von Back-End-API konfiguriert werden.
  • Das API-Routenpräfix muss /api sein.
  • Routenregeln für APIs unterstützen nur Umleitungen und das Sichern von Routen mit Rollen.
  • Nur HTTP-Anforderungen werden für APIs unterstützt. WebSocket wird beispielsweise nicht unterstützt.
  • Die max. Dauer jeder API-Anforderung 45 Sekunden.
  • Back-Ends mit Netzwerkisolation werden nicht unterstützt.

Die folgenden Einschränkungen gelten für Bring Your Own API-Back-Ends:

  • Eine Anwendung muss in Ihrer statischen Web-App bereitgestellt werden, bevor Anforderungen an die /api-Route aufgelöst werden können.
  • Bring Your Own API-Back-Ends können nicht mit einer Pull Request-Umgebung von Static Web Apps verknüpft werden.

Nächste Schritte

Hinzufügen einer API zu Azure Static Web Apps (Vorschauversion) mit Azure Functions