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]
属性应用于对象属性。 该属性不采用任何参数。 若要了解详情,请参阅使用情况。
重要
本文使用选项卡来支持多个版本的 Node.js 编程模型。 v4 模型目前处于预览状态,旨在为 JavaScript 和 TypeScript 开发人员提供更为灵活和直观的体验。 在升级指南中详细了解 v3 和 v4 之间的差异。
配置
配置
下表解释了在 function.json 文件中设置的绑定配置属性。
属性 | 说明 |
---|---|
type | 必须设置为 http 。 |
direction | 必须设置为 out 。 |
name | 在响应的函数代码中使用的变量名称,或者 $return 以使用返回值。 |
使用情况
若要发送 HTTP 响应,请使用语言标准响应模式。
在 .NET 中,响应类型取决于 C# 模式:
HTTP 触发的函数返回以下类型之一的对象:
- IActionResult1(或
Task<IActionResult>
) - HttpResponse1(或
Task<HttpResponse>
) - HttpResponseData(或
Task<HttpResponseData>
) - 表示
200 OK
响应的响应主体的 JSON 可序列化类型。
1 此类型仅在使用 ASP.NET Core 集成时可用。
当这些类型之一用作多重绑定输出对象的一部分时,应将 [HttpResult]
属性应用于对象属性。 该属性不采用任何参数。
对于 Java,请使用 HttpResponseMessage.Builder 来创建对 HTTP 触发器的响应。 若要了解详情,请参阅 HttpRequestMessage 和 HttpResponseMessage。
有关示例响应,请参阅触发器示例。