你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Azure Static Web Apps 中的 API 支持概述

前端 Web 应用程序通常为数据和服务调用后端 API。 Azure Static Web Apps 通过与 Azure 服务集成来提供内置的无服务器 API 终结点。

Azure Static Web Apps API 的主要功能包括:

  • 集成安全性,可直接访问用户身份验证和基于角色的授权数据。

  • 无缝路由,可向前端 Web 应用安全地提供 /api 路由,而无需自定义 CORS 规则。

API 选项

以下 Azure 服务可与 Azure Static Web Apps 集成:

服务 托管 自带
Azure Functions
Azure API 管理
Azure 应用服务
Azure Container Apps
  • 托管 API:默认情况下,Azure Static Web Apps 自动与 Azure Functions 集成,使后者作为 API 后端。 你可使用静态 Web 应用部署 API,而无需管理单独的 Azure Functions 资源。
  • 自带 API:可将静态 Web 应用与 Azure Functions、API 管理、应用服务或容器应用中托管的现有 API 集成。 自行管理和部署 API 资源。

注意

自带 API 只能在 Azure Static Web Apps 标准计划中使用。 内置的托管 Azure Functions API 可在所有 Azure Static Web Apps 计划中使用。

API 约束

以下约束适用于所有 API 后端:

  • 每个静态 Web 应用环境一次只能配置一种后端 API。
  • API 路由前缀必须是 /api
  • API 的路由规则只支持重定向以及使用角色保护路由
  • API 仅支持 HTTP 请求。 例如,不支持 WebSocket。
  • 每个 API 请求的最大持续时间为 45 秒。
  • 不支持网络隔离的后端。

以下约束适用于自带 API 后端:

  • 必须先将应用程序部署到静态 Web 应用,然后才能解析对 /api 路由的请求。
  • 自带 API 后端不能链接到静态 Web 应用拉取请求环境。

后续步骤