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

Azure Functions HTTP 输出绑定

  • 项目

通过 HTTP 输出绑定响应 HTTP 请求发送者（HTTP 触发器）。 此绑定需要使用 HTTP 触发器，利用此绑定，你可以自定义与触发器请求相关联的响应。

HTTP 触发函数的默认返回值如下：

  • HTTP 204 No Content，在 Functions 2.x 及更高版本中为空主体
  • HTTP 200 OK，在 Functions 1.x 中为空主体

属性

进程内和独立工作进程 C# 库都不需要属性。 C# 脚本改用 function.json 配置文件，如 C# 脚本指南中所述。

不需要返回值属性。 若要了解详情，请参阅使用情况。

批注

在 Java 函数运行时库中，使用 HttpOutput 注释来定义函数返回的默认变量以外的其他输出变量。 此注释支持以下设置：

重要

本文使用选项卡来支持多个版本的 Node.js 编程模型。 v4 模型已正式发布，旨在为 JavaScript 和 TypeScript 开发人员提供更为灵活和直观的体验。 有关 v4 模型工作原理的更多详细信息，请参阅 Azure Functions Node.js 开发人员指南。 要详细了解 v3 和 v4 之间的差异，请参阅迁移指南。

配置

传递给方法“output.http()”的对象“options”当前不支持模型 v4 的任何属性。

配置

下表解释了在 function.json 文件中设置的绑定配置属性。

属性 说明
type 必须设置为 http。
direction 必须设置为 out。
name 在响应的函数代码中使用的变量名称，或者 $return 以使用返回值。

使用情况

若要发送 HTTP 响应，请使用语言标准响应模式。

响应类型取决于 C# 模式：

HTTP 触发的函数返回 HttpResponseData 对象或 Task<HttpResponseData>。 如果应用使用 .NET 独立中的 ASP.NET Core 集成，则应用还可以使用 IActionResult、Task<IActionResult>、HttpResponse 或 Task<HttpResponse>。

对于 Java，请使用 HttpResponseMessage.Builder 来创建对 HTTP 触发器的响应。 若要了解详情，请参阅 HttpRequestMessage 和 HttpResponseMessage。

有关示例响应，请参阅触发器示例。

后续步骤