Modify cloud-native API gateway engine parameters - API Gateway

Farklı senaryolardaki değişikliklere uyum sağlamak için cloud-native API ağ geçidinin parametrelerini ayarlayabilirsiniz. Doğru parametre ayarlaması, ağ performansını, güvenilirliği ve güvenliği artırarak kararlı çalışmayı ve daha iyi bir kullanıcı deneyimini sağlar. Ancak, ağ geçidi parametrelerini değiştirmek ağ bağlantısını ve ağ geçidini kullanan uygulamaları etkileyebilir. Parametreleri değiştirmeden önce, değiştirilebilir her bir parametrenin geçerli aralığını ve etkisini anladığınızdan emin olun. Bu konuda ağ geçidi parametrelerinin nasıl değiştirileceği ve parametre ayrıntıları açıklanmaktadır.

Önkoşullar

Bir ağ geçidi oluşturulmuş olmalıdır. Daha fazla bilgi için bkz. Cloud-native API ağ geçidi oluşturma.

Adımlar

Not

Yalnızca konsolda görüntülenen parametreler değiştirilebilir. Konsolda görüntülenmeyen parametreler değiştirilemez. Bu kısıtlama, örneğin kararlı çalışmasını sağlar.
Bir parametre değerini değiştirmeden önce, konsoldaki Ağ Geçidi Motoru Parametreleri sayfasında Value Range sütununu kontrol edin.

API Gateway konsolu adresinde oturum açın.
Sol gezinme bölmesinde Cloud-native API Gateway > Instance seçeneğine tıklayın. Üst gezinme çubuğunda bir bölge seçin.
Instance sayfasında hedef örnek kimliğine tıklayın.
Sol gezinme bölmesinde Parameters seçeneğine tıklayın. Gateway Engine Parameters bölümünde hedef parametreyi bulun, Actions sütunundaki Edit seçeneğine tıklayın, aşağıdaki tabloda açıklandığı gibi parametre değerini ayarlayın ve ardından OK seçeneğine tıklayın.

Ağ geçidi motoru parametreleri

