All Products
Search

This Product

    API Gateway:Buat rute

    Document Center

    API Gateway:Buat rute

    Last Updated:Sep 08, 2026

    Saat Cloud-native API Gateway memproses permintaan masuk, gateway mengevaluasi aturan rute yang dikonfigurasi berdasarkan urutan prioritas menurun. Jika permintaan sesuai dengan suatu aturan, gateway meneruskannya ke layanan backend yang ditentukan dalam aturan tersebut. Jika tidak ada aturan yang cocok, gateway mengembalikan error 404.

    Prioritas pencocokan rute

    Aturan prioritasnya adalah sebagai berikut: Associated Domain Name > Path > Header > Query Parameters > Created At.

    1. Berdasarkan Associated Domain Name: Semakin panjang string domain, semakin tinggi prioritasnya.

    2. Berdasarkan Path:

      • Untuk tipe Match Rule yang berbeda, prioritasnya adalah: Equals To > Prefix > Regular Expression Match.

      • Untuk tipe Match Rule yang sama, string Path yang lebih panjang memiliki prioritas lebih tinggi.

    3. Berdasarkan jumlah total pasangan kunci-nilai dalam Header: Semakin banyak pasangan, semakin tinggi prioritasnya.

    4. Berdasarkan jumlah total pasangan kunci-nilai dalam Query Parameters: Semakin banyak pasangan, semakin tinggi prioritasnya.

    5. Berdasarkan Created At: Semakin awal waktu pembuatan, semakin tinggi prioritasnya.

    Aturan rute dari semua API dalam instans yang sama diurutkan bersama selama pencocokan dan dievaluasi berdasarkan prioritas di atas. Rute yang berasal dari API berbeda mengikuti aturan yang sama selama tidak saling bertentangan.

    Catatan

    Saat REST API dipublikasikan sebagai rute prefix, gateway tidak menghasilkan satu rute per operasi API. Seluruh API digabung menjadi satu rute prefix yang mencocokkan permintaan berdasarkan base path efektif API tersebut, sehingga rute tersebut ikut serta dalam aturan prioritas di atas sebagai rute dengan pencocokan prefix: string path yang lebih panjang memiliki prioritas lebih tinggi, dan pencocokan eksak didahulukan dibandingkan pencocokan prefix, yang pada gilirannya didahulukan dibandingkan pencocokan ekspresi reguler.

    Saat rute yang dihasilkan oleh REST API, HTTP API, dan WebSocket API berada dalam satu gateway dan nama domain yang sama, gateway terlebih dahulu mencocokkan rute REST API biasa, lalu rute HTTP API dan WebSocket API, dan terakhir REST API yang dipublikasikan sebagai rute prefix. Jika cakupan pencocokan rute HTTP API atau WebSocket API tumpang tindih dengan REST API yang dipublikasikan sebagai rute prefix, rute HTTP API atau WebSocket API yang sepenuhnya cocok akan didahulukan.

    Prosedur

    Catatan

    • Konfigurasi rute mendukung rangkaian protokol HTTP, termasuk HTTP/1.0, HTTP/1.1, HTTP/2.0, gRPC, dan WebSocket.

    • Rute yang dibuat dalam suatu instans hanya terlihat dan dapat dikelola dalam instans tersebut.

    1. Cloud-native API Gateway menyediakan dua cara untuk membuat rute: dari luar instans atau dari dalam instans.

      Outside instance

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

      2. Klik API target. Di daftar tarik-turun yang muncul, pilih instans tempat rute akan dikonfigurasi, atau pilih All Instances. Dari menu tarik-turun All Instances di bagian atas, pilih instans target.

      3. Klik Create Route.

      Inside instance

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

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

      3. Klik Create Route.

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

      Catatan

      • Aturan pencocokan digabungkan menggunakan logika AND. Semakin banyak aturan yang Anda tentukan, semakin sempit cakupan pencocokannya.

      • Prioritas pencocokan rute sesuai dengan urutan tampilannya di halaman konfigurasi rute.

      Parameter

      Deskripsi

      Route Name

      Masukkan nama kustom untuk rute.

      Route Description

      Klik Add Route Description untuk memasukkan deskripsi rute.

      Domain Name

      • Pilih satu atau beberapa domain agar rute dapat dicocokkan.

      • Untuk membuat domain baru, klik Add Domain dan buat di panel yang muncul.

      Path

      Menentukan parameter path dalam permintaan HTTP untuk dicocokkan.

      • Untuk tipe aturan pencocokan yang sama, string path yang lebih panjang memiliki prioritas lebih tinggi.

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

        • Equals To: Path permintaan harus persis sama. Misalnya, harus tepat /user.

        • Prefix: Path permintaan harus diawali dengan awalan yang ditentukan, misalnya /user.

        • Regular Expression Match: Path permintaan harus sesuai dengan ekspresi reguler yang ditentukan.

      Method

      Menentukan parameter method dalam permintaan HTTP untuk dicocokkan. Anda dapat memilih beberapa metode HTTP. Nilai default-nya adalah ANY.

      Header

      Menentukan parameter header dalam permintaan HTTP untuk dicocokkan. Untuk tipe aturan pencocokan yang sama, aturan dengan lebih banyak parameter memiliki prioritas lebih tinggi.

      Query Parameters

      Menentukan parameter kueri dalam permintaan HTTP untuk dicocokkan. Untuk tipe aturan pencocokan yang sama, aturan dengan lebih banyak parameter memiliki prioritas lebih tinggi.

      Instance

      Pilih instans Cloud-native API Gateway tempat rute akan berlaku.

      Scenario

      Pilih tipe layanan target untuk rute saat ini.

      • Dasar: Single Service

      • Rilis grayscale: By Percentage (Multi-service), Tag (Tag-based Routing)

      • Lainnya: Mock, Redirect

      Untuk informasi lebih lanjut tentang berbagai jenis layanan target, lihat Routes.

      Catatan

      Jumlah bobot traffic untuk semua layanan target berbobot harus 100%.

      Backend Services

      Pilih layanan backend dan port yang terkait.

      Catatan

      • Anda dapat mengklik Associated Service untuk memilih sumber dan layanan di panel tersebut.

      • Tipe sumber yang berbeda memiliki batasan berbeda terhadap jumlah sumber yang dapat ditambahkan.

        • Anda dapat menambahkan maksimal lima sumber untuk Container Service for Kubernetes (ACK).

        • Anda hanya dapat menambahkan satu sumber Nacos atau Zookeeper.

      Timeout Period (seconds)

      Masukkan durasi timeout. Nilai default-nya adalah 60 detik. Nilai 0 berarti tanpa timeout.

      Fallback

      Tentukan layanan fallback. Jika layanan backend untuk suatu rute tidak memiliki node yang tersedia, gateway meneruskan permintaan asli ke layanan fallback yang ditentukan.

      Catatan

      Saat ini, fitur fallback hanya didukung antar layanan HTTP.

      Retry Times

      Masukkan jumlah percobaan ulang. Nilai default-nya adalah 2. Nilai 0 menonaktifkan percobaan ulang.

      Retry Condition

      Pilih kondisi yang memicu percobaan ulang.

      Retry Status Code

      Tambahkan satu atau beberapa kode status yang memicu percobaan ulang.