Pengikatan output HTTP Azure Functions

Gunakan pengikatan output HTTP untuk merespons pengirim permintaan HTTP (Pemicu HTTP). Pengikatan ini membutuhkan pemicu HTTP dan memungkinkan Anda menyesuaikan respons yang terkait dengan permintaan pemicu.

Nilai pengembalian default untuk fungsi yang dipicu HTTP adalah:

• HTTP 204 No Content dengan isi kosong di Functions 2.x dan versi yang lebih tinggi
• HTTP 200 OK dengan isi kosong di Functions 1.x

Atribut

Model pekerja terisolasi

Atribut nilai pengembalian tidak diperlukan saat menggunakan HttpResponseData. Namun, saat menggunakan integrasi ASP.NET Core dan objek output multi-pengikatan, [HttpResultAttribute] atribut harus diterapkan ke properti objek. Atribut tidak mengambil parameter. Untuk mempelajari selengkapnya, lihat Penggunaan.

Model dalam proses

Penting

Dukungan akan berakhir untuk model dalam proses pada 10 November 2026. Kami sangat menyarankan Agar Anda memigrasikan aplikasi Anda ke model pekerja yang terisolasi untuk dukungan penuh.

Atribut nilai pengembalian tidak diperlukan untuk pustaka kelas. Skrip C# sebagai gantinya menggunakan file konfigurasi function.json seperti yang dijelaskan dalam panduan pembuatan skrip C#. Untuk mempelajari selengkapnya, lihat Penggunaan.

Anotasi

Di pustaka runtime fungsi Java, gunakan anotasi HttpOutput untuk menentukan variabel output selain variabel default yang dikembalikan oleh fungsi. Anotasi ini mendukung pengaturan berikut:

• dataType
• nama

Penting

Artikel ini menggunakan tab untuk mendukung beberapa versi model pemrograman Node.js. Model v4 umumnya tersedia dan dirancang untuk memiliki pengalaman yang lebih fleksibel dan intuitif untuk pengembang JavaScript dan TypeScript. Untuk detail selengkapnya tentang cara kerja model v4, lihat panduan pengembang Node.js Azure Functions. Untuk mempelajari selengkapnya tentang perbedaan antara v3 dan v4, lihat panduan migrasi.

Konfigurasi

Model v4

Objek options yang diteruskan ke output.http() metode saat ini tidak mendukung properti apa pun untuk model v4.

Model v3

Tabel berikut menjelaskan properti konfigurasi pengikatan yang Anda atur di file function.json.

Properti	Deskripsi
jenis	Harus diatur ke http.
arah	Harus diatur ke out.
nama	Nama variabel yang digunakan dalam kode fungsi untuk respons, $return atau untuk menggunakan nilai yang dikembalikan.

Konfigurasi

Tabel berikut menjelaskan properti konfigurasi pengikatan yang Anda atur di file function.json.

Properti	Deskripsi
jenis	Harus diatur ke http.
arah	Harus diatur ke out.
nama	Nama variabel yang digunakan dalam kode fungsi untuk respons, $return atau untuk menggunakan nilai yang dikembalikan.

Penggunaan

Untuk mengirim respons HTTP, gunakan pola respons standar bahasa.

Di .NET, jenis respons tergantung pada mode C#:

Model pekerja terisolasi

Fungsi yang dipicu HTTP mengembalikan objek dari salah satu jenis berikut:

• IActionResult¹ (atau Task<IActionResult>)
• HttpResponse¹ (atau Task<HttpResponse>)
• HttpResponseData (atau Task<HttpResponseData>)
• Jenis yang dapat diserialisasikan JSON yang mewakili isi respons untuk 200 OK respons.

¹ Jenis ini hanya tersedia saat menggunakan integrasi ASP.NET Core.

Ketika salah satu jenis ini digunakan sebagai bagian dari objek output multi-pengikatan, [HttpResult] atribut harus diterapkan ke properti objek. Atribut tidak mengambil parameter.

Model dalam proses

Fungsi yang dipicu HTTP mengembalikan jenis IActionResult atau Task<IActionResult>.

Untuk Java, gunakan HttpResponseMessage.Builder untuk membuat respons terhadap pemicu HTTP. Untuk mempelajari selengkapnya, lihat HttpRequestMessage dan HttpResponseMessage.

Untuk contoh respons, lihat contoh pemicu.

Langkah berikutnya

• Jalankan fungsi dari permintaan HTTP