Azure Static Web Apps での API サポートの概要
フロントエンド Web アプリケーションは、多くの場合、データとサービスのバックエンド API を呼び出します。 Azure Static Web Apps は、Azure サービスとの統合を通じて、組み込みのサーバーレス API エンドポイントを提供します。
Azure Static Web Apps API の主な機能を次に示します。
ユーザー認証とロールベースの承認データに直接アクセスできる統合セキュリティ。
カスタム CORS ルールを必要とせずにバックエンド
/apiルートをフロントエンド Web アプリで使用できるようにするシームレスなルーティング。
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 環境にリンクすることはできません。