在门户中使用 Azure Functions 创建 HTTP 接口

Azure Functions 用于在无服务器环境中运行代码,无需先创建虚拟机 (VM) 或发布 Web 应用程序。 本文介绍如何使用 Azure Functions 在 Azure 门户中创建 HTTP 触发器函数“hello world”。

在文章顶部选择首选的编程语言。

注释

目前,仅 C# 脚本 (.csx) 函数支持在 Azure 门户中编辑 C# 函数代码。 若要详细了解在 Azure 门户中编辑函数代码的限制,请参阅 Azure 门户中的开发限制

应改为在本地开发函数,然后发布到 Azure 中的函数应用。 通过以下链接之一开始使用所选的本地开发环境:

注释

目前不支持在 Azure 门户中编辑 Java 函数代码。 有关详细信息,请参阅 Azure 门户中的开发限制

应改为在本地开发函数,然后发布到 Azure 中的函数应用。 通过以下链接之一开始使用所选的本地开发环境:

注释

由于 Azure 门户中的开发限制,因此应改为在本地开发函数,然后发布到 Azure 中的函数应用。 通过以下链接之一开始使用所选的本地开发环境:

注释

由于 Azure 门户中的开发限制,因此应改为在本地开发函数,然后发布到 Azure 中的函数应用。 通过以下链接之一开始使用所选的本地开发环境:

注释

目前不支持在 Azure 门户中编辑 TypeScript 函数代码。 有关详细信息,请参阅 Azure 门户中的开发限制

应改为在本地开发函数,然后发布到 Azure 中的函数应用。 通过以下链接之一开始使用所选的本地开发环境:

注释

由于 Azure 门户中的开发限制,因此应改为在本地开发函数,然后发布到 Azure 中的函数应用。 通过以下链接之一开始使用所选的本地开发环境:

请查看在 Azure 门户中使用 Python 开发 Azure Functions 的已知问题

先决条件

如果您还没有 Azure 试用订阅,请在开始之前创建一个试用订阅。

登录到 Azure

使用 Azure 帐户登录到 Azure 门户

创建函数应用

您必须拥有一个Function App来托管您的函数的执行。 函数应用可将函数分组为逻辑单元,以便更轻松地管理、部署、缩放和共享资源。

使用以下步骤创建函数应用和相关 Azure 资源,无论是否能够在 Azure 门户中编辑代码。

为了能够创建可在门户中编辑的 C# 脚本应用,请为 .NET 版本选择 8 (LTS) 进程内模型

  1. 在 Azure 门户菜单上或在门户主页中,选择“创建资源”。

  2. 在“新建”页面上,选择“计算”“函数应用”>

  3. 基本信息页面上,根据下表中的说明使用函数应用程序设置:

    设置 建议值 DESCRIPTION
    订阅 你的订阅 将在其中创建新函数应用的订阅。
    资源组 myResourceGroup 将在其中创建函数应用的新资源组的名称。 你需要创建新的资源组,因为在现有资源组中创建新函数应用时存在已知限制
    函数应用名称 全局唯一名称 用于标识您的新函数应用程序的名称。 有效字符为 a-z(不区分大小写)、0-9-
    发布 代码 用于发布代码文件或 Docker 容器的选项。
    运行时堆栈 首选语言 选择支持你喜欢的函数编程语言的运行时。 门户中编辑仅适用于 JavaScript、PowerShell、TypeScript 和 C# 脚本。 C# 类库、Java 和 Python 函数必须在本地开发
    版本 版本号 选择已安装的运行时的版本。
    区域 首选区域 选择一个靠近你或靠近函数可以访问的其他服务 的区域
  4. 选择“下一步: 托管”。 在“托管”页面上,输入以下设置:

    设置 建议值 DESCRIPTION
    存储帐户 全局唯一名称 创建函数应用使用的存储帐户。 存储帐户名称必须为 3 到 24 个字符,并且只能包含数字和小写字母。 也可使用现有帐户,但该帐户必须符合存储帐户要求
    操作系统 Windows操作系统 系统会根据你的运行时堆栈选择为你预先选择一个操作系统,但你可以根据需要更改该设置。 仅在 Windows 上支持门户内编辑。
    计划 消耗(无服务器) 定义如何将资源分配给函数应用的托管计划。 在默认的消耗计划中,根据函数需求动态添加资源。 在此无服务器托管中,只需为函数运行时间付费。 按应用服务计划运行时,必须管理函数应用的扩展
  5. 选择 “下一步:监视”。 在“监控”页面上,输入以下设置:

    设置 建议值 DESCRIPTION
    Application Insights 违约 在最近的受支持的区域中,创建一个具有相同应用名称的 Application Insights 资源。 通过展开此设置或选择“新建”,可以更改 Application Insights 名称或在 Azure 地理位置中选择要存储数据的其他区域。
  6. 选择“查看 + 创建”,以便查看应用配置选择。

  7. 在“查看 + 创建”页上查看设置,然后选择“创建”来预配并部署函数应用 。

  8. 选择门户右上角的“通知”图标,留意是否显示了“部署成功”消息。

  9. 选择转到资源以查看您的新函数应用程序。 还可选择“固定到仪表板”。 固定可以更轻松地从仪表板返回此函数应用资源。

    部署通知的屏幕截图。

