全部产品
Search

搜索本产品

    API Gateway：Buat entri rute

    文档中心

    API Gateway：Buat entri rute

    更新时间：Nov 10, 2025

    Saat gerbang API cloud-native menerima permintaan, gerbang tersebut mencoba mencocokkannya dengan aturan routing yang telah Anda tetapkan. Gerbang memeriksa aturan-aturan tersebut berdasarkan urutan prioritas menurun. Jika suatu aturan cocok, gerbang akan meneruskan permintaan ke layanan backend yang ditentukan dalam aturan tersebut. Jika tidak ada aturan yang cocok, gerbang akan mengembalikan kesalahan 404.

    Prioritas pencocokan routing

    Jika terdapat beberapa aturan routing, prioritasnya diurutkan dari tertinggi ke terendah sesuai urutan berikut: Associated Domain > Path > Header > Query > Creation Time. Aturan lengkapnya adalah sebagai berikut:

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

    2. Path:

      • Jika Match Rules berbeda, prioritasnya adalah sebagai berikut: Exact > Prefix > Regular Expression.

      • Jika Match Rules sama, semakin panjang string Path, semakin tinggi prioritasnya.

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

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

    5. Creation Time: Semakin awal waktu pembuatannya, semakin tinggi prioritasnya.

    Prosedur

    Catatan

    • Konfigurasi entri rute mendukung family protokol HTTP, termasuk HTTP/1.0, HTTP/1.1, HTTP/2, gRPC, dan WebSocket.

    • Entri rute yang dibuat dalam suatu instans hanya dapat dilihat dan dikelola dalam instans tersebut.

    1. Anda dapat membuat entri rute untuk gerbang API cloud-native melalui dua cara: dari luar instans atau dari dalam instans.

      Dari luar instans

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

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

      3. Klik Create Route.

      Dari dalam instans

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

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

      3. Klik Create Route.

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

      Catatan

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

      • Prioritas pencocokan entri rute mengikuti urutan tampilannya di halaman konfigurasi entri rute.

      Item Konfigurasi

      Deskripsi

      Route Name

      Masukkan nama kustom untuk entri rute.

      Route Description

      Klik Add Route Description dan masukkan deskripsi untuk entri rute.

      Domain Name

      • Pilih satu atau beberapa nama domain agar entri rute dapat dicocokkan.

      • Untuk membuat nama domain baru, klik Add Domain Name dan buat di panel tersebut.

      Path

      Tetapkan parameter Path untuk dicocokkan dalam permintaan HTTP.

      • Jika aturan pencocokan sama, Path yang lebih panjang memiliki prioritas lebih tinggi.

      • Jika aturan pencocokan berbeda, prioritasnya adalah: Exact > Prefix > Regular Expression Match.

        • Exact: Pencocokan eksak. Misalnya, Path-nya persis /user.

        • Prefix: Mencocokkan berdasarkan awalan. Misalnya, Path dimulai dengan /user.

        • Ekspresi Reguler: Mencocokkan berdasarkan ekspresi reguler.

      Method

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

      Header

      Tetapkan parameter Header untuk dicocokkan dalam permintaan HTTP. Jika aturan pencocokan sama, jumlah parameter yang lebih banyak menghasilkan prioritas yang lebih tinggi.

      Query

      Tetapkan parameter Query untuk dicocokkan dalam permintaan HTTP. Jika aturan pencocokan sama, jumlah parameter yang lebih banyak menghasilkan prioritas yang lebih tinggi.

      Instance

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

      Scenarios

      Pilih jenis layanan target untuk entri rute saat ini.

      • Skenario dasar: Single Service

      • Skenario rilis grayscale: By Weight (Multi-service), By Tag (Tag-based Routing)

      • Skenario lainnya: Mock, Redirection

      Untuk informasi selengkapnya tentang berbagai jenis layanan target, lihat routing.

      Catatan

      Jumlah bobot lalu lintas untuk semua layanan target harus 100%.

      Backend Service

      Pilih layanan backend dan port yang terkait.

      Catatan

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

      • Jenis sumber yang berbeda memiliki batasan berbeda terhadap jumlah sumber yang dapat Anda tambahkan.

        • Layanan Container: Maksimal 5 sumber.

        • Nacos dan Zookeeper: Hanya satu sumber.

      Timeout (seconds)

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

      Fallback

      Tetapkan layanan fallback. Anda harus memilih layanan tertentu. Ketika layanan backend yang dituju oleh entri rute tidak memiliki node aktif, permintaan asli akan dikirim ke layanan fallback yang ditentukan.

      Catatan

      Saat ini, fitur fallback hanya didukung antar layanan HTTP.

      Retries

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

      Retry Conditions

      Pilih kondisi percobaan ulang.

      Retry Status Codes

      Tambahkan satu atau beberapa kode status yang memicu percobaan ulang.