API Gateway:Konfigurasikan kebijakan retry

Kondisi retry

Ketika layanan backend mengembalikan error 5xx, Cloud-native API Gateway secara otomatis mencoba ulang permintaan hingga jumlah maksimum yang dikonfigurasi.

• Kondisi retry untuk protokol HTTP:

  • 5xx: Layanan backend mengembalikan respons 5xx, atau koneksi terputus, di-reset, atau timeout selama operasi baca.

    Catatan

    Kondisi 5xx mencakup kondisi connect-failure dan refused-stream.

  • reset: Koneksi terputus, di-reset, atau timeout selama operasi baca.

  • connect-failure: Permintaan gagal karena koneksi terputus.

  • refused-stream: Layanan backend me-reset aliran dengan kode kesalahan REFUSED_STREAM.

  • retriable-status-codes: Kode status HTTP dalam respons sesuai dengan kode status retry yang ditentukan.

    Catatan

    Anda hanya dapat menggunakan kode status retry jika retriable-status-codes ditentukan dalam kondisi retry.

• Kondisi retry untuk protokol gRPC:

  • cancelled: Kode status gRPC dalam header respons adalah cancelled.

  • deadline-exceeded: Kode status gRPC dalam header respons adalah deadline-exceeded.

  • internal: Kode status gRPC dalam header respons adalah internal.

  • resource-exhausted: Kode status gRPC dalam header respons adalah resource-exhausted.

  • unavailable: Kode status gRPC dalam header respons adalah unavailable.

Konfigurasikan kebijakan retry entri rute

1. Anda dapat mengonfigurasi kebijakan retry dengan dua cara, tergantung pada cara API Anda dikelola:

   API di luar instans

   1. Masuk ke Konsol Cloud-native API Gateway. Di panel navigasi sebelah kiri, klik API, lalu pilih wilayah dari bilah menu atas.

   2. Pada halaman HTTP API, gunakan daftar drop-down di bagian atas untuk memilih instans target. Anda dapat memilih instans tertentu atau All instances.

   3. Di Routes, klik entri rute target.

   API di dalam instans

   1. Masuk ke Konsol Cloud-native API Gateway. Di panel navigasi sebelah kiri, klik Instance, lalu pilih wilayah dari bilah menu atas.

   2. Pada halaman Instance, klik instans gerbang target. Di panel navigasi sebelah kiri, klik API, lalu klik API target.

   3. Di Routes, klik entri rute target.

2. Klik tab Configure Policy. Di bagian Inbound Processing, klik Enable Policy/Plug-in.

3. Klik kartu Retry. Di panel Add Policy: Retry, konfigurasikan parameter dan klik Add.

   Catatan

   Setelah mengonfigurasi dan mengaktifkan kebijakan retry, verifikasi bahwa kebijakan tersebut berfungsi sesuai harapan.

   Parameter	Deskripsi
   Enable	Mengaktifkan atau menonaktifkan kebijakan retry. Enabled: Kebijakan retry aktif. Disabled: Kebijakan retry tidak aktif. Catatan Jika kebijakan ini dinonaktifkan, gerbang menggunakan konfigurasi retry default. Jumlah retry default adalah 2, dan kondisi retry default adalah connect-failure, refused-stream, unavailable, cancelled, dan retriable-status-codes.
   Retry Times	Jumlah maksimum percobaan ulang untuk permintaan yang gagal. Nilai yang valid: 0 hingga 10. Disarankan menggunakan nilai 2 atau kurang. Catatan Nilai 0 menonaktifkan retry.
   Retry Condition	Kondisi yang memicu retry. Anda dapat memilih beberapa kondisi. Untuk informasi selengkapnya, lihat Kondisi retry.
   Retry Status Code	Kode status HTTP yang memicu retry. Anda dapat menentukan beberapa kode. Catatan Anda hanya dapat mengonfigurasi parameter Retry Status Code jika retriable-status-codes dipilih untuk Retry Condition.