接下来,在新的函数应用中创建一个函数。

创建 HTTP 触发器函数

  1. 在函数应用中,选择“概述”,然后在“函数”下选择“+ 创建”。 如果未看到 “+ 创建 ”按钮,则必须改为 在本地创建函数

  2. 在“选择模板”下,向下滚动并选择“HTTP 触发器”模板

  3. 在“模板详细信息”中,为“新建函数”使用 ,从HttpExample下拉列表中选择“匿名”,然后选择“创建”

    Azure 会创建该 HTTP 触发器函数。 现在,可以通过发送 HTTP 请求来运行新函数了。

在本地创建函数

如果无法在门户中创建函数代码,可以改为创建本地项目,然后将函数代码发布到新的函数应用。

  1. 在函数应用中,选择“概述”,然后选择“函数”下的“在首选环境中创建函数”

  2. 选择首选的本地开发环境,并按照链接文章中的步骤创建并发布第一个 Azure Functions 项目。

    小窍门

    发布新项目时,请确保使用刚创建的函数应用和相关资源。

测试函数

小窍门

即使对于无法在门户中编辑的只读函数,门户中的“代码 + 测试”功能也有效。

  1. 在您的新函数应用的概述页面中,在函数选项卡中选择新的 HTTP 触发函数。

  2. 在左侧菜单中,展开“开发人员”,选择“代码 + 测试”,然后选择“测试/运行”

  3. 在“测试/运行”对话框中,选择“运行”。

    HTTP POST 请求将发送到新函数,其有效负载包含 nameAzure 值。 还可以通过选择 GET 作为 HTTP 方法并添加一个值为 参数来测试函数nameYOUR_NAME

    小窍门

    若要在外部浏览器中进行测试,请改为选择“获取函数 URL”,复制“默认(函数密钥)”值,将查询字符串值 添加到此 URL 的末尾,然后在 Web 浏览器的地址栏中提交此 URL&name=<YOUR_NAME>

  4. 运行函数时,会在日志中写入跟踪信息。 若要查看跟踪输出,请返回到门户中的“代码 + 测试”页,并展开页面底部的“日志”箭头。 再次调用函数,以查看日志中的跟踪输出。

清理资源

本教程系列中的其他快速入门教程是在本文的基础上制作的。 如果您计划使用接下来的快速入门、教程或您在本快速入门中创建的任何服务,请不要清理这些资源。

Azure 中的资源是指函数应用、函数、存储帐户等。 这些资源可以组合到资源组中,删除该组即可删除组中的所有内容。

你已创建完成这些快速入门所需的资源。 这些资源可能需要付费,具体取决于帐户状态服务定价。 如果不再需要这些资源,请参阅下面介绍的资源删除方法:

  1. 在 Azure 门户中转到“资源组”页。

    若要从函数应用页转到该页,请选择“概览”选项卡,然后选择“资源组”下的链接。

    屏幕截图,显示如何从函数应用页选择要删除的资源组。

    若要从仪表板转到该页,请选择“资源组”,然后选择用于本文的资源组。

  2. 在“资源组”页中查看所包括的资源的列表,然后验证这些资源是否是要删除的。

  3. 选择“删除资源组”,然后按说明操作。

    删除操作可能需要几分钟。 完成后会显示一个通知,持续数秒。 也可以选择页面顶部的钟形图标来查看通知。

后续步骤

现在,你已创建了第一个函数,让我们向该函数添加输出绑定,以便将消息写入存储队列。