Function Compute:Ikhtisar pemicu HTTP

Konfigurasi pemicu

• Fungsi yang dikonfigurasi dengan pemicu HTTP tidak dapat menggunakan jenis pemicu lainnya.

• Setiap versi atau alias fungsi mendukung paling banyak satu pemicu HTTP. Untuk detailnya, lihat Kelola versi dan Kelola alias.

• Nama domain bawaan yang disediakan oleh pemicu HTTP hanya untuk pengujian. Stabilitasnya tidak dijamin. Jangan gunakan untuk layanan produksi.

Rotasi VIP

Function Compute secara berkala merotasi alamat IP virtual (VIP) yang terkait dengan titik akhir publik dan internal pemicu HTTP. Menyimpan kode keras (hard-coding) VIP dapat menyebabkan gangguan layanan. Gunakan nama domain kustom dengan catatan CNAME (Canonical Name) sebagai gantinya. Kegagalan yang disebabkan oleh hard-coded VIP tidak dicakup oleh kebijakan kompensasi Function Compute. Lihat Konfigurasi nama domain kustom.

Batasan unduh APK

Mulai 10 Juni 2024, pemicu HTTP yang baru dibuat tidak dapat melayani file APK (tipe MIME: application/vnd.android.package-archive) dari titik akhir publik. Permintaan yang mencoba mengunduh file APK dari titik akhir publik akan mengembalikan error 400.

Risiko pemicu anonim

Jika Authentication Method diatur ke No Authentication, siapa pun yang memiliki URL dapat memanggil fungsi Anda. Untuk memvalidasi pemanggil tanpa mengaktifkan otentikasi penuh, periksa header permintaan Authorization dalam kode fungsi Anda. Lihat otentikasi tanda tangan.

HTTP/HTTPS

Pemicu HTTP mendukung metode permintaan berikut: GET, POST, PUT, DELETE, HEAD, PATCH, dan OPTIONS. Untuk instruksi pengaturan, lihat Konfigurasi dan gunakan pemicu HTTP.

Batasan permintaan

Header permintaan kustom yang diawali dengan x-fc- atau menggunakan nama bidang terbatas connection dan keep-alive tidak didukung.

Batasan tanggapan

Header tanggapan kustom yang diawali dengan x-fc- atau menggunakan salah satu nama bidang terbatas berikut tidak didukung: connection, content-length, date, keep-alive, server, upgrade, content-disposition:attachment.

Saat menggunakan domain bawaan aliyuncs.com, Function Compute memaksa header tanggapan content-disposition: attachment, yang menyebabkan browser mengunduh tanggapan sebagai file alih-alih menampilkannya. Untuk menghapus batasan ini, gunakan nama domain kustom. Lihat Konfigurasi nama domain kustom.

WebSocket

WebSocket cocok untuk koneksi persisten dan pesan real-time. Untuk instruksi pengaturan, lihat Konfigurasi pemicu HTTP untuk fungsi agar merespons permintaan WebSocket.

• Runtime yang didukung: Hanya Custom Runtime dan Custom Container.

• Metode yang didukung: GET (untuk handshake).

• Timeout: Mengikuti periode timeout yang dikonfigurasi pada fungsi.

Batasan permintaan handshake

Header permintaan yang diawali dengan x-fc- tidak didukung dalam permintaan handshake WebSocket.

Batasan transmisi data

Setiap pesan yang dikirim atau diterima melalui koneksi WebSocket yang telah terbentuk tidak boleh melebihi 6 MB.

gRPC

gRPC cocok untuk skenario latensi rendah dan berkinerja tinggi dengan komunikasi multibahasa berbasis Protocol Buffers (ProtoBuf). Untuk instruksi pengaturan, lihat Konfigurasi pemicu HTTP yang memanggil fungsi dengan permintaan gRPC.

• Runtime yang didukung: Hanya Custom Runtime dan Custom Container.

• Metode yang diperlukan: Sertakan POST dalam konfigurasi Request Methods pemicu HTTP.

• Titik akhir pemanggilan: Gunakan subdomain fcapp.run atau nama domain kustom.

