Azure Functions HTTP 輸出系結

使用 HTTP 輸出系結來回應 HTTP 要求傳送者 （HTTP 觸發程式）。 此繫結需要 HTTP 觸發程序，並可讓您自訂與觸發程序要求相關聯的回應。

HTTP 觸發函式的預設傳回值為：

• HTTP 204 No Content 函式 2.x 和更新版本中的空白主體
• HTTP 200 OK 函式 1.x 中的空白本文

屬性

隔離式背景工作角色模型

使用 HttpResponseData 時，不需要傳回值屬性。 不過，使用 ASP.NET Core 整合 和 多重系結輸出物件時， [HttpResultAttribute] 屬性應該套用至物件屬性。 屬性不接受任何參數。 若要深入瞭解，請參閱 使用方式。

內含式模型

重要

內含式模型支援將於 2026 年 11 月 10 日結束。 強烈建議您將應用程式移轉至隔離式背景工作角色模型，以取得完整支援。

類別庫不需要傳回值屬性。 C# 文稿會改用function.json組態檔，如 C# 腳本指南中所述。 若要深入瞭解，請參閱 使用方式。

註釋

在 Java 函式執行時間連結庫中，使用 HttpOutput 註釋來定義函式所傳回之預設變數以外的輸出變數。 此批註支援下列設定：

• dataType
• name

重要

本文使用索引標籤來支援多個版本的 Node.js 程式設計模型。 v4 模型已正式推出，旨在為 JavaScript 和 TypeScript 開發人員提供更靈活且更直覺的體驗。 如需 v4 模型運作方式的更多詳細資料，請參閱 Azure Functions Node.js 開發人員指南。 若要深入了解 v3 與 v4 之間的差異，請參閱移轉指南。

組態

模型 v4

options傳遞給 output.http() 方法的物件目前不支援模型 v4 的任何屬性。

模型 v3

下表說明您在 function.json 檔案中設定的繫結設定屬性。

屬性	描述
type	必須設定為 http。
direction	必須設定為 out。
name	函式程式碼中用於回應的變數名稱，或要使用傳回值的 $return。

組態

下表說明您在 function.json 檔案中設定的繫結設定屬性。

屬性	描述
type	必須設定為 http。
direction	必須設定為 out。
name	函式程式碼中用於回應的變數名稱，或要使用傳回值的 $return。

使用方式

若要傳送 HTTP 回應，請使用語言標準回應模式。

在 .NET 中，回應類型取決於 C# 模式：

隔離式背景工作角色模型

HTTP 觸發函式會傳回下列其中一種類型的物件：

• IActionResult¹ （或 Task<IActionResult>）
• HttpResponse¹ （或 Task<HttpResponse>）
• HttpResponseData （或 Task<HttpResponseData>）
• JSON 可串行化類型，代表回應的 200 OK 響應主體。

¹ 只有在使用 ASP.NET Core 整合時，才能使用此類型。

當其中一種型別當做多重系結輸出物件的一部分使用時，[HttpResult]屬性應該套用至對象屬性。 屬性不接受任何參數。

內含式模型

HTTP 觸發的函式會傳回 IActionResult 或Task<IActionResult>類型。

針對 Java，請使用 HttpResponseMessage.Builder 來建立 HTTP 觸發程式的回應。 若要深入瞭解，請參閱 HttpRequestMessage 和 HttpResponseMessage。

如需回應範例，請參閱 觸發程式範例。

下一步

• 從 HTTP 要求執行函式