Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Front-End-Webanwendungen rufen häufig Back-End-APIs für Daten und Dienste auf. Standardmäßig stellt Azure Static Web Apps integrierte serverlose API-Endpunkte über Azure Functions bereit.
Azure Functions APIs in Static Web Apps sind in zwei möglichen Konfigurationen verfügbar, je nach hosting-Plan:
Managed functions: Standardmäßig handelt es sich bei der API einer statischen Web-App um eine von Azure Static Web Apps verwaltete Azure Functions Anwendung, die mit einigen Einschränkungen verknüpft ist.
Bring Ihrer eigenen Funktionen: Optional können Sie eine vorhandene Azure Functions Anwendung providieren eines beliebigen Plantyps, der alle Features von Azure Functions enthält. Mit dieser Konfiguration sind Sie dafür verantwortlich, eine separate Bereitstellung für die Functions-App zu verarbeiten.
Die folgende Tabelle vergleicht die Unterschiede zwischen der Verwendung verwalteter und vorhandener Funktionen.
| Funktion | Verwaltete Funktionen | Eigene Funktionen mitbringen |
|---|---|---|
| Zugriff auf Azure Functions Trigger und Bindungen | Nur HTTP | Alle |
| Unterstützt Azure Functions runtimes1 | Weitere Informationen finden Sie unter Unterstützte Sprachen und Runtimes. | Alle |
| Unterstützte Azure Functions Hostingpläne | Verbrauch | Verbrauch Premium Dediziert |
| Integrierte Sicherheit mit direktem Zugriff auf Benutzerdaten für die Authentifizierung und rollenbasierte Autorisierung | ✔ | ✔ |
Routingintegration, durch die die /api-Route ganz ohne benutzerdefinierte CORS-Regeln auf sichere Weise für die Web-App verfügbar gemacht wird. |
✔ | ✔ |
| Durable Functions-Programmiermodell | ✕ | ✔ |
| Verwaltete Identität | ✕ | ✔ |
| Azure App Service Authentifizierung und Autorisierung Tokenverwaltung | ✕ | ✔ |
| API-Funktionen außerhalb Azure Static Web Apps | ✕ | ✔ |
| Key Vault Referenzen | ✕ | ✔ |
1 Um die Laufzeitversion in verwalteten Funktionen anzugeben, fügen Sie Ihrer Front-End-App eine Konfigurationsdatei hinzu, und legen Sie die apiRuntime-Eigenschaft fest. Der Support unterliegt der Azure Functions-Richtlinie für die Sprachlaufzeitunterstützung.
API-Optionen für Static Web Apps umfassen die folgenden Azure Dienste:
Weitere Informationen finden Sie in der Übersicht über APIs.
Konfiguration
API-Endpunkte sind für die Web-App über die api-Route verfügbar.
| Verwaltete Funktionen | Eigene Funktionen mitbringen |
|---|---|
Während die /api-Route festgelegt ist, haben Sie die Kontrolle über den Quellcode-Ordnerspeicherort der verwalteten Funktions-App. Dieser Ort kann durch Bearbeiten der YAML-Datei des Workflows geändert werden, die sich im Ordner .github/workflows Ihres Repositorys befindet. |
Anforderungen an die route /api werden an Ihre vorhandene Azure Functions App gesendet. |
Problembehandlung und Protokolle
Protokolle sind nur verfügbar, wenn Sie Application Insights hinzufügen.
| Verwaltete Funktionen | Eigene Funktionen mitbringen |
|---|---|
| Aktivieren Sie die Protokollierung, indem Sie Application Insights für Ihre statische Web-App aktivieren. | Aktivieren Sie die Protokollierung, indem Sie Application Insights für Ihre Azure Functions-App aktivieren. |
Einschränkungen
Zusätzlich zu den Static Web Apps API constraints gelten die folgenden Einschränkungen auch für Azure Functions APIs:
| Verwaltete Funktionen | Eigene Funktionen mitbringen |
|---|---|
|
|