Parameter Name	Parameter Type	Value Range	Default Value	Parameter Description
EnableHttp2	bool	[true, false]	false	İstek aşaması. Protokol anlaşması sırasında HTTP/2 kullanılıp kullanılmayacağını belirtir. true: HTTP/2 kullanılır. false: HTTP/2 kullanılmaz.
EnableGenerateRequestId	bool	[true, false]	true	İstek aşaması. Etkinleştirildiğinde, ağ geçidi her isteği benzersiz şekilde tanımlamak için bir X-Request-Id üstbilgisi oluşturur. true: Bir X-Request-Id üstbilgisi oluşturur. false: Bir X-Request-Id üstbilgisi oluşturmaz.
EnableGzip	bool	[true, false]	false	İstek ve yanıt aşamaları. true: Yanıtları Gzip ile sıkıştırır; bu durum ağ geçidi trafiğini azaltır ancak ağ geçidi CPU kullanımını artırır. false: Orijinal yanıtı döndürür.
EnableGzipHardwareAccelerate	bool	[true, false]	false	Donanım hızlandırmalı Gzip sıkıştırma. Yazılım tabanlı Gzip'e kıyasla daha yüksek performans ve daha düşük CPU kullanımı ile ağ geçidi trafiğini önemli ölçüde azaltır. true: Gzip donanım hızlandırmayı etkinleştirir. false: Gzip donanım hızlandırmayı devre dışı bırakır. Önemli Desteklenmeyen bölgelerde veya satın alma sırasında Gzip donanım hızlandırma etkinleştirilmemişse kullanılamaz. Etkinleştirildiğinde, EnableGzip ve ZipAlgorithm parametreleri artık etkili olmaz.
EnableSlashMerge	bool	[true, false]	false	İstek aşaması. İstek yolundaki ardışık eğik çizgilerin (`/`) birleştirilip birleştirilmeyeceğini belirtir. true: Gereksiz `/` karakterlerini birleştirir. Örneğin, `www.example.com//b`, `www.example.com/b` ile aynı şekilde işlenir. false: Gereksiz `/` karakterleri birleştirilmez.
DownstreamIdleTime	integer	[0, 600]	180	Ağ geçidi bağlantıları. Belirtilen süre boyunca boşta kalan istemci-ağ geçidi bağlantılarını kapatır. Birim: saniye.
PreserveHeaderFormat	bool	[true, false]	false	İstek ve yanıt aşamaları. Varsayılan olarak, HTTP/2 uyumluluğu için üstbilgi adları küçük harfe dönüştürülür. true: İstek ve yanıt üstbilgilerinin büyük/küçük harf biçimini korur. false: İstek ve yanıt üstbilgilerini küçük harfe dönüştürür.
DownstreamConnectionBufferLimits	integer	[0, 2147483647]	32768	Ağ geçidi bağlantıları. Bağlantı başına arabellek boyutunu kontrol eder; bu da aktarım hızını ve bellek kullanımını etkiler. Birim: bayt.
EnableHardwareAccelerate	bool	[true, false]	true	TLS şifreleme ve şifre çözme. Donanım hızlandırmalı TLS işlemeyi etkinleştirir. Bölgenizde donanım hızlandırma desteklenmiyorsa veya satın alma sırasında etkinleştirilmemişse etkili olmaz. true: Donanım hızlandırmayı etkinleştirir. false: Donanım hızlandırmayı devre dışı bırakır. Not Alt düzey donanım sınırlamaları nedeniyle, donanım hızlandırma şu anda yalnızca Çin (Pekin), Çin (Hangzhou), Çin (Şanghay), Çin (Shenzhen) ve Singapur bölgelerinde desteklenmektedir.
XffTrustedNum	integer	[0, 10]	0	İstek aşaması. Ağ geçidinden önceki güvenilir proxy sunucularının sayısı; x-forwarded-for ve x-request-id gibi istemci tarafından oluşturulan üstbilgilerin nasıl işleneceğini etkiler. 0 olarak ayarlanırsa, ağ geçidi eş soket IP'sini kaynak IP olarak kullanır ve bunu x-envoy-external-address üstbilgisinde arka uca iletir. Sıfırdan farklı bir değer ise, ağ geçidi sağdan sola doğru belirtilen atlama sayısını atlayarak x-forwarded-for üstbilgisinden kaynak IP'yi belirler. Bu IP, x-envoy-external-address üstbilgisinde arka uca iletilir. Ağ geçidi ayrıca istemci tarafından gönderilen x-request-id ve x-forwarded-proto üstbilgilerini de korur.
DownstreamHttp2MaxConcurrentStream	integer	[0, 2147483647]	100	İstek aşaması. İstemci bağlantısı başına maksimum eşzamanlı HTTP/2 akışı sayısı.
InitialStreamWindowSize	integer	[65535, 2147483647]	65535	İstek aşaması. Başlangıç HTTP/2 akış düzeyi akış denetimi pencere boyutu. Birim: bayt.
InitialConnectionWindowSize	integer	[0, 2147483647]	1048576	İstek aşaması. Başlangıç HTTP/2 bağlantı düzeyi akış denetimi pencere boyutu. Birim: bayt.
EnableHttp3	bool	[true, false]	false	İstek aşaması. İstemci-ağ geçidi iletişimi için HTTP/3 kullanılıp kullanılmayacağını belirtir. true: HTTP/3 kullanılır. false: HTTP/3 kullanılmaz.
UpstreamIdleTimeout	int	[0, 600]	30	Ağ geçidi bağlantıları. Belirtilen süre boyunca boşta kalan ağ geçidi-üst akış bağlantılarını kapatır. Birim: saniye.
PathWithEscapedSlashes	string	KEEP_UNCHANGED REJECT_REQUEST UNESCAPE_AND_REDIRECT UNESCAPE_AND_FORWARD	KEEP_UNCHANGED	URI yolunda kodlanmış eğik çizgiler (%2F, %2f, %5C veya %5c) içeren istekler için yönlendirme kuralı. KEEP_UNCHANGED: Yolu değişmeden korur. REJECT_REQUEST: Ağ geçidi 400 hatası döndürür ve isteği reddeder. UNESCAPE_AND_REDIRECT: Karakterlerin kodlamasını kaldırır ve yeniden yönlendirme gerçekleştirir. UNESCAPE_AND_FORWARD: Karakterlerin kodlamasını kaldırır ve isteği iletir.
ZipAlgorithm	List<string>	[brotli, gzip]	gzip	Sıkıştırma algoritması. Desteklenen değerler: brotli, gzip. Accept-Encoding içinde eşit q değerleriyle her ikisi de belirtildiğinde, listedeki ilk algoritma öncelik kazanır.
EnableProxyProtocol	bool	[true, false]	false	PROXY protokolünü etkinleştirir. Giriş trafiği bir Network Load Balancer (NLB) üzerinden geçtiğinde istemcinin kaynak IP adresini elde etmek için gereklidir. PROXY protokolünü kullanmayan istekleri etkilemez.
EnableCustomAuthConfigPush	bool	[true, false]	false	Kendi yönettiğiniz kimlik doğrulama senaryoları. Etkinleştirildiğinde, kimlik doğrulama kuralı değişiklikleri mevcut bağlantıları kesintiye uğratmaz. WebSocket ve çevrimiçi iş senaryoları için uygundur.