Azure Static Web Apps での API サポートの概要
フロントエンド Web アプリケーションは、多くの場合、データとサービスのバックエンド API を呼び出します。 Azure Static Web Apps は、Azure サービスとの統合を通じて、組み込みのサーバーレス API エンドポイントを提供します。
Azure Static Web Apps API の主な機能を次に示します。
ユーザー認証とロールベースの承認データに直接アクセスできる統合セキュリティ。
カスタム CORS ルールを必要とせずに、フロントエンド Web アプリで
/apiルートを使用できるようにするシームレスなルーティング。
API オプション
次の Azure サービスを Azure Static Web Apps と統合できます。
| サービス | マネージド | 独自のものを使用する |
|---|---|---|
| Azure Functions | ✔ | ✔ |
| Azure API Management | ✔ | |
| Azure App Service | ✔ | |
| Azure Container Apps | ✔ |
- マネージド API: 既定では、Azure Static Web Apps は API バックエンドとして Azure Functions と自動的に統合されます。 個別の Azure Functions リソースを管理せずに、静的 Web アプリを使用して API をデプロイします。
- 独自の API を使用する: 静的 Web アプリを、Azure Functions、API Management、App Service、または Container Apps でホストされている既存の API と統合できます。 API リソースは自分で管理およびデプロイします。
注意
独自の API は、Azure Static Web Apps の Standard プランでのみ使用できます。 組み込みのマネージド Azure Functions API は、すべての Azure Static Web Apps プランで使用できます。
API 制約
すべての API バックエンドには、次の制約が適用されます。
- 各静的 Web アプリ環境には、一度に 1 種類のバックエンド API のみ構成できます。
- API ルートのプレフィックスは、
/apiである必要があります。 - API のルート規則では、リダイレクトとロールによるルートのセキュリティ保護のみがサポートされます。
- API では HTTP 要求のみがサポートされています。 たとえば、WebSocket はサポートされていません。
- 各 API 要求の最大期間は 45 秒です。
- ネットワーク分離型のバックエンドはサポートされていません。
Bring your Own API バックエンドには、以下の制約が適用されます。
/apiルートへの要求を解決する前に、アプリケーションを静的 Web アプリにデプロイする必要があります。- Bring your own API バックエンドを、Static Web Apps の pull request 環境にリンクすることはできません。