Übersicht über die API-Unterstützung in Azure Static Web Apps
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
/apisein. - 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.