• Timeout: Tunduk pada timeout yang dikonfigurasi pada fungsi. Untuk gRPC streaming, periode retensi koneksi maksimum sama dengan Periode Timeout Eksekusi.

Batasan transmisi data

Setiap pesan dalam koneksi streaming gRPC tidak boleh melebihi 6 MB.

Pemanggilan sinkron

Secara default, pemicu HTTP memanggil fungsi secara sinkron. Function Compute memproses permintaan dan mengembalikan hasil sebelum menutup koneksi. Lihat Pemanggilan sinkron.

Pemanggilan asinkron

Untuk pemanggilan asinkron, Function Compute menyimpan permintaan dan segera mengembalikan respons 202, tanpa menunggu eksekusi selesai.

Memulai pemanggilan asinkron

Tambahkan header permintaan berikut untuk memicu eksekusi asinkron:

X-Fc-Invocation-Type: Async

Jika berhasil, respons mencakup:

X-Fc-Request-Id: 80bf7****281713e1
X-Fc-Stateful-Async-Invocation-Id: 7522ba40****1c22e

Kode status selain 202 berarti pemanggilan asinkron gagal. Lihat Penanganan error.

Mode tugas asinkron

Setelah mengonfigurasi fungsi untuk mode tugas asinkron, tentukan ID pemanggilan kustom dengan:

X-Fc-Stateful-Async-Invocation-Id: <your-invocation-id>

Lihat Tugas asinkron untuk detailnya.

Pemanggilan tertunda

Untuk menunda eksekusi setelah mengirim permintaan asinkron, tambahkan header x-fc-async-delay dengan nilai dalam satuan detik. Rentang nilai yang valid adalah (0, 3600). Function Compute memulai eksekusi setelah jeda yang ditentukan berakhir. Lihat Pemanggilan tertunda.

Untuk daftar lengkap header permintaan pemanggilan yang didukung, lihat InvokeFunction.

Otentikasi signature

Permintaan harus ditandatangani dengan ID AccessKey dan Rahasia AccessKey, yang diteruskan ke Function Compute untuk verifikasi. Lihat Otentikasi signature.

Otentikasi JWT

Otentikasi Token Web JSON (JWT) adalah mekanisme standar untuk otorisasi API (RFC 7519). Metode ini sangat cocok untuk frontend web dan klien JavaScript tempat penyimpanan Rahasia AccessKey tidak praktis. Lihat Konfigurasi otentikasi JWT untuk pemicu HTTP.

Permintaan simple

Permintaan simple tidak memerlukan preflight. Tambahkan header Access-Control-Allow-* dalam kode fungsi untuk mengonfigurasi kontrol akses. Header kustom yang didukung:

• Access-Control-Allow-Origin

• Access-Control-Allow-Headers

• Access-Control-Request-Method

• Access-Control-Max-Age

Jika tidak ada header kustom yang diatur, Function Compute mengisi nilai default berikut:

• Access-Control-Allow-Origin: nilai Origin dari permintaan

• Access-Control-Allow-Credentials: true

• Access-Control-Expose-Headers: header kustom khusus Function Compute

Permintaan tidak sederhana

Sebelum mengirim permintaan tidak sederhana, browser mengirim permintaan preflight OPTIONS. Untuk menanganinya:

1. Tambahkan OPTIONS ke konfigurasi Request Methods pemicu HTTP Anda.

2. Deteksi dan tanggapi metode OPTIONS dalam kode fungsi.

Contoh Node.js berikut menunjukkan cara merespons permintaan preflight:

exports.handler = (req, resp, context) => {
    if (req.method === 'OPTIONS') {
        resp.setHeader('Access-Control-Allow-Origin', 'http://www.fc.com');
        resp.setHeader('Access-Control-Allow-Methods', 'POST');
        resp.setHeader('Access-Control-Allow-Headers', 'Content-Type');
        resp.setHeader('Access-Control-Max-Age', '3600');
        resp.setStatusCode(204);
        resp.send('');
    } else {
        resp.send('hello world');
    }
};