Azure Functions HTTP 輸出系結

  • 發行項

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

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

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

屬性

進程內和隔離的背景工作進程 C# 連結庫不需要屬性。 C# 文稿會改用function.json組態檔，如 C# 腳本指南中所述。

不需要傳回值屬性。 若要深入瞭解，請參閱 使用方式。

註釋

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

重要

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

組態

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

組態

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

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

使用方式

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

回應類型取決於 C# 模式：

HTTP 觸發的函式會 傳回 HttpResponseData 物件或 Task<HttpResponseData>。 如果應用程式在 .NET Isolated 中使用 ASP.NET Core 整合，它也可以使用 IActionResult、、Task<IActionResult>HttpResponse 或 Task<HttpResponse>。

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

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

下一步