Azure Functions での HTTP 出力バインド

HTTP 要求の送信者 (HTTP トリガー) に応答するには、HTTP 出力バインディングを使用します。 このバインディングには、HTTP トリガーが必要です。このバインディングを使用すると、トリガーの要求に関連付けられている応答をカスタマイズできます。

HTTP によってトリガーされる関数の既定の戻り値は次のとおりです。

  • Functions 2.x 以降は、本文が空の HTTP 204 No Content
  • Functions 1.x は、本文が空の HTTP 200 OK

属性

インプロセス分離プロセスの C# ライブラリはどちらも、属性は必要ありません。 C# スクリプトでは、function.json 構成ファイルを使用します。

戻り値の属性は必須ではありません。 詳細については、「使用法」を参照してください。

注釈

Java 関数ランタイム ライブラリで、HttpOutput 注釈を使用して、この関数によって返される既定の変数以外の出力変数を定義します。 この注釈では、次の設定がサポートされます。

構成

次の表は、function.json ファイルで設定したバインド構成のプロパティを説明しています。

プロパティ 説明
type http に設定する必要があります。
direction out に設定する必要があります。
name 応答の関数コードで使用される変数名、または戻り値を使うことを示す $return

使用法

HTTP 応答を送信するには、言語標準の応答パターンを使います。

応答の種類は、C# モードによって異なります。

HTTP によってトリガーされる関数は、IActionResult または Task<IActionResult> の型を返します。

Java の場合は、HttpResponseMessage.Builder を使用して、HTTP トリガーへの応答を作成します。 詳細については、「HttpRequestMessage と HttpResponseMessage」を参照してください。

応答の例については、トリガーの例を参照してください。

次のステップ