Azure Functions での HTTP 出力バインド
HTTP 要求の送信者 (HTTP トリガー) に応答するには、HTTP 出力バインディングを使用します。 このバインディングには、HTTP トリガーが必要です。このバインディングを使用すると、トリガーの要求に関連付けられている応答をカスタマイズできます。
HTTP によってトリガーされる関数の既定の戻り値は次のとおりです。
- Functions 2.x 以降は、本文が空の
HTTP 204 No Content - Functions 1.x は、本文が空の
HTTP 200 OK
属性
インプロセスと分離ワーカー プロセスの C# ライブラリはどちらも、属性は必要ありません。 C# スクリプトでは、C# スクリプト ガイドで説明されているように、代わりに function.json 構成ファイルを使用します。
戻り値の属性は必須ではありません。 詳細については、「使用法」を参照してください。
注釈
Java 関数ランタイム ライブラリで、HttpOutput 注釈を使用して、この関数によって返される既定の変数以外の出力変数を定義します。 この注釈では、次の設定がサポートされます。
重要
この記事では、タブを使用して、Node.js プログラミング モデルの複数のバージョンに対応しています。 v4 モデルは一般提供されており、JavaScript と TypeScript の開発者にとって、より柔軟で直感的なエクスペリエンスが得られるように設計されています。 v4 モデルの動作の詳細については、Azure Functions Node.js 開発者ガイドを参照してください。 v3 と v4 の違いの詳細については、移行ガイドを参照してください。
構成
構成
次の表は、function.json ファイルで設定したバインド構成のプロパティを説明しています。
| プロパティ | 説明 |
|---|---|
| type | http に設定する必要があります。 |
| direction | out に設定する必要があります。 |
| name | 応答の関数コードで使用される変数名、または戻り値を使うことを示す $return。 |
使用法
HTTP 応答を送信するには、言語標準の応答パターンを使います。
応答の種類は、C# モードによって異なります。
HTTP によってトリガーされる関数は、HttpResponseData オブジェクトまたは Task<HttpResponseData> を返します。 アプリで .NET 分離の ASP.NET Core 統合を使用する場合は、IActionResult、Task<IActionResult>、HttpResponse、または Task<HttpResponse> が使用される場合もあります。
Java の場合は、HttpResponseMessage.Builder を使用して、HTTP トリガーへの応答を作成します。 詳細については、「HttpRequestMessage と HttpResponseMessage」を参照してください。
応答の例については、トリガーの例を参照してください。