Ubah parameter mesin gerbang API cloud-native - API Gateway

Untuk menyesuaikan dengan perubahan dalam berbagai skenario, Anda dapat mengubah parameter gerbang API cloud-native. Penyetelan parameter yang tepat meningkatkan kinerja jaringan, keandalan, dan keamanan, sehingga membantu memastikan operasi yang stabil serta pengalaman pengguna yang lebih baik. Namun, perubahan parameter gerbang dapat memengaruhi konektivitas jaringan dan aplikasi yang menggunakannya. Sebelum mengubah parameter, pastikan Anda memahami rentang nilai yang valid dan dampak dari setiap parameter yang dapat diubah. Topik ini menjelaskan cara mengubah parameter gerbang serta menyediakan detail parameter terkait.

Prasyarat

Gerbang telah dibuat. Untuk informasi selengkapnya, lihat Buat gerbang API cloud-native.

Langkah-langkah

Catatan

Hanya parameter yang ditampilkan di Konsol yang dapat diubah. Parameter yang tidak ditampilkan di Konsol tidak dapat diubah. Pembatasan ini bertujuan menjaga stabilitas operasi instans.
Sebelum mengubah nilai parameter, periksa kolom Value Range pada halaman Gateway Engine Parameters di Konsol.

Masuk ke API Gateway console.
Pada panel navigasi sebelah kiri, klik Cloud-native API Gateway > Instance. Pada bilah navigasi atas, pilih wilayah.
Pada halaman Instance, klik ID instans target.
Pada panel navigasi sebelah kiri, pilih Parameters. Di bagian Gateway Engine Parameters, temukan parameter target, klik Edit pada kolom Actions, atur nilai parameter sesuai dengan tabel berikut, lalu klik OK.

Parameter gateway engine

Parameter Name	Parameter Type	Value Range	Default Value	Parameter Description
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 permintaan dan respons. true: Mengompres respons dengan Gzip, yang mengurangi traffic gerbang tetapi meningkatkan penggunaan CPU gerbang. 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. Saat diaktifkan, parameter EnableGzip dan ZipAlgorithm tidak lagi berlaku.
EnableSlashMerge	bool	[true, false]	false	Fase permintaan. Menentukan apakah akan menggabungkan tanda slash berturut-turut (`/`) dalam path permintaan. true: Menggabungkan karakter `/` yang berlebihan. Misalnya, `www.example.com//b` diperlakukan sama seperti `www.example.com/b`. false: Karakter `/` yang berlebihan tidak digabungkan.
DownstreamIdleTime	integer	[0, 600]	180	Koneksi gerbang. Menutup koneksi client ke gerbang yang idle selama durasi tertentu. 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, yang 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 Karena keterbatasan perangkat keras dasar, akselerasi perangkat keras saat ini hanya didukung di wilayah China (Beijing), China (Hangzhou), China (Shanghai), China (Shenzhen), dan Singapura.
XffTrustedNum	integer	[0, 10]	0	Fase permintaan. Jumlah proxy tepercaya sebelum gerbang, yang 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 tertentu. 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 slash terenkripsi (%2F, %2f, %5C, atau %5c). KEEP_UNCHANGED: Menjaga path tetap 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. Bila keduanya ditentukan dengan nilai q yang sama dalam Accept-Encoding, algoritma pertama dalam daftar yang diutamakan.
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.