API Gateway：Konfigurasikan kebijakan retry

Kondisi retry

Saat layanan backend mengembalikan error 5xx, Cloud-native API Gateway secara otomatis melakukan retry terhadap permintaan yang gagal sesuai dengan jumlah maksimum retry yang ditentukan.

• Kondisi retry HTTP Protocol:

  • 5xx: Jika layanan backend mengembalikan respons 5xx apa pun, atau jika koneksi terputus, di-reset, atau timeout selama operasi baca, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan yang gagal.

    Catatan

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

  • reset: Jika koneksi terputus, di-reset, atau timeout selama operasi baca, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan yang gagal.

  • connect-failure: Jika permintaan gagal karena koneksi terputus, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan yang gagal.

  • refused-stream: Jika layanan backend mereset aliran dengan kode kesalahan REFUSED_STREAM, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan yang gagal.

  • retriable-status-codes: Jika kode status HTTP dalam respons dari layanan backend cocok dengan kode status retry yang Anda tentukan, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan tersebut.

    Catatan

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

• Kondisi retry GRPC Protocol:

  • cancelled: Jika kode status gRPC dalam header respons dari layanan gRPC backend adalah cancelled, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan tersebut.

  • deadline-exceeded: Jika kode status gRPC dalam header respons dari layanan gRPC backend adalah deadline-exceeded, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan tersebut.

  • internal: Jika kode status gRPC dalam header respons dari layanan gRPC backend adalah internal, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan tersebut.

  • resource-exhausted: Jika kode status gRPC dalam header respons dari layanan gRPC backend adalah resource-exhausted, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan tersebut.

  • unavailable: Jika kode status gRPC dalam header respons dari layanan gRPC backend adalah unavailable, Cloud-native API Gateway akan mencoba melakukan retry terhadap permintaan tersebut.

Konfigurasikan kebijakan retry

1. Cloud-native API Gateway menyediakan dua cara untuk mengonfigurasi kebijakan retry: di luar instans dan di dalam instans:

   API di luar instans

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

   2. Klik API target. Anda dapat memilih instans tempat Anda ingin mengonfigurasi kebijakan retry dari daftar drop-down, atau pilih All Instances.

   3. Pilih entri rute target dari Route List.

   API di dalam instans

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

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

   3. Pada tab Routes, pilih entri rute target.

2. Klik tab Policy Configuration, lalu klik Enable Policy/Plug-in di bagian Inbound Processing.

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

   Catatan

   Setelah kebijakan retry dibuat dan diaktifkan, Anda dapat memverifikasi apakah kebijakan tersebut berfungsi sesuai kebutuhan bisnis Anda.

   Parameter	Description
   Enable	Menentukan apakah kebijakan retry diaktifkan atau tidak. Jika Anda mengaktifkan sakelar ini, kebijakan retry akan berlaku. Jika Anda menonaktifkan sakelar ini, kebijakan retry tidak berlaku. Catatan Jika Anda menonaktifkan retry, gateway akan menggunakan konfigurasi retry default. Jumlah maksimum retry default adalah 2, dan kondisi retry default adalah connect-failure, refused-stream, unavailable, cancelled, dan retriable-status-codes.
   Retry Times	Jumlah maksimum retry untuk permintaan yang gagal. Anda dapat mengatur parameter ini ke bilangan bulat antara 0 hingga 10. Kami menyarankan agar Anda mengatur parameter ini ke 0, 1, atau 2. Catatan Jika parameter ini diatur ke 0, permintaan yang gagal tidak akan di-retry.
   Retry Interval (s)	Kondisi yang memicu retry. Anda dapat memilih satu atau beberapa kondisi. Untuk informasi selengkapnya, lihat Retry conditions.
   Retry Status Code	Kode status HTTP yang memicu retry. Anda dapat menentukan satu atau beberapa kode status HTTP. Catatan Anda hanya dapat mengonfigurasi Retry Status Code jika Anda menentukan retriable-status-codes dalam Retry Condition.