API Gateway:Configure a retry policy

Yeniden deneme koşulları

Arka uç hizmeti bir 5xx hatası döndürdüğünde, Cloud-native API Gateway isteği yapılandırılan sayıya kadar otomatik olarak yeniden dener.

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

  • 5xx: Arka uç hizmeti bir 5xx yanıtı döndürür veya bir okuma işlemi sırasında bağlantı kesilir, sıfırlanır ya da zaman aşımına uğrar.

    Not

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

  • reset: Bir okuma işlemi sırasında bağlantı kesilir, sıfırlanır veya zaman aşımına uğrar.

  • connect-failure: Bağlantı koptuğu için bir istek başarısız olur.

  • refused-stream: Arka uç hizmeti, bir akışı REFUSED_STREAM hata koduyla sıfırlar.

  • retriable-status-codes: Yanıttaki HTTP durum kodu, belirtilen bir yeniden deneme durum koduyla eşleşir.

    Not

    Yeniden deneme durum kodlarını yalnızca yeniden deneme koşulunda retriable-status-codes belirtildiğinde kullanabilirsiniz.

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

  • cancelled: Yanıt başlığındaki gRPC durum kodu cancelled değerindedir.

  • deadline-exceeded: Yanıt başlığındaki gRPC durum kodu deadline-exceeded değerindedir.

  • internal: Yanıt başlığındaki gRPC durum kodu internal değerindedir.

  • resource-exhausted: Yanıt başlığındaki gRPC durum kodu resource-exhausted değerindedir.

  • unavailable: Yanıt başlığındaki gRPC durum kodu unavailable değerindedir.

Rota yeniden deneme ilkesi yapılandırma

1. API'nizin nasıl yönetildiğine bağlı olarak iki şekilde yeniden deneme ilkesi yapılandırabilirsiniz:

   Instance dışındaki API

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

   2. HTTP API sayfasında, üstteki açılır listeyi kullanarak hedef instance'ı seçin. Belirli bir instance'ı veya All instances seçeneğini belirleyebilirsiniz.

   3. Routes bölümünde hedef rotayı tıklayın.

   Instance içindeki API

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

   2. Instance sayfasında hedef ağ geçidi instance'ını tıklayın. Sol gezinme bölmesinde API öğesine tıklayın ve ardından hedef API'yi seçin.

   3. Routes bölümünde hedef rotayı tıklayın.

2. Configure Policy sekmesine tıklayın. Inbound Processing bölümünde Enable Policy/Plug-in seçeneğine tıklayın.

3. Retry kartına tıklayın. Add Policy: Retry panelinde parametreleri yapılandırın ve Add düğmesine tıklayın.

   Not

   Yeniden deneme ilkesini yapılandırdıktan ve etkinleştirdikten sonra beklendiği gibi çalıştığını doğrulayın.

   Parametre	Açıklama
   Enable	Yeniden deneme ilkesini etkinleştirir veya devre dışı bırakır. Enabled: Yeniden deneme ilkesi etkindir. Disabled: Yeniden deneme ilkesi devre dışıdır. Not Bu ilke devre dışı bırakılırsa ağ geçidi varsayılan bir yeniden deneme yapılandırması kullanır. Varsayılan yeniden deneme sayısı 2'dir ve varsayılan yeniden deneme koşulları şunlardır: connect-failure, refused-stream, unavailable, cancelled ve retriable-status-codes.
   Retry Times	Başarısız bir istek için maksimum yeniden deneme sayısı. Geçerli değerler: 0 ile 10. 2 veya daha düşük bir değer önerilir. Not 0 değeri yeniden denemeleri devre dışı bırakır.
   Retry Condition	Yeniden denemeyi tetikleyen koşullar. Birden fazla koşul seçebilirsiniz. Daha fazla bilgi için bkz. Yeniden deneme koşulları.
   Retry Status Code	Yeniden denemeyi tetikleyen HTTP durum kodları. Birden fazla kod belirtebilirsiniz. Not Retry Status Code parametresini yalnızca Retry Condition için retriable-status-codes seçildiğinde yapılandırabilirsiniz.