Modifikasi parameter mesin gerbang API cloud-native - API Gateway

Sesuaikan parameter mesin gerbang API cloud-native untuk mengoptimalkan kinerja, keandalan, dan keamanan. Cakupan, rentang nilai valid, serta nilai default setiap parameter tercantum di bawah ini.

Prasyarat

Buat gerbang API cloud-native.

Langkah-langkah

Catatan

Hanya parameter yang ditampilkan di Konsol yang dapat dimodifikasi.
Periksa rentang nilai valid setiap parameter pada halaman Gateway Engine Parameters sebelum melakukan perubahan.

Masuk ke Konsol API Gateway.
Pada panel navigasi kiri, klik Cloud-native API Gateway > Instance. Pada bilah navigasi atas, pilih wilayah.
Pada halaman Instance, klik ID instans target.
Pada panel navigasi, pilih Parameter Settings. Di bagian Gateway Engine Parameters, temukan parameter target lalu klik Edit pada kolom Actions. Konfigurasikan parameter sesuai petunjuk di bawah ini, lalu klik OK.

Parameter mesin gerbang

Parameter	Tipe	Rentang valid	Nilai default	Deskripsi
EnableHttp2	bool	[true, false]	false	Fase permintaan. Menentukan apakah akan menggunakan HTTP/2 selama negosiasi protokol. true: Gunakan HTTP/2. false: Jangan gunakan HTTP/2.
EnableGenerateRequestId	bool	[true, false]	true	Fase permintaan. Saat diaktifkan, gerbang menghasilkan header X-Request-Id untuk mengidentifikasi setiap permintaan secara unik. true: Menghasilkan header X-Request-Id. false: Tidak menghasilkan header X-Request-Id.
EnableGzip	bool	[true, false]	false	Fase respons. true: Mengompres respons dengan Gzip, mengurangi traffic tetapi meningkatkan penggunaan CPU. false: Mengembalikan respons asli.
EnableGzipHardwareAccelerate	bool	[true, false]	false	Kompresi Gzip berakselerasi perangkat keras. Secara signifikan mengurangi traffic gerbang dengan kinerja lebih tinggi dan penggunaan CPU lebih rendah dibandingkan Gzip berbasis perangkat lunak. true: Mengaktifkan akselerasi perangkat keras Gzip. false: Menonaktifkan akselerasi perangkat keras Gzip. Penting Tidak tersedia di wilayah yang tidak mendukung atau jika akselerasi perangkat keras Gzip tidak diaktifkan saat pembelian. Jika diaktifkan, parameter EnableGzip dan ZipAlgorithm tidak lagi berlaku.
EnableSlashMerge	bool	[true, false]	false	Fase permintaan. Menentukan apakah akan menggabungkan garis miring berturut-turut (`/`) dalam path permintaan. true: Menggabungkan karakter `/` yang berlebih. Misalnya, `www.example.com//b` menjadi `www.example.com/b`. false: Garis miring berturut-turut (`/`) dipertahankan.
DownstreamIdleTime	integer	[0, 600]	300	Koneksi gerbang. Menutup koneksi client-ke-gerbang yang idle selama durasi yang ditentukan. Satuan: detik.
PreserveHeaderFormat	bool	[true, false]	false	Fase permintaan dan respons. Secara default, nama header diubah menjadi huruf kecil untuk kompatibilitas HTTP/2. true: Mempertahankan kapitalisasi header permintaan dan respons. false: Mengubah header permintaan dan respons menjadi huruf kecil.
DownstreamConnectionBufferLimits	integer	[0, 2147483647]	32768	Koneksi gerbang. Mengontrol ukuran buffer per koneksi, memengaruhi throughput dan penggunaan memori. Satuan: byte.
EnableHardwareAccelerate	bool	[true, false]	true	Enkripsi dan dekripsi TLS. Mengaktifkan pemrosesan TLS berakselerasi perangkat keras. Tidak berlaku jika akselerasi perangkat keras tidak didukung di wilayah Anda atau tidak diaktifkan saat pembelian. true: Mengaktifkan akselerasi perangkat keras. false: Menonaktifkan akselerasi perangkat keras. Catatan Akselerasi perangkat keras hanya didukung di wilayah China (Beijing), China (Hangzhou), China (Shanghai), China (Shenzhen), dan Asia Pacific SE 1 (Singapura).
XffTrustedNum	integer	[0, 10]	0	Fase permintaan. Jumlah proxy tepercaya sebelum gerbang, memengaruhi cara penanganan header yang dihasilkan klien seperti x-forwarded-for dan x-request-id. Jika diatur ke 0, gerbang menggunakan IP soket peer sebagai IP asal dan meneruskannya ke backend dalam header x-envoy-external-address. Jika bukan nol, gerbang menentukan IP asal dari header x-forwarded-for dengan melewati jumlah hop tertentu dari kanan ke kiri. IP ini diteruskan ke backend dalam header x-envoy-external-address. Gerbang juga mempertahankan header x-request-id dan x-forwarded-proto yang dikirim klien.
DownstreamHttp2MaxConcurrentStream	integer	[0, 2147483647]	100	Fase permintaan. Jumlah maksimum aliran HTTP/2 bersamaan per koneksi klien.
InitialStreamWindowSize	integer	[65535, 2147483647]	65535	Fase permintaan. Ukuran awal jendela kontrol aliran tingkat aliran HTTP/2. Satuan: byte.
InitialConnectionWindowSize	integer	[0, 2147483647]	1048576	Fase permintaan. Ukuran awal jendela kontrol aliran tingkat koneksi HTTP/2. Satuan: byte.
EnableHttp3	bool	[true, false]	false	Fase permintaan. Menentukan apakah akan menggunakan HTTP/3 untuk komunikasi client-ke-gerbang. true: Gunakan HTTP/3. false: Jangan gunakan HTTP/3.
UpstreamIdleTimeout	int	[0, 600]	30	Koneksi gerbang. Menutup koneksi gerbang-ke-upstream yang idle selama durasi yang ditentukan. Satuan: detik.
PathWithEscapedSlashes	string	KEEP_UNCHANGED REJECT_REQUEST UNESCAPE_AND_REDIRECT UNESCAPE_AND_FORWARD	KEEP_UNCHANGED	Aturan penerusan untuk permintaan yang path URI-nya berisi garis miring terenkripsi (%2F, %2f, %5C, atau %5c). KEEP_UNCHANGED: Membiarkan path tidak berubah. REJECT_REQUEST: Gerbang mengembalikan error 400 dan menolak permintaan. UNESCAPE_AND_REDIRECT: Mengurai karakter tersebut dan melakukan Pengalihan. UNESCAPE_AND_FORWARD: Mengurai karakter tersebut dan meneruskan permintaan.
ZipAlgorithm	List<string>	[brotli, gzip]	gzip	Algoritma kompresi. Nilai yang didukung: brotli, gzip. Jika keduanya ditentukan dengan nilai q yang sama dalam Accept-Encoding, algoritma pertama dalam daftar yang didahulukan.
EnableProxyProtocol	bool	[true, false]	false	Mengaktifkan protokol PROXY. Diperlukan ketika traffic ingress melewati Network Load Balancer (NLB) untuk mendapatkan alamat IP asal klien. Tidak memengaruhi permintaan yang tidak menggunakan protokol PROXY.
EnableCustomAuthConfigPush	bool	[true, false]	false	Skenario otentikasi yang dikelola sendiri. Saat diaktifkan, perubahan aturan otentikasi tidak mengganggu koneksi yang sedang berjalan. Cocok untuk skenario WebSocket dan bisnis online.