Azure Functions HTTP 输出绑定

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

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

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

属性

使用 HttpResponseData 时不需要返回值属性。 但是,使用 ASP.NET Core 集成多重绑定输出对象时,应将 [HttpResultAttribute] 属性应用于对象属性。 该属性不采用任何参数。 若要了解详情,请参阅使用情况

批注

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

重要

本文使用选项卡来支持多个版本的 Node.js 编程模型。 v4 模型目前处于预览状态,旨在为 JavaScript 和 TypeScript 开发人员提供更为灵活和直观的体验。 在升级指南中详细了解 v3 和 v4 之间的差异。

配置

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

配置

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

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

使用情况

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

在 .NET 中,响应类型取决于 C# 模式:

HTTP 触发的函数返回以下类型之一的对象:

1 此类型仅在使用 ASP.NET Core 集成时可用。

当这些类型之一用作多重绑定输出对象的一部分时,应将 [HttpResult] 属性应用于对象属性。 该属性不采用任何参数。

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

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

后续步骤