你当前正在访问 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 中为空主体
属性
使用 HttpResponseData 时,不需要返回值属性。 但是,使用 ASP.NET Core 集成 和 多绑定输出对象时, [HttpResultAttribute]
该属性应应用于对象属性。 该属性不采用任何参数。 若要了解详情,请参阅使用情况。
重要
本文使用选项卡来支持多个版本的 Node.js 编程模型。 v4 模型已正式发布,旨在为 JavaScript 和 TypeScript 开发人员提供更为灵活和直观的体验。 有关 v4 模型工作原理的更多详细信息,请参阅 Azure Functions Node.js 开发人员指南。 要详细了解 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。
有关示例响应,请参阅触发器示例。