Azure Functions 与门户中的 Azure API 管理集成,使你能够将 HTTP 触发器函数终结点公开为 REST API。 这些 API 使用 OpenAPI 定义进行描述。 此 JSON(或 YAML)文件包含有关 API 中可用的作的信息。 它包含有关如何构造 API 的请求和响应数据的详细信息。 通过集成函数应用,可以让 API 管理生成这些 OpenAPI 定义。
本文介绍如何将函数应用与 API 管理集成。 此集成适用于任何 受支持的语言开发的函数应用。 还可以 从 Azure API 管理导入函数应用。
对于 C# 类库函数,还可以 使用 Visual Studio 创建和发布与 API 管理集成的无服务器 API。
创建 API 管理实例
若要创建链接到函数应用的 API 管理实例,请执行以下作:
选择函数应用,从左侧菜单中选择“API 管理”,然后在“API 管理”下选择“新建”。
使用下表中指定的 API 管理设置:
设置 建议值 DESCRIPTION 订阅 你的订阅 创建此新资源的订阅类型。 资源组 我的资源组 与函数应用相同的资源,系统会为你设置。 区域 服务的位置 请考虑选择与你的函数应用相同的位置。 资源名称 全局唯一名称 根据你的函数应用的名称生成一个名称。 组织名称 Contoso 开发人员门户和电子邮件通知中使用的组织的名称。 管理员电子邮件 你的电子邮件 从 API 管理接收了系统通知的电子邮件。 定价层 消费 消费级别不适用于所有地区。 有关完整的定价详细信息,请参阅 API 管理定价页 选择 “查看 + 创建 ”,然后选择 “创建 ”以创建 API 管理实例,这可能需要几分钟时间。
导入函数
创建 API 管理实例后,可以导入 HTTP 触发的函数终结点。 此示例导入名为 TurbineRepair 的终结点。
在“API 管理”页中,选择 “链接 API”。
此时会打开“导入 Azure Functions”,其中突出显示了“TurbineRepair”函数。 选择 “选择” 以继续。
在 “从 Function App 创建 ”页中,接受默认值,然后选择“ 创建”。 Azure 为函数创建 API。
下载 OpenAPI 定义
导入函数后,可以从 API 管理实例下载 OpenAPI 定义。
选择页面顶部的 “下载 OpenAPI 定义 ”。
保存下载的 JSON 文件,然后打开它。 查看定义。
后续步骤
现在,可以在门户上的“API 管理”中优化定义。 还可以详细了解 API 管理。