All Products
Search

This Product

    API Gateway:Konfigurasikan kebijakan dan plugin

    Document Center

    API Gateway:Konfigurasikan kebijakan dan plugin

    Last Updated:Aug 06, 2026

    Cloud-native API Gateway memungkinkan Anda menambahkan kebijakan dan mengonfigurasi plugin untuk API dan operasinya guna meningkatkan keamanan, kinerja, serta kemudahan pemeliharaan.

    Penting

    • Perubahan kebijakan langsung berlaku tanpa perlu menerbitkan ulang API.

    • Secara default, gateway menerapkan konfigurasi plugin tingkat API pada tingkat operasi.

    • Meskipun kebijakan tingkat API tidak dapat dihapus pada tingkat operasi, kebijakan tingkat operasi dapat menggantikannya.

    Prosedur

    1. Anda dapat menambahkan kebijakan API melalui dua cara: dari luar instans atau dari dalam instans.

      API di luar instans

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

      2. Klik API yang dituju, lalu pilih instans yang diinginkan dari daftar drop-down.

      API di dalam instans

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

      2. Pada halaman Instance, klik ID instans gateway yang dituju. Di panel navigasi kiri, klik API, lalu klik API yang dituju.

    2. Anda dapat mengonfigurasi kebijakan dan plugin pada tingkat API atau tingkat operasi:

      • Tingkat API: Klik tab API Policy Configuration untuk mengonfigurasi kebijakan dan plugin untuk semua operasi pada tingkat API, lalu klik Enable Policy/Plug-in.

      • Tingkat operasi: Pada tab Operations, klik operasi yang dituju. Klik tab Policy Configuration, lalu klik Enable Policy/Plug-in.

    3. Pada panel Enable Policy/Plug-in, pilih kebijakan atau plugin yang akan dikonfigurasi. Untuk informasi lebih lanjut, lihat Konfigurasi kebijakan dan Konfigurasi plugin.

    Kebijakan

    Kebijakan pembatasan kecepatan

    Cloud-native API Gateway mendukung kebijakan pembatasan kecepatan pada tingkat API dan operasi. Kebijakan ini mencegah permintaan inbound membebani layanan backend Anda serta membantu menghindari kegagalan berantai. Dalam skenario konkurensi tinggi, pembatasan kecepatan melindungi ketersediaan layanan backend dengan memblokir sebagian permintaan, sehingga memungkinkan Anda mengontrol secara tepat jumlah permintaan untuk setiap API dan operasi dalam periode waktu tertentu agar tidak melebihi ambang batas yang telah ditetapkan.

    Kebijakan pembatasan kecepatan mencakup Kontrol Konkurensi, Kontrol Trafik, dan Pemutusan Sirkuit.

    • Kebijakan kontrol konkurensi: Kebijakan ini membatasi jumlah permintaan konkuren dengan menghitung total permintaan yang sedang diproses oleh gateway. Ketika jumlah tersebut mencapai ambang batas yang dikonfigurasi, gateway segera memblokir trafik baru. Anda dapat mengatur ambang batas ini sesuai dengan kapasitas maksimum permintaan konkuren yang dapat ditangani oleh layanan backend guna melindungi ketersediaannya selama lonjakan trafik.

      Prosedur

      Pada halaman Add Policy, klik kartu Concurrency Control. Pada panel Add Policy: Concurrency Control, konfigurasikan parameter berikut.

      Parameter

      Deskripsi

      Enable or Not

      Mengaktifkan aturan kontrol konkurensi.

      Overall Concurrency Threshold

      Tetapkan Overall Concurrency Threshold.

      Web Fallback Behavior

      Return Specific Content

      HTTP Status Code

      Tetapkan HTTP Status Code. Nilai default-nya adalah 429.

      Type of Returned Content

      Tetapkan Type of Returned Content menjadi Regular Text atau JSON.

      HTTP Text

      Isi badan respons kustom.

      Return Specific Content

      Redirect URL

      Masukkan Redirect URL.

    • Kebijakan kontrol trafik: Kebijakan ini membatasi laju permintaan berdasarkan permintaan per detik (QPS) dengan memantau QPS untuk suatu API atau operasi. Ketika QPS mencapai ambang batas yang dikonfigurasi, gateway segera memblokir trafik baru. Hal ini mencegah layanan backend kewalahan akibat lonjakan trafik mendadak dan memastikan ketersediaan tinggi.

      Prosedur

      Pada halaman Add Policy, klik kartu Traffic Control. Pada panel Add Policy: Traffic Control, konfigurasikan parameter berikut.

      Parameter

      Deskripsi

      Enable or Not

      Mengaktifkan aturan kontrol trafik.

      Overall QPS Threshold

      Tetapkan Overall QPS Threshold.

      Web Fallback Behavior

      Return Specific Content

      HTTP Status Code

      Tetapkan HTTP Status Code. Nilai default-nya adalah 429.

      Type of Returned Content

      Tetapkan Type of Returned Content menjadi Regular Text atau JSON.

      HTTP Text

      Isi badan respons kustom.

      Redirect to Specified Page

      Redirect URL

      Masukkan Redirect URL.

    • Kebijakan pemutusan sirkuit: Kebijakan ini melindungi layanan backend dengan memantau waktu respons atau laju kesalahan API dan operasi. Ketika ambang batas tertentu tercapai, gateway "memutus sirkuit" dan segera gagal cepat (fail fast) pada permintaan ke layanan yang tidak stabil untuk mencegah beban tambahan. Setelah durasi yang dikonfigurasi berlalu, gateway memasuki status "setengah terbuka" (half-open) dan mengizinkan sejumlah terbatas permintaan uji untuk memverifikasi apakah layanan telah pulih. Jika layanan stabil, sirkuit ditutup; jika tidak, sirkuit diputus lagi.

      Status pemutusan sirkuit dikelola secara independen oleh setiap node gateway. Setiap node menghitung permintaan serta rasio panggilan lambat atau rasio pengecualian secara mandiri, sehingga ambang batas pemutusan sirkuit berlaku per node, bukan agregat di seluruh kluster. Saat mengonfigurasi Minimum Number of Requests, Statistical Window Duration, dan ambang batas rasio pemutusan sirkuit, perlu diingat bahwa nilai-nilai tersebut berlaku untuk statistik lokal satu node, bukan untuk seluruh kluster gateway.

      Prosedur

      Pada halaman Add Policy, klik kartu Circuit Breaking. Pada panel Add Policy: Circuit Breaking, konfigurasikan parameter berikut.

      Parameter

      Deskripsi

      Enable or Not

      Mengaktifkan aturan pemutusan sirkuit.

      Statistical Window Duration

      Lamanya jendela waktu untuk mengumpulkan statistik. Nilai valid: 1 detik hingga 120 menit.

      Minimum Number of Requests

      Jumlah minimum permintaan dalam jendela statistik yang diperlukan untuk memicu pemutusan sirkuit. Jika jumlah permintaan di bawah nilai ini, pemutus sirkuit tidak akan aktif, meskipun ambang kesalahan terpenuhi.

      Threshold Type

      Pilih salah satu dari Slow Call Ratio (%) atau Exception Ratio (%) sebagai jenis ambang batas.

      1. Jika Anda memilih Slow Call Ratio (%), Anda harus menetapkan Slow Call RT (waktu respons maksimum). Permintaan dihitung sebagai panggilan lambat jika waktu responsnya melebihi nilai ini. Saat aturan diaktifkan, jika jumlah permintaan dalam jendela statistik lebih besar dari jumlah permintaan minimum, dan persentase panggilan lambat melebihi ambang batas, sirkuit diputus. Setelah durasi pemutusan sirkuit berlalu, pemutus sirkuit memasuki status pemulihan probing (half-open). Jika waktu respons permintaan uji berikutnya kurang dari Slow Call RT yang ditentukan, sirkuit ditutup. Jika tidak, sirkuit diputus lagi.

      2. Jika Anda memilih Exception Ratio (%), Anda harus menetapkan ambang batas persentase kesalahan. Saat aturan diaktifkan, jika jumlah permintaan dalam jendela statistik lebih besar dari jumlah permintaan minimum, dan persentase kesalahan melebihi ambang batas, sirkuit diputus selama durasi yang dikonfigurasi.

      Slow Call RT

      Tetapkan Slow Call RT yang diizinkan (yaitu, waktu respons maksimum).

      Circuit Breaking Ratio Threshold

      Persentase panggilan lambat atau kesalahan yang memicu pemutusan sirkuit. Nilai valid: 0 hingga 100 (mewakili 0% hingga 100%).

      Circuit Breaking Duration (s)

      Durasi sirkuit tetap terbuka setelah diputus. Selama periode ini, semua permintaan ke resource akan gagal cepat (fail fast).

      Web Fallback Behavior

      Return Specific Content

      HTTP Status Code

      Tetapkan HTTP Status Code. Nilai default-nya adalah 429.

      Type of Returned Content

      Tetapkan Type of Returned Content menjadi Regular Text atau JSON.

      HTTP Text

      Isi badan respons kustom.

      Redirect to Specified Page

      Redirect URL

      Masukkan Redirect URL.

    Kebijakan penulisan ulang

    Kebijakan penulisan ulang memungkinkan Anda memodifikasi path dan hostname permintaan sebelum meneruskannya ke layanan backend, sehingga memastikan permintaan diarahkan ke layanan atau titik akhir yang sesuai dengan kebutuhan bisnis dan arsitektur tertentu.

    Prosedur

    Pada halaman Add Policy, klik HTTP Rewrite untuk membuka panel Add Policy: HTTP Rewrite dan konfigurasikan parameter berikut.

    • Penulisan ulang path

      Cloud-native API Gateway mendukung dua mode penulisan ulang path.

      • Exact Rewrite: Hanya mendukung penulisan ulang tingkat operasi.

      • Regex Rewrite: Mendukung penulisan ulang tingkat operasi maupun tingkat API.

      Exact rewrite

      Exact rewrite memungkinkan Anda memodifikasi awalan dari path permintaan asli.

      Contoh 1

      Path permintaan asli adalah /app/test, tetapi path yang diteruskan ke layanan backend seharusnya /test. Kami merekomendasikan konfigurasi berikut:

      • Kondisi pencocokan API dan operasi: Tetapkan jenis pencocokan ke Exact Match dan path ke /app/.

      • Penulisan ulang: Tetapkan jenis penulisan ulang ke Exact Rewrite dan path ke /.

      Catatan

      Path untuk kondisi pencocokan API dan operasi harus diatur ke /app/ karena exact rewrite hanya memodifikasi string yang dicocokkan secara eksak. Jika path diatur ke /app, path hasil penulisan ulang akan salah menjadi //test.

      Contoh 2

      Path permintaan asli adalah /v1/test, tetapi path yang diteruskan ke layanan backend seharusnya /v2/test. Kami merekomendasikan konfigurasi berikut:

      • Kondisi pencocokan API dan operasi: Tetapkan jenis pencocokan ke Exact Match dan path ke /v1.

      • Penulisan ulang: Tetapkan jenis penulisan ulang ke Exact Rewrite dan path ke /v2.

      Penting

      Exact rewrite mengharuskan metode pencocokan API atau operasi diatur ke Exact Match. Prefix Match dan Regex Match tidak mendukung exact rewrite. Exact rewrite berlaku untuk semua permintaan dengan awalan yang ditentukan. Jika ini bukan tujuan Anda, gunakan metode penulisan ulang lainnya.

      Regex rewrite

      Regex rewrite memungkinkan Anda memodifikasi bagian-bagian dari path permintaan asli. Konfigurasi regex rewrite terdiri dari dua bagian: pola untuk mencocokkan bagian path yang ingin diubah, dan string pengganti untuk menggantikan bagian yang cocok. Untuk informasi lebih lanjut tentang sintaks ekspresi reguler, lihat RE2 Syntax.

      Contoh 1

      Path permintaan asli adalah /aaa/one/bbb/one/ccc, tetapi path yang diteruskan ke layanan backend seharusnya /aaa/two/bbb/two/ccc. Kami merekomendasikan konfigurasi berikut:

      • Kondisi pencocokan API dan operasi: Tetapkan jenis pencocokan ke Exact Match dan path ke /aaa/one/bbb/one/ccc.

      • Penulisan ulang: Tetapkan jenis penulisan ulang ke Regex Rewrite, pola ke one, dan string pengganti ke two.

      Contoh 2

      Path permintaan asli adalah /httpbin/(.*)/(.*). Anda ingin menghapus awalan /httpbin dan menukar posisi dua segmen path yang ditangkap. Kami merekomendasikan konfigurasi berikut:

      • Kondisi pencocokan API dan operasi: Tetapkan jenis pencocokan ke Regex Match dan path ke /httpbin/(.*)/(.*).

      • Penulisan ulang: Tetapkan jenis penulisan ulang ke Regex Rewrite, pola ke /httpbin/(.*)/(.*), dan string pengganti ke /\2/\1. Di sini, \1 merepresentasikan grup tangkapan pertama, dan \2 merepresentasikan grup kedua. Ini mirip dengan variabel $1 dan $2 di Nginx.

      Contoh 3

      Untuk REST API yang menggunakan versioning berbasis path, Anda mungkin ingin menghapus segmen versi dari path sebelum meneruskan permintaan ke backend. Misalnya, jika path aslinya adalah /basePath/version/order/get dan path backend yang diinginkan adalah /basePath/order/get, kami merekomendasikan konfigurasi berikut:

      • Gunakan konfigurasi kebijakan API.

      • Penulisan ulang: Tetapkan jenis penulisan ulang ke Regex Rewrite, pola ke (/.*)/version(/.*), dan string pengganti ke \1\2. Di sini, \1 merepresentasikan grup tangkapan pertama dan \2 merepresentasikan grup kedua, mirip dengan $1 dan $2 di Nginx.

      Catatan

      Regex rewrite adalah fitur lanjutan dengan sintaks kompleks, biasanya digunakan untuk kasus-kasus khusus.

    • Penulisan ulang hostname

      Cloud-native API Gateway mendukung exact rewrite untuk hostname permintaan.

      Sebagai contoh, jika header Host permintaan asli adalah test.com tetapi layanan backend mengharapkan dev.com, Anda dapat mengatur hostname penulisan ulang menjadi dev.com dalam kebijakan penulisan ulang.

    Kebijakan modifikasi header

    Fitur modifikasi header memungkinkan Anda mengubah header permintaan sebelum diteruskan ke layanan backend, atau dalam respons sebelum dikembalikan ke klien.

    Prosedur

    Pada halaman Add Policy, klik kartu Edit Header. Pada panel Add Policy: Header Modification, konfigurasikan parameter berikut.

    Parameter

    Deskripsi

    Enable

    Menentukan apakah kebijakan modifikasi header diaktifkan.

    • Aktifkan: Gateway memproses header permintaan dan respons berdasarkan kebijakan ini.

    • Nonaktifkan: Gateway tidak memodifikasi header permintaan atau respons.

    Header Type

    Pilih jenis header yang akan dimodifikasi.

    • Request: Memodifikasi header permintaan klien masuk.

    • Response: Memodifikasi header respons keluar dari layanan backend.

    Operation Type

    Pilih aksi yang akan dilakukan.

    • Add: Menambahkan header ke permintaan atau respons.

      Catatan

      Jika header sudah ada, nilai baru akan ditambahkan ke nilai yang ada, dipisahkan oleh koma (,).

    • Modify: Memodifikasi header tertentu dalam permintaan atau respons.

      Catatan

      • Jika header yang ditentukan tidak ada, header tersebut akan ditambahkan dengan Header Key dan Header Value yang ditentukan.

      • Jika header yang ditentukan ada, nilainya akan ditimpa.

    • Delete: Menghapus header tertentu dari permintaan atau respons.

    Header Key

    Nama header permintaan atau respons.

    Header Value

    Nilai header permintaan atau respons.

    Kebijakan CORS

    Cross-origin resource sharing (CORS) adalah fitur keamanan yang memungkinkan server aplikasi web mengontrol akses lintas asal, sehingga memungkinkan transfer data yang aman. Cloud-native API Gateway mendukung kebijakan CORS pada tingkat API dan operasi. Anda dapat menentukan domain dan metode permintaan mana yang dapat mengakses resource Anda.

    Penting

    Kebijakan CORS tidak berlaku untuk layanan mock. Anda harus mengonfigurasi layanan backend aktual untuk pengujian.

    Prosedur

    Pada halaman Add Policy, klik kartu CORS. Pada panel Add Policy: CORS, konfigurasikan parameter berikut.

    Parameter

    Deskripsi

    Enable

    Nyalakan sakelar Enable di sebelah kanan.

    • Aktifkan: Mengizinkan domain pihak ketiga mengakses resource server Anda dari browser.

    • Nonaktifkan: Menolak semua permintaan lintas asal dari browser.

    Allowed Origins

    Asal yang diizinkan mengakses resource server Anda. Aturannya sebagai berikut:

    • Untuk mengizinkan semua asal, masukkan *.

    • Untuk mengizinkan asal dari domain root tertentu, masukkan nilai seperti *.example.com.

    • Untuk mengizinkan beberapa asal tertentu, masukkan setiap asal pada baris baru. Asal harus diawali dengan http:// atau https://.

    Catatan

    Parameter ini berkorespondensi dengan header Access-Control-Allow-Origin. Jika header Origin dari permintaan klien cocok dengan asal yang diizinkan, header Access-Control-Allow-Origin dalam respons akan diatur ke nilai header Origin permintaan tersebut.

    Allowed Methods

    Metode HTTP yang diizinkan untuk akses lintas asal. Metode umum meliputi GET, POST, PUT, DELETE, HEAD, OPTIONS, dan PATCH.

    Catatan

    Parameter ini berkorespondensi dengan header Access-Control-Allow-Methods.

    Trusted Request Headers

    Header yang diizinkan dalam permintaan lintas asal, selain header dasar yang dibawa browser. Aturannya sebagai berikut:

    • Untuk mengizinkan semua header permintaan, masukkan *.

    • Untuk mengizinkan beberapa header tertentu, masukkan setiap header pada baris baru.

    Catatan

    Parameter ini berkorespondensi dengan header Access-Control-Allow-Headers.

    Trusted Response Headers

    Header respons yang dapat diakses oleh browser dan skrip JavaScript. Aturannya sebagai berikut:

    • Untuk mengizinkan semua header respons, masukkan *.

    • Untuk mengizinkan beberapa header tertentu, masukkan setiap header pada baris baru.

    Catatan

    Parameter ini berkorespondensi dengan header Access-Control-Expose-Headers.

    Allow to Carry Credentials

    Menentukan apakah kredensial, seperti cookie, diizinkan dalam permintaan lintas asal.

    Catatan

    Parameter ini berkorespondensi dengan header Access-Control-Allow-Credentials.

    Precheck Expiration Time

    Waktu maksimum, dalam detik, hasil permintaan preflight OPTIONS dapat di-cache oleh browser.

    Catatan

    Parameter ini berkorespondensi dengan header Access-Control-Max-Age.

    Kebijakan replikasi trafik

    Kebijakan replikasi trafik memungkinkan Anda menyalin trafik aplikasi langsung ke layanan tertentu. Fitur ini berguna untuk pengujian simulasi dan diagnosis masalah, guna membantu Anda mengevaluasi kinerja aplikasi dan memecahkan kegagalan.

    Prosedur

    Pada halaman Add Policy, klik kartu Mirror Traffic. Pada panel Add Policy: Traffic Replication, konfigurasikan parameter berikut.

    Parameter

    Deskripsi

    Enable

    Menentukan apakah kebijakan replikasi trafik diaktifkan untuk API atau operasi.

    Destination Service

    Layanan tujuan tempat trafik yang direplikasi diteruskan.

    Catatan

    Layanan tujuan harus menggunakan protokol HTTP atau HTTPS.

    Port

    Port layanan tujuan. Anda juga dapat memilih port dinamis.

    Catatan

    Port dinamis cocok untuk layanan yang nomor port-nya berubah secara dinamis tetapi tidak didukung untuk layanan dengan beberapa port. Jangan pilih port dinamis untuk layanan multi-port.

    Traffic Mirror Percentage

    Persentase trafik yang direplikasi. Nilai valid: 0 hingga 100.

    Catatan

    Jika Anda mengatur parameter ini ke 50, 50% trafik untuk API atau operasi direplikasi ke layanan tujuan.

    Kebijakan timeout

    Cloud-native API Gateway menyediakan pengaturan timeout pada tingkat API dan operasi. Anda dapat mengonfigurasi waktu maksimum yang ditunggu gateway untuk respons dari layanan backend. Jika gateway tidak menerima respons dalam waktu yang ditentukan, gateway akan mengembalikan kode status HTTP 504 (Gateway Timeout) ke klien.

    Prosedur

    Pada halaman Add Policy, klik kartu Timeout. Pada panel Add Policy: Timeout, konfigurasikan parameter berikut.

    Catatan

    Setelah Anda mengonfigurasi dan mengaktifkan kebijakan timeout, verifikasi bahwa aturan tersebut berlaku sebagaimana diharapkan untuk layanan Anda.

    Parameter

    Deskripsi

    Enable

    Menentukan apakah kebijakan timeout diaktifkan.

    • Aktifkan: Kebijakan timeout untuk API atau operasi berlaku.

    • Nonaktifkan: Kebijakan timeout untuk API atau operasi dinonaktifkan.

    Timeout Period

    Durasi timeout untuk API atau operasi, dalam detik.

    Catatan

    Jika Anda mengatur nilai ini ke 0 atau menonaktifkan kebijakan timeout, gateway akan menunggu respons tanpa batas waktu.

    Kebijakan Coba Lagi

    Cloud-native API Gateway menyediakan pengaturan retry pada tingkat API dan operasi untuk secara otomatis mencoba ulang permintaan yang gagal. Anda dapat mengonfigurasi kondisi retry, seperti memicu retry saat terjadi kegagalan koneksi, layanan backend tidak tersedia, atau kode status HTTP tertentu.

    Kondisi retry untuk API dan operasi

    Saat layanan backend mengembalikan kesalahan 5xx, Cloud-native API Gateway secara otomatis mencoba ulang permintaan yang gagal sesuai dengan jumlah retry yang dikonfigurasi.

    • Kondisi retry untuk protokol HTTP adalah sebagai berikut:

      • 5xx: Jika layanan backend mengembalikan respons 5xx apa pun, atau jika koneksi terputus atau di-reset, atau jika terjadi timeout baca, Cloud-native API Gateway mencoba ulang permintaan yang gagal.

        Catatan

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

      • reset: Jika koneksi terputus atau di-reset, atau jika terjadi timeout baca, Cloud-native API Gateway mencoba ulang permintaan yang gagal.

      • connect-failure: Jika permintaan gagal karena koneksi terputus, Cloud-native API Gateway mencoba ulang permintaan yang gagal.

      • refused-stream: Jika layanan backend mereset aliran dengan kode kesalahan REFUSED_STREAM, Cloud-native API Gateway mencoba ulang 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 mencoba ulang permintaan tersebut.

        Catatan

        Anda hanya dapat menentukan kode status retry jika memilih retriable-status-codes sebagai kondisi retry.

    • Kondisi retry untuk protokol gRPC adalah sebagai berikut:

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

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

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

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

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

    Prosedur

    Pada halaman Add Policy, klik kartu Retry. Pada panel Add Policy: Retry, konfigurasikan parameter berikut.

    Catatan

    Setelah Anda mengonfigurasi dan mengaktifkan kebijakan retry, verifikasi bahwa aturan tersebut berlaku sebagaimana diharapkan untuk layanan Anda.

    Parameter

    Deskripsi

    Enable

    Menentukan apakah kebijakan retry diaktifkan.

    • Aktifkan: Kebijakan retry untuk API atau operasi berlaku.

    • Nonaktifkan: Kebijakan retry untuk API atau operasi dinonaktifkan.

      Saat retry dinonaktifkan, gateway memiliki konfigurasi retry internal default. Jumlah retry default adalah 2, dan kondisi retry default adalah connect-failure, refused-stream, unavailable, cancelled, atau retriable-status-codes.

    Retry Times

    Jumlah maksimum retry untuk permintaan yang gagal. Anda dapat mengatur nilai ini ke bilangan bulat antara 0 hingga 10. Kami merekomendasikan nilai 2 atau kurang.

    Mengatur parameter ini ke 0 akan menonaktifkan retry.

    Retry Condition

    Pilih kondisi yang memicu retry. Anda dapat memilih beberapa kondisi.

    Retry Status Code

    Menentukan kode status HTTP yang memicu retry. Anda dapat mengonfigurasi beberapa kode status.

    Penting

    Anda hanya dapat mengonfigurasi Retry Status Code jika memilih retriable-status-codes untuk Retry Condition.

    Plugin

    1. Klik tab Add Plug-in.

    2. Pada bagian Quick Navigation, pilih jenis plugin atau cari plugin berdasarkan nama, lalu klik kartu plugin tersebut:

      • Jika plugin belum diinstal, klik Install and Configure di kotak dialog pop-up. Pada kotak dialog berikutnya, konfigurasikan aturan plugin dan aktifkan.

      • Jika plugin sudah diinstal, konfigurasikan aturan plugin dan aktifkan di kotak dialog pop-up.

    3. Klik OK untuk kembali ke daftar lampiran untuk API, tempat Anda dapat melihat status lampiran dan pengaktifan plugin untuk operasi.

      Daftar lampiran berupa bagan alir yang mencakup empat blok: Frontend API, Inbound Processing, Backend Service, dan Outbound Processing. Panah antar blok menunjukkan alur permintaan. Setiap blok pemrosesan mencantumkan plugin yang dilampirkan, dan Anda dapat menambahkan lebih banyak dengan mengklik tautan Enable Policy/Plug-in.