Penangan HTTP memungkinkan Anda menjalankan aplikasi web HTTP yang sudah ada di Function Compute tanpa mengubah kode aplikasi. Function Compute meneruskan permintaan masuk secara transparan—termasuk metode, path, parameter kueri, header permintaan, dan isi permintaan—ke server HTTP Anda, bersama dengan header umum yang dihasilkan oleh Function Compute.
Panggil penangan HTTP
Memanggil penangan HTTP sama seperti memanggil operasi API web. Kirim permintaan menggunakan cURL, Postman, atau browser.
Saat mengakses pemicu HTTP melalui browser, respons mungkin diunduh sebagai file alih-alih ditampilkan. Untuk detail dan solusinya, lihat Mengapa saya perlu mengunduh respons saat mengakses fungsi dengan pemicu HTTP menggunakan browser web?
Header permintaan khusus
| Header | Deskripsi |
|---|---|
x-fc-base-path (opsional) | Path dasar yang ditambahkan di awal path permintaan. Nilai default-nya adalah /2016-08-15/proxy/${servicename}/${functionname}/ jika tidak ada nama domain kustom yang dikonfigurasi. |
x-fc-status (opsional) | Melaporkan apakah pemanggilan fungsi lokal berhasil. Berlaku untuk fungsi HTTP yang tidak dimigrasikan ke Function Compute tetapi dibuat dengan memanggil operasi API web. |
Cara x-fc-status memengaruhi observabilitas:
Tidak ditentukan: Function Compute memperlakukan setiap pemanggilan sebagai berhasil. Jika fungsi Anda mengalami error, error tersebut tidak dilaporkan ke Function Compute. Logika bisnis tidak terpengaruh, tetapi observabilitas Function Compute menurun.
Ditentukan: Function Compute menggunakan nilai
x-fc-statusuntuk menentukan keberhasilan atau kegagalan pemanggilan. Saat terjadi kegagalan, stack error dicatat dalam log.
Tetapkan kedua bidangStatusCodedanx-fc-statusdalam respons HTTP agar observabilitas di Function Compute tetap akurat.
Batasan
Batasan pemicu
Hanya satu pemicu HTTP yang dapat dibuat per fungsi HTTP per versi atau alias. Lihat Manage versions dan Manage aliases.
Batasan permintaan
| Batasan | Nilai | Error saat melebihi |
|---|---|---|
| Ukuran header (total semua kunci dan nilai) | 8 KB | 400 InvalidArgument |
| Ukuran path (termasuk semua parameter kueri) | 4 KB | 400 InvalidArgument |
| Ukuran isi — pemanggilan sinkron | 32 MB | 400 InvalidArgument |
| Ukuran isi — pemanggilan asinkron | 128 KB | 400 InvalidArgument |
Bidang header berikut tidak didukung dalam permintaan:
Bidang yang diawali dengan
x-fc-connectionkeep-alive
Batasan respons
| Batasan | Nilai | Error saat melebihi |
|---|---|---|
| Ukuran header (total semua kunci dan nilai) | 8 KB | 502 BadResponse |
Bidang header berikut tidak didukung dalam respons:
Bidang yang diawali dengan
x-fc-connectioncontent-lengthdatekeep-aliveservercontent-disposition:attachment
Saat menggunakan domain defaultaliyuncs.com, Function Compute secara paksa menambahkancontent-disposition: attachmentke header respons, yang menyebabkan browser mengunduh respons sebagai file. Untuk menghapus pembatasan ini, konfigurasikan nama domain kustom. Lihat Configure a custom domain name.
Rutekan permintaan HTTP
Ikatkan nama domain kustom untuk memetakan path HTTP berbeda ke fungsi HTTP Anda. Lihat Configure a custom domain name.
Sebagai alternatif, gunakan API Gateway dengan tipe layanan backend diatur ke HTTP dan path fungsi HTTP sebagai alamat layanan backend. Lihat Use Function Compute as the backend service of an API operation.
Contoh untuk bahasa pemrograman lain
Gunakan Serverless Devs untuk menerapkan fungsi penangan HTTP ke Function Compute. Contoh berikut menunjukkan penerapan untuk runtime umum: