Tüm Ürünler
Search

Bu Ürün

    API Gateway:Configure policies and plug-ins

    Belge Merkezi

    API Gateway:Configure policies and plug-ins

    Son Güncelleme:Oct 04, 2026

    Cloud-native API Gateway, API'lerin ve işlemlerin güvenliğini, performansını ve sürdürülebilirliğini artırmak için ilke eklemenize ve eklenti yapılandırmanıza olanak tanır.

    Önemli

    • İlke değişiklikleri hemen etkinleşir. API'yi yeniden yayınlamanız gerekmez.

    • Varsayılan olarak ağ geçidi, API düzeyindeki eklenti yapılandırmalarını işlem düzeyinde uygular.

    • API düzeyindeki ilkeleri işlem düzeyinde silemeseniz de işlem düzeyindeki ilkeler API düzeyindeki ilkelerin üzerine yazabilir.

    Yordam

    1. Bir API ilkesini iki şekilde ekleyebilirsiniz: bir örnek dışından veya bir örnek içinden.

      Örnek dışındaki API'ler

      1. Cloud-native API Gateway konsolu üzerinde oturum açın. Sol gezinme bölmesinde API seçeneğine tıklayın ve üst menü çubuğundan bir bölge seçin.

      2. Hedef API'ye tıklayın ve açılır listeden hedef örneği seçin.

      Örnek içindeki API'ler

      1. Cloud-native API Gateway konsolu üzerinde oturum açın. Sol gezinme bölmesinde Instance seçeneğine tıklayın ve üst menü çubuğundan bir bölge seçin.

      2. Instance sayfasında hedef ağ geçidi örneğinin kimliğine tıklayın. Sol gezinme bölmesinde API seçeneğine tıklayın ve ardından hedef API'ye tıklayın.

    2. İlkeleri ve eklentileri API düzeyinde veya işlem düzeyinde yapılandırabilirsiniz:

      • API düzeyi: Tüm işlemler için API düzeyinde ilke ve eklenti yapılandırmak üzere API Policy Configuration sekmesine tıklayın. Ardından Enable Policy/Plug-in seçeneğine tıklayın.

      • İşlem düzeyi: Operations sekmesinde hedef işlemi seçin. Policy Configuration sekmesine tıklayın ve ardından Enable Policy/Plug-in seçeneğine tıklayın.

    3. Enable Policy/Plug-in panelinde yapılandırmak için bir ilke veya eklenti seçin. Daha fazla bilgi için bkz. İlke yapılandırma ve Eklenti yapılandırma.

    İlkeler

    Kısıtlama ilkesi

    Cloud-native API Gateway, API ve işlem düzeylerinde kısıtlama ilkelerini destekler. Bu ilkeler gelen isteklerin arka uç hizmetlerinizi aşırı yüklemesini önler ve kademeli hatalardan kaçınmanıza yardımcı olur. Yüksek eşzamanlılık senaryolarında kısıtlama bazı istekleri engelleyerek arka uç hizmetlerinin kullanılabilirliğini korur. Bu sayede belirli bir zaman diliminde her bir API ve işlem için istek sayısını hassas bir şekilde kontrol edebilir ve bu sayının önceden belirlenen eşiği aşmamasını sağlayabilirsiniz.

    Kısıtlama ilkeleri arasında Concurrency Control, Traffic Control ve Circuit Breaking bulunur.

    • Eşzamanlılık denetimi ilkesi: Bu ilke eşzamanlı istek sayısını sınırlar. Ağ geçidi tarafından şu anda işlenmekte olan toplam istek sayısını sayarak çalışır. Bu sayı yapılandırılan eşiğe ulaştığında ağ geçidi yeni trafiği hemen engeller. Trafik artışları sırasında kullanılabilirliği korumak amacıyla bu eşiği arka uç hizmetinizin işleyebileceği maksimum eşzamanlı istek sayısına göre ayarlayabilirsiniz.

      Yordam

      Add Policy sayfasında Concurrency Control kartına tıklayın. Add Policy: Concurrency Control panelinde parametreleri yapılandırın.

      Parametre

      Açıklama

      Enable or Not

      Eşzamanlılık denetimi kuralını etkinleştirir.

      Overall Concurrency Threshold

      Overall Concurrency Threshold değerini belirtin.

      Web Fallback Behavior

      Return Specific Content

      HTTP Status Code

      HTTP Status Code değerini belirtin. Varsayılan değer 429'dur.

      Type of Returned Content

      Type of Returned Content değerini Regular Text veya JSON olarak ayarlayın.

      HTTP Text

      Özel yanıt gövdesinin içeriği.

      Return Specific Content

      Redirect URL

      Redirect URL adresini girin.

    • Trafik denetimi ilkesi: Bu ilke saniyedeki sorgu sayısı (QPS) bazında istek oranını sınırlar. Bir API veya işlem için QPS değerini izleyerek çalışır. QPS değeri yapılandırılan eşiğe ulaştığında ağ geçidi yeni trafiği hemen engeller. Bu durum arka uç hizmetlerinin ani trafik artışları nedeniyle aşırı yüklenmesini önler ve yüksek kullanılabilirlik sağlar.

      Yordam

      Add Policy sayfasında Traffic Control kartına tıklayın. Add Policy: Traffic Control panelinde parametreleri yapılandırın.

      Parametre

      Açıklama

      Enable or Not

      Trafik denetimi kuralını etkinleştirir.

      Overall QPS Threshold

      Overall QPS Threshold değerini belirtin.

      Web Fallback Behavior

      Return Specific Content

      HTTP Status Code

      HTTP Status Code değerini belirtin. Varsayılan değer 429'dur.

      Type of Returned Content

      Type of Returned Content değerini Regular Text veya JSON olarak ayarlayın.

      HTTP Text

      Özel yanıt gövdesinin içeriği.

      Redirect to Specified Page

      Redirect URL

      Redirect URL adresini girin.

    • Devre kesme ilkesi: Bu ilke API'lerin ve işlemlerin yanıt süresini veya hata oranını izleyerek arka uç hizmetlerini korur. Belirtilen bir eşiğe ulaşıldığında ağ geçidi "devreyi keser" ve kararsız hizmete yönelik isteklerde hızlı hata döndürerek daha fazla yük binmesini önler. Yapılandırılan bir süre sonunda ağ geçidi "yarı açık" duruma geçer ve hizmetin kurtulup kurtulmadığını görmek için sınırlı sayıda test isteğine izin verir. Hizmet kararlıysa devre kapanır; aksi takdirde devre tekrar kesilir.

      Devre kesme durumu her ağ geçidi düğümü tarafından bağımsız olarak korunur. Her düğüm istekleri kendi başına sayar ve yavaş çağrı oranını veya özel durum oranını hesaplar. Devre kesme eşiği küme genelinde toplanmak yerine düğüm başına uygulanır. Minimum Number of Requests, Statistical Window Duration ve devre kesme oranı eşiğini yapılandırırken bu değerlerin tüm ağ geçidi kümesi yerine tek bir düğümün yerel istatistiklerine uygulandığını unutmayın.

      Yordam

      Add Policy sayfasında Circuit Breaking kartına tıklayın. Add Policy: Circuit Breaking panelinde parametreleri yapılandırın.

      Parametre

      Açıklama

      Enable or Not

      Devre kesme kuralını etkinleştirir.

      Statistical Window Duration

      İstatistik toplama zaman penceresinin uzunluğu. Geçerli değerler: 1 saniye ile 120 dakika.

      Minimum Number of Requests

      Devre kesmeyi tetiklemek için istatistik penceresi içinde gereken minimum istek sayısı. İstek sayısı bu değerin altındaysa hata eşiği karşılanmış olsa bile devre kesici devreye girmez.

      Threshold Type

      Eşik türü olarak Slow Call Ratio (%) veya Exception Ratio (%) seçeneğini belirleyin.

      1. Slow Call Ratio (%) seçeneğini belirlerseniz Slow Call RT (maksimum yanıt süresi) değerini de belirtmeniz gerekir. Yanıt süresi bu değeri aşan bir istek yavaş çağrı olarak sayılır. Kural etkinleştirildiğinde istatistik penceresi içindeki istek sayısı minimum istek sayısından büyükse ve yavaş çağrı yüzdesi eşiği aşarsa devre kesilir. Devre kesme süresi dolduktan sonra devre kesici yoklama kurtarma (yarı açık) durumuna geçer. Sonraki test isteğinin yanıt süresi belirtilen yavaş çağrı RT değerinden azsa devre kapanır. Aksi takdirde devre tekrar kesilir.

      2. Exception Ratio (%) seçeneğini belirlerseniz hata yüzdesi eşiğini belirtmeniz gerekir. Kural etkinleştirildiğinde istatistik penceresi içindeki istek sayısı minimum istek sayısından büyükse ve hata yüzdesi eşiği aşarsa devre yapılandırılan süre boyunca kesilir.

      Slow Call RT

      İzin verilen Slow Call RT (yani maksimum yanıt süresi) değerini belirtin.

      Circuit Breaking Ratio Threshold

      Devre kesmeyi tetikleyen yavaş çağrı veya hata yüzdesi. Geçerli değerler: 0 ila 100 (%0 ila %100 anlamına gelir).

      Devre Kesme Süresi (sn)

      Devre kesildikten sonra açık kalma süresi. Bu süre boyunca kaynaklara yapılan tüm istekler hızlı hata döndürür.

      Web Fallback Behavior

      Return Specific Content

      HTTP Status Code

      HTTP Status Code değerini belirtin. Varsayılan değer 429'dur.

      Type of Returned Content

      Type of Returned Content değerini Regular Text veya JSON olarak ayarlayın.

      HTTP Text

      Özel yanıt gövdesinin içeriği.

      Redirect to Specified Page

      Redirect URL

      Redirect URL adresini girin.

    Yeniden yazma ilkesi

    Yeniden yazma ilkesi isteği arka uç hizmetine iletmeden önce istek yolunu ve ana bilgisayar adını değiştirmenize olanak tanır. Bu durum isteklerin doğru hizmete veya uç noktaya yönlendirilmesini sağlayarak belirli iş ve mimari gereksinimlerin karşılanmasına yardımcı olur.

    Yordam

    Add Policy sayfasında HTTP Rewrite seçeneğine tıklayarak Add Policy: HTTP Rewrite panelini açın ve parametreleri yapılandırın.

    • Yol yeniden yazma

      Cloud-native API Gateway yol yeniden yazma için iki modu destekler.

      • Exact Rewrite: Yalnızca işlem düzeyindeki yeniden yazmaları destekler.

      • Regex Rewrite: Hem işlem hem de API düzeyindeki yeniden yazmaları destekler.

      Tam eşleşmeli yeniden yazma

      Tam eşleşmeli yeniden yazma orijinal istek yolunun önekini değiştirmenize olanak tanır.

      Örnek 1

      Orijinal istek yolu /app/test ancak arka uç hizmetine iletilmesi gereken yol /test şeklindedir. Aşağıdaki yapılandırmayı öneririz:

      • API ve işlem eşleştirme koşulu: Eşleştirme türünü Tam Eşleşme olarak ayarlayın ve yolu /app/ olarak belirtin.

      • Yeniden yazma: Yeniden yazma türünü Tam Yeniden Yazma olarak ayarlayın ve yolu / olarak belirtin.

      Not

      API ve işlem eşleştirme koşulu için yol /app/ olarak ayarlanmalıdır çünkü tam yeniden yazma yalnızca tam eşleşen dizeyi değiştirir. Yol /app olarak ayarlanırsa yeniden yazılan yol yanlışlıkla //test olur.

      Örnek 2

      Orijinal istek yolu /v1/test ancak arka uç hizmetine iletilmesi gereken yol /v2/test şeklindedir. Aşağıdaki yapılandırmayı öneririz:

      • API ve işlem eşleştirme koşulu: Eşleştirme türünü Tam Eşleşme olarak ayarlayın ve yolu /v1 olarak belirtin.

      • Yeniden yazma: Yeniden yazma türünü Tam Yeniden Yazma olarak ayarlayın ve yolu /v2 olarak belirtin.

      Önemli

      Tam yeniden yazma için API veya işlem eşleştirme yönteminin Tam Eşleşme olarak ayarlanması gerekir. Önek Eşleşmesi ve Regex Eşleşmesi tam yeniden yazmayı desteklemez. Tam yeniden yazma belirtilen öneke sahip tüm isteklere uygulanır. Bu amacınız değilse farklı bir yeniden yazma yöntemi kullanın.

      Düzenli ifadeyle yeniden yazma

      Düzenli ifadeyle yeniden yazma orijinal istek yolunun bölümlerini değiştirmenize olanak tanır. Düzenli ifadeyle yeniden yazma yapılandırması iki bölümden oluşur: değiştirmek istediğiniz yol bölümünü eşleştiren bir desen ve eşleşen bölümün yerine geçen bir değiştirme dizesi. Düzenli ifade sözdizimi hakkında daha fazla bilgi için bkz. RE2 Sözdizimi.

      Örnek 1

      Orijinal istek yolu /aaa/one/bbb/one/ccc ancak arka uç hizmetine iletilmesi gereken yol /aaa/two/bbb/two/ccc şeklindedir. Aşağıdaki yapılandırmayı öneririz:

      • API ve işlem eşleştirme koşulu: Eşleştirme türünü Tam Eşleşme olarak ayarlayın ve yolu /aaa/one/bbb/one/ccc olarak belirtin.

      • Yeniden yazma: Yeniden yazma türünü Düzenli İfadeyle Yeniden Yazma olarak ayarlayın deseni one ve değiştirme dizesini two olarak belirtin.

      Örnek 2

      Orijinal istek yolu /httpbin/(.*)/(.*) şeklindedir. /httpbin önekini kaldırmak ve yakalanan iki yol segmentinin konumlarını değiştirmek istiyorsunuz. Aşağıdaki yapılandırmayı öneririz:

      • API ve işlem eşleştirme koşulu: Eşleştirme türünü Regex Eşleşmesi olarak ayarlayın ve yolu /httpbin/(.*)/(.*) olarak belirtin.

      • Yeniden yazma: Yeniden yazma türünü Düzenli İfadeyle Yeniden Yazma olarak ayarlayın deseni /httpbin/(.*)/(.*) ve değiştirme dizesini /\2/\1 olarak belirtin. Burada \1 ilk yakalama grubunu \2 ise ikinci yakalama grubunu temsil eder. Bu durum Nginx'teki $1 ve $2 değişkenlerine benzer.

      Örnek 3

      Yol tabanlı sürüm oluşturma kullanan bir REST API için isteği arka uca iletmeden önce sürüm segmentini yoldan kaldırmak isteyebilirsiniz. Örneğin orijinal yol /basePath/version/order/get ve istenen arka uç yolu /basePath/order/get ise aşağıdaki yapılandırmayı öneririz:

      • API ilkesi yapılandırmasını kullanın.

      • Yeniden yazma: Yeniden yazma türünü Düzenli İfadeyle Yeniden Yazma olarak ayarlayın deseni (/.*)/version(/.*) ve değiştirme dizesini \1\2 olarak belirtin. Burada \1 ilk yakalama grubunu \2 ise ikinci yakalama grubunu temsil eder. Bu durum Nginx'teki $1 ve $2 değişkenlerine benzer.

      Not

      Düzenli ifadeyle yeniden yazma karmaşık bir sözdizimine sahip gelişmiş bir özelliktir ve genellikle özel durumlar için kullanılır.

    • Ana bilgisayar adı yeniden yazma

      Cloud-native API Gateway istek ana bilgisayar adı için tam yeniden yazmayı destekler.

      Örneğin orijinal istek Host üstbilgisi test.com ancak arka uç hizmeti dev.com bekliyorsa yeniden yazma ilkesinde yeniden yazılan ana bilgisayar adını dev.com olarak ayarlayabilirsiniz.

    Üstbilgi değiştirme ilkesi

    Üstbilgi değiştirme özelliği isteği arka uç hizmetine iletmeden önce veya yanıtı istemciye döndürmeden önce istek üstbilgilerini değiştirmenize olanak tanır.

    Yordam

    Add Policy sayfasında Edit Header kartına tıklayın. Add Policy: Header Modification panelinde parametreleri yapılandırın.

    Parametre

    Açıklama

    Enable

    Üstbilgi değiştirme ilkesinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

    • Etkinleştir: Ağ geçidi bu ilkeye göre istek ve yanıt üstbilgilerini işler.

    • Devre Dışı Bırak: Ağ geçidi istek veya yanıt üstbilgilerini değiştirmez.

    Header Type

    Değiştirilecek üstbilgi türünü seçin.

    • Request: Gelen istemci isteğinin üstbilgilerini değiştirir.

    • Response: Arka uç hizmetinden giden yanıtın üstbilgilerini değiştirir.

    Operation Type

    Gerçekleştirilecek eylemi seçin.

    • Add: İsteğe veya yanıta bir üstbilgi ekler.

      Not

      Üstbilgi zaten varsa yeni değer mevcut değere virgül (,) ile ayrılarak eklenir.

    • Modify: İstekteki veya yanıttaki belirtilen bir üstbilgiyi değiştirir.

      Not

      • Belirtilen üstbilgi yoksa belirtilen Üstbilgi Anahtarı ve Üstbilgi Değeri ile eklenir.

      • Belirtilen üstbilgi varsa değeri üzerine yazılır.

    • Delete: İstekten veya yanıttan belirtilen bir üstbilgiyi siler.

    Üstbilgi Anahtarı

    İstek veya yanıt üstbilgisinin adı.

    Üstbilgi Değeri

    İstek veya yanıt üstbilgisinin değeri.

    CORS ilkesi

    Çapraz kaynak paylaşımı (CORS) bir web uygulaması sunucusunun çapraz kaynak erişimini kontrol etmesine ve güvenli veri aktarımına olanak tanıyan bir güvenlik özelliğidir. Cloud-native API Gateway API ve işlem düzeylerinde CORS ilkelerini destekler. Hangi alan adlarının ve istek yöntemlerinin kaynaklarınıza erişebileceğini belirtebilirsiniz.

    Önemli

    CORS ilkesi mock hizmetler için geçerli değildir. Test için gerçek bir arka uç hizmeti yapılandırmanız gerekir.

    Yordam

    Add Policy sayfasında CORS kartına tıklayın. Add Policy: CORS panelinde parametreleri yapılandırın.

    Parametre

    Açıklama

    Enable

    Sağ taraftaki Enable anahtarını açın.

    • Etkinleştir: Üçüncü taraf alan adlarının tarayıcıdan sunucu kaynaklarınıza erişmesine izin verir.

    • Devre Dışı Bırak: Tarayıcılardan gelen tüm çapraz kaynak isteklerini reddeder.

    Allowed Origins

    Sunucu kaynaklarınıza erişmesine izin verilen kaynaklar. Kurallar şöyledir:

    • Tüm kaynaklara izin vermek için * girin.

    • Belirli bir kök alan adından gelen kaynaklara izin vermek için *.example.com gibi bir değer girin.

    • Birden çok belirli kaynağa izin vermek için her kaynağı yeni bir satıra girin. Kaynak http:// veya https:// ile başlamalıdır.

    Not

    Bu parametre Access-Control-Allow-Origin üstbilgisine karşılık gelir. Bir istemci isteğinin Origin üstbilgisi izin verilen bir kaynakla eşleşirse yanıttaki Access-Control-Allow-Origin üstbilgisi istekteki Origin üstbilgisinin değeri olarak ayarlanır.

    Allowed Methods

    Çapraz kaynak erişimi için izin verilen HTTP yöntemleri. Yaygın yöntemler arasında GET, POST, PUT, DELETE, HEAD, OPTIONS ve PATCH bulunur.

    Not

    Bu parametre Access-Control-Allow-Methods üstbilgisine karşılık gelir.

    Trusted Request Headers

    Tarayıcıya yerleşik temel üstbilgilere ek olarak çapraz kaynak isteğinde izin verilen üstbilgiler. Kurallar şöyledir:

    • Tüm istek üstbilgilerine izin vermek için * girin.

    • Birden çok belirli üstbilgiye izin vermek için her üstbilgiyi yeni bir satıra girin.

    Not

    Bu parametre Access-Control-Allow-Headers üstbilgisine karşılık gelir.

    Trusted Response Headers

    Tarayıcılar ve JavaScript betikleri tarafından erişilebilen yanıt üstbilgileri. Kurallar şöyledir:

    • Tüm yanıt üstbilgilerine izin vermek için * girin.

    • Birden çok belirli üstbilgiye izin vermek için her üstbilgiyi yeni bir satıra girin.

    Not

    Bu parametre Access-Control-Expose-Headers üstbilgisine karşılık gelir.

    Allow to Carry Credentials

    Çapraz kaynak isteklerinde çerezler gibi kimlik bilgilerinin taşınmasına izin verilip verilmeyeceğini belirtir.

    Not

    Bu parametre Access-Control-Allow-Credentials üstbilgisine karşılık gelir.

    Precheck Expiration Time

    Bir ön uçuş OPTIONS isteğinin sonuçlarının tarayıcı tarafından önbelleğe alınabileceği maksimum süre (saniye cinsinden).

    Not

    Bu parametre Access-Control-Max-Age üstbilgisine karşılık gelir.

    Trafik çoğaltma ilkesi

    Trafik çoğaltma ilkesi canlı uygulama trafiğini belirtilen bir hizmete kopyalamanıza olanak tanır. Bu özellik uygulama performansını değerlendirmenize ve hataları gidermenize yardımcı olmak için simülasyon testi ve sorun teşhisi açısından kullanışlıdır.

    Yordam

    Add Policy sayfasında Mirror Traffic kartına tıklayın. Add Policy: Traffic Replication panelinde parametreleri yapılandırın.

    Parametre

    Açıklama

    Enable

    API veya işlem için trafik çoğaltma ilkesinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

    Destination Service

    Çoğaltılan trafiğin iletileceği hedef hizmet.

    Not

    Hedef hizmet HTTP veya HTTPS protokolünü kullanmalıdır.

    Port

    Hedef hizmetin bağlantı noktası. Dinamik bir bağlantı noktası da seçebilirsiniz.

    Not

    Dinamik bağlantı noktaları bağlantı noktası numarası dinamik olarak değişen hizmetler için uygundur ancak birden çok bağlantı noktasına sahip hizmetler için desteklenmez. Çoklu bağlantı noktalı hizmetler için dinamik bir bağlantı noktası seçmeyin.

    Traffic Mirror Percentage

    Çoğaltılacak trafik yüzdesi. Geçerli değerler: 0 ila 100.

    Not

    Bu parametreyi 50 olarak ayarlarsanız API veya işlemin trafiğinin %50'si hedef hizmete çoğaltılır.

    Zaman aşımı ilkesi

    Cloud-native API Gateway API ve işlem düzeylerinde zaman aşımı ayarları sağlar. Ağ geçidinin arka uç hizmetinden yanıt almak için bekleyeceği maksimum süreyi yapılandırabilirsiniz. Ağ geçidi belirtilen süre içinde yanıt almazsa istemciye HTTP 504 (Gateway Timeout) durum kodu döndürür.

    Yordam

    Add Policy sayfasında Timeout kartına tıklayın. Add Policy: Timeout panelinde parametreleri yapılandırın.

    Not

    Zaman aşımı ilkesini yapılandırdıktan ve etkinleştirdikten sonra kuralın hizmetiniz için beklendiği gibi etkili olduğunu doğrulayın.

    Parametre

    Açıklama

    Enable

    Zaman aşımı ilkesinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

    • Etkinleştir: API veya işlem için zaman aşımı ilkesi etkili olur.

    • Devre Dışı Bırak: API veya işlem için zaman aşımı ilkesi devre dışı bırakılır.

    Timeout Period

    API veya işlem için zaman aşımı süresi (saniye cinsinden).

    Not

    Bunu 0 olarak ayarlarsanız veya zaman aşımı ilkesini devre dışı bırakırsanız ağ geçidi yanıt için süresiz olarak bekler.

    Yeniden deneme ilkesi

    Cloud-native API Gateway başarısız istekleri otomatik olarak yeniden denemek için API ve işlem düzeylerinde yeniden deneme ayarları sağlar. Bağlantı hatası arka uç hizmetinin kullanılamaması veya belirli bir HTTP durum kodu gibi yeniden deneme koşullarını yapılandırabilirsiniz.

    API'ler ve işlemler için yeniden deneme koşulları

    Arka uç hizmeti bir 5xx hatası döndürdüğünde Cloud-native API Gateway yapılandırılan yeniden deneme sayısına göre başarısız isteği otomatik olarak yeniden dener.

    image

    • HTTP protokolü için yeniden deneme koşulları şöyledir:

      • 5xx: Arka uç hizmeti herhangi bir 5xx yanıtı döndürür veya bir bağlantı kopar ya da sıfırlanır veya bir okuma zaman aşımı oluşursa Cloud-native API Gateway başarısız isteği yeniden dener.

        Not

        5xx koşulu connect-failure ve refused-stream koşullarını içerir.

      • reset: Bir bağlantı kopar veya sıfırlanır veya bir okuma zaman aşımı oluşursa Cloud-native API Gateway başarısız isteği yeniden dener.

      • connect-failure: Bir bağlantı koptuğu için bir istek başarısız olursa Cloud-native API Gateway başarısız isteği yeniden dener.

      • refused-stream: Arka uç hizmeti bir akışı REFUSED_STREAM hata koduyla sıfırlarsa Cloud-native API Gateway başarısız isteği yeniden dener.

      • retriable-status-codes: Arka uç hizmetinden gelen yanıttaki HTTP durum kodu belirttiğiniz bir yeniden deneme durum koduyla eşleşirse Cloud-native API Gateway isteği yeniden dener.

        Not

        Yeniden deneme koşulu olarak retriable-status-codes seçtiğinizde yalnızca yeniden deneme durum kodlarını belirtebilirsiniz.

    • gRPC protokolü için yeniden deneme koşulları şöyledir:

      • cancelled: Arka uç gRPC hizmetinden gelen yanıt üstbilgisindeki gRPC durum kodu cancelled ise Cloud-native API Gateway isteği yeniden dener.

      • deadline-exceeded: Arka uç gRPC hizmetinden gelen yanıt üstbilgisindeki gRPC durum kodu deadline-exceeded ise Cloud-native API Gateway isteği yeniden dener.

      • internal: Arka uç gRPC hizmetinden gelen yanıt üstbilgisindeki gRPC durum kodu internal ise Cloud-native API Gateway isteği yeniden dener.

      • resource-exhausted: Arka uç gRPC hizmetinden gelen yanıt üstbilgisindeki gRPC durum kodu resource-exhausted ise Cloud-native API Gateway isteği yeniden dener.

      • unavailable: Arka uç gRPC hizmetinden gelen yanıt üstbilgisindeki gRPC durum kodu unavailable ise Cloud-native API Gateway isteği yeniden dener.

    Yordam

    Add Policy sayfasında Retry kartına tıklayın. Add Policy: Retry panelinde parametreleri yapılandırın.

    Not

    Yeniden deneme ilkesini yapılandırdıktan ve etkinleştirdikten sonra kuralın hizmetiniz için beklendiği gibi etkili olduğunu doğrulayın.

    Parametre

    Açıklama

    Enable

    Yeniden deneme ilkesinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

    • Etkinleştir: API veya işlem için yeniden deneme ilkesi etkili olur.

    • Devre Dışı Bırak: API veya işlem için yeniden deneme ilkesi devre dışı bırakılır.

      Yeniden denemeler devre dışı bırakıldığında ağ geçidinin varsayılan dahili bir yeniden deneme yapılandırması vardır. Varsayılan yeniden deneme sayısı 2'dir ve varsayılan yeniden deneme koşulları connect-failure, refused-stream, unavailable, cancelled veya retriable-status-codes şeklindedir.

    Retry Times

    Başarısız bir istek için maksimum yeniden deneme sayısı. Bu değeri 0 ila 10 arasında bir tamsayı olarak ayarlayabilirsiniz. 2 veya daha düşük bir değer önerilir.

    Bu parametreyi 0 olarak ayarlamak yeniden denemeleri devre dışı bırakır.

    Retry Condition

    Yeniden denemeyi tetikleyen koşulları seçin. Birden çok koşul seçebilirsiniz.

    Retry Status Code

    Yeniden denemeyi tetikleyen HTTP durum kodlarını belirtir. Birden çok durum kodu yapılandırabilirsiniz.

    Önemli

    Retry Status Code seçeneğini yalnızca Retry Condition için retriable-status-codes seçtiğinizde yapılandırabilirsiniz.

    Eklentiler

    1. Add Plug-in sekmesine tıklayın.

    2. Quick Navigation bölümünde bir eklenti türü seçin veya ada göre bir eklenti arayın ve ardından eklenti kartına tıklayın:

      • Eklenti yüklü değilse açılan iletişim kutusunda Install and Configure seçeneğine tıklayın. Sonraki iletişim kutusunda eklenti kurallarını yapılandırın ve etkinleştirin.

      • Eklenti zaten yüklüyse açılan iletişim kutusunda eklenti kurallarını yapılandırın ve etkinleştirin.

    3. API için ek listesi sayfasına dönmek için OK seçeneğine tıklayın. Burada işlemler için eklentilerin eklenme ve etkinleştirme durumunu görüntüleyebilirsiniz.

      Ek listesi bir akış şemasıdır. Frontend API, Inbound Processing, Backend Service ve Outbound Processing olmak üzere dört blok içerir. Bloklar arasındaki oklar istek akışını gösterir. Her işleme bloğu eklenen eklentileri listeler ve Enable Policy/Plug-in bağlantısına tıklayarak daha fazla eklenti ekleyebilirsiniz.