All Products
Search

This Product

    API Gateway:Buat entri rute

    Document Center

    API Gateway:Buat entri rute

    Last Updated:Jun 05, 2026

    Cloud-native API Gateway mengevaluasi aturan routing dari prioritas tertinggi ke terendah. Jika permintaan sesuai dengan suatu aturan, gerbang akan meneruskannya ke layanan backend yang dikonfigurasi. Jika tidak ada aturan yang cocok, gerbang mengembalikan error 404.

    Prioritas pencocokan entri rute

    Saat terdapat beberapa aturan routing, prioritasnya ditentukan sebagai berikut: Associated Domain Name > Path > Header > Query Parameters > Created At.

    1. Associated Domain Name: String domain yang lebih panjang memiliki prioritas lebih tinggi.

    2. Path:

      • Jika Match Rule berbeda, prioritasnya adalah: Equals To > Prefix > Regular Expression Match.

      • Jika Match Rule sama, nilai Path yang lebih panjang memiliki prioritas lebih tinggi.

    3. Header: Semakin banyak pasangan kunci-nilai, semakin tinggi prioritasnya.

    4. Query Parameters: Semakin banyak pasangan kunci-nilai, semakin tinggi prioritasnya.

    5. Created At: Waktu pembuatan yang lebih awal memiliki prioritas lebih tinggi.

    Prosedur

    Catatan

    • Entri rute mendukung HTTP/1.0, HTTP/1.1, HTTP/2.0, gRPC, dan WebSocket.

    • Entri rute hanya berlaku dalam cakupan instans tempat entri tersebut dibuat.

    1. Anda dapat membuat entri rute dari luar atau dalam instans gerbang.

      Di luar instans

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

      2. Klik API target, lalu pilih instans target atau All Instances dari daftar drop-down.image

      3. Klik Create Route.

      Di dalam instans

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

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

      3. Klik Create Route.

    2. Pada halaman Create Route, konfigurasikan parameter, lalu klik Save atau Save and Publish.

      Catatan

      • Kondisi pencocokan menggunakan logika AND. Semakin banyak kondisi, semakin sempit cakupan pencocokannya.

      • Prioritas entri rute mengikuti urutan tampilan pada halaman konfigurasi.

      Parameter

      Deskripsi

      Route Name

      Nama kustom untuk entri rute.

      Route Description

      Klik Add Route Description untuk menambahkan deskripsi entri rute.

      Domain Name

      • Pilih satu atau beberapa domain untuk dicocokkan.

      • Untuk menambahkan domain, klik Add Domain dan ikuti petunjuk di layar.

      Path

      Path permintaan yang akan dicocokkan.

      • Dengan aturan pencocokan yang sama, path yang lebih panjang memiliki prioritas lebih tinggi.

      • Dengan aturan pencocokan yang berbeda, prioritasnya adalah: Equals To > Prefix > Regular Expression Match.

        • Equals To: Mencocokkan path secara eksak, seperti /user.

        • Prefix: Mencocokkan awalan path, seperti path yang dimulai dengan /user.

        • Regular Expression Match: Mencocokkan pola ekspresi reguler.

      Method

      Metode HTTP yang akan dicocokkan. Anda dapat memilih beberapa metode. Default: ANY.

      Header

      Header permintaan yang akan dicocokkan.

      Query Parameters

      Parameter kueri yang akan dicocokkan.

      Instance

      Instans gerbang untuk entri rute ini.

      Scenario

      Jenis layanan backend untuk entri rute.

      • Skenario dasar: Single Service

      • Skema rilis canary: By Percentage (Multi-service), Tag (Tag-based Routing)

      • Skema lainnya: Mock, Redirect

      Jenis layanan backend dijelaskan dalam Routes.

      Catatan

      Total bobot lalu lintas untuk semua layanan backend harus mencapai 100%.

      Backend Services

      Layanan backend dan port tujuan penerusan permintaan oleh entri rute ini.

      Catatan

      • Klik Associated Service untuk memilih sumber dan layanan.

      • Jumlah maksimum sumber bergantung pada jenis sumbernya.

        • Container Service: hingga 5 sumber.

        • Nacos dan Zookeeper: hanya 1 sumber.

      Timeout Period (seconds)

      Waktu timeout permintaan dalam detik. Default: 60. Atur ke 0 untuk menonaktifkan timeout.

      Fallback

      Layanan yang menerima permintaan saat layanan backend utama tidak memiliki node yang tersedia.

      Catatan

      Fallback hanya didukung untuk layanan HTTP.

      Retry Times

      Jumlah percobaan ulang. Default: 2. Atur ke 0 untuk menonaktifkan percobaan ulang.

      Retry Condition

      Kondisi yang memicu percobaan ulang.

      Retry Status Code

      Kode status yang memicu percobaan ulang.