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 开发人员提供更为灵活和直观的体验。 在升级指南中详细了解 v3 和 v4 之间的差异。

配置

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

配置

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

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

使用情况

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

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

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

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

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

后续步骤