Function Compute:HTTP handler

Cara kerja

Saat permintaan tiba, Function Compute meneruskannya ke server HTTP yang berjalan di dalam kontainer Anda. Permintaan yang diteruskan mempertahankan semua atribut aslinya: metode, path, parameter kueri, header permintaan, badan permintaan, dan header umum yang dihasilkan oleh Function Compute.

Server HTTP di dalam kontainer Anda memproses permintaan tersebut dan mengembalikan respons. Function Compute kemudian meneruskan respons tersebut ke pemanggil.

Memanggil HTTP handler

Kirim permintaan ke HTTP handler dengan cara yang sama seperti memanggil API web apa pun—menggunakan cURL, Postman, atau browser.

Saat mengakses pemicu HTTP dari browser, respons mungkin diunduh sebagai file alih-alih ditampilkan. Untuk detailnya, lihat Mengapa saya perlu mengunduh respons saat mengakses fungsi dengan HTTP trigger melalui browser web?

Contoh Node.js Express berikut mengarahkan permintaan GET dan POST ke handler terpisah. Petakan path apa pun ke handler yang Anda butuhkan.

'use strict';

const express = require('express');

// Konstanta
const PORT = 9000;
const HOST = '0.0.0.0';

const app = express();
// Parsing badan permintaan sebagai JSON
app.use(express.json());

app.get('/*', (req, res) => {
  console.log(req.body);
  res.send('Hello FunctionCompute, http GET');
});

app.post('/*', (req, res) => {
  console.log(req.body);
  res.send('Hello FunctionCompute, http POST');
});

app.listen(PORT, HOST);
console.log(`Running on http://${HOST}:${PORT}`);

Untuk contoh tambahan dalam runtime lainnya, lihat Contoh.

Header permintaan dan respons

Header permintaan khusus

Function Compute menambahkan header berikut ke permintaan yang diteruskan ke kontainer Anda.

Header	Wajib	Deskripsi
x-fc-base-path	Opsional	Path dasar yang ditambahkan di awal path permintaan. Jika tidak ada nama domain kustom yang dikonfigurasi, nilainya adalah /2016-08-15/proxy/${servicename}/${functionname}/.
x-fc-status	Opsional	Berlaku untuk fungsi HTTP yang dibuat dengan memanggil operasi API web yang belum dimigrasikan ke Function Compute. Sertakan field ini dalam header respons untuk melaporkan status pemanggilan kembali ke Function Compute.

Dampak x-fc-status terhadap observabilitas:

x-fc-status dalam respons	Perilaku
Tidak disetel	Function Compute menganggap pemanggilan berhasil. Kesalahan selama eksekusi fungsi tidak dilaporkan ke Function Compute — logika bisnis tidak terpengaruh, tetapi observabilitas FC terganggu.
Disetel	Kegagalan pemanggilan fungsi dilaporkan ke Function Compute melalui x-fc-status. Informasi stack error dicatat dalam log.

Atur kedua StatusCode dan x-fc-status dalam respons HTTP Anda untuk mempertahankan observabilitas penuh.

Batasan

Nama domain kustom dan API Gateway

Ikatkan nama domain kustom ke fungsi HTTP Anda untuk memetakan path URL berbeda ke fungsi yang berbeda. Lihat Mengonfigurasi nama domain kustom.

Sebagai alternatif, gunakan API Gateway dengan jenis layanan backend diatur ke HTTP dan path fungsi HTTP sebagai alamat layanan backend. Lihat Menggunakan Function Compute sebagai layanan backend suatu operasi API.

Contoh

• Spring Boot

• C++

• .NET Core

FAQ

• Apakah port listening runtime kontainer kustom harus sama dengan port server HTTP yang dijalankan di dalam runtime kontainer kustom?

• Apa yang harus saya lakukan jika terjadi error FunctionNotStarted saat memanggil layanan pihak ketiga dalam layanan yang dijalankan di runtime kontainer kustom?

• Apa yang harus saya lakukan jika muncul error 502 yang berisi pesan error "Process exited unexpectedly before completing request"?

• Apa yang harus saya lakukan jika terjadi error 404 saat mengakses fungsi menggunakan browser atau tool cURL?

• Izin apa saja yang harus saya berikan kepada peran layanan Function Compute jika tidak menggunakan gambar kontainer publik Alibaba Cloud?