全部產品
Search
文件中心

Serverless App Engine:為應用設定路由規則(API Gateway)

更新時間:Sep 12, 2025

如果您的業務請求需要分發給其他服務或者應用,您可以為應用配置網關路由功能,實現請求路由分發。本文介紹如何通過雲原生API Gateway為您的應用設定路由規則。

背景資訊

雲原生API Gateway是一種整合了流量網關、微服務網關、安全網關以及AI網關功能的統一架構解決方案,旨在解決傳統網關分散管理帶來的挑戰。通過使用雲原生API Gateway,開發人員可以更容易地實現服務發現、負載平衡以及跨服務通訊的管理,從而簡化了複雜分布式系統的開發與維護過程。更多資訊,請參見什麼是雲原生API Gateway

前提條件

  • MSE

  • SAE

    • 您已建立命名空間,並確保雲原生API GatewaySAE命名空間處於同一地區,且綁定同一個VPC。具體操作,請參見建立命名空間

    • 您已建立應用。

建立路由規則

  1. SAE網關路由中,在頂部選擇目標地區和命名空間,點擊建立網關路由

  2. 建立路由頁面,配置相關資訊,然後單擊儲存

    配置項

    描述

    樣本

    路由名稱

    路由規則名稱,自訂。

    demo

    網路類型

    選擇待轉寄請求的網路類型。

    • 公網:通過公網網關轉寄的請求,按照實際轉寄流量計費。

    • 私網:通過私網網關轉寄的請求不計費,僅在當前VPC內部轉寄。

    公網

    網關類型

    選擇雲原生API Gateway

    雲原生API Gateway

    網關執行個體

    網關類型選擇雲原生API Gateway時需要配置。選擇與命名空間同一地區且使用同一VPC的網關執行個體。如果您需要建立新的網關執行個體,可以單擊建立雲原生API Gateway進行建立。具體操作,請參見建立雲原生API Gateway執行個體

    demo

    網域名稱

    選擇需要匹配的網域名稱,支援選擇多個網域名稱。如果您需要建立新的網域名稱,可以單擊建立網域名稱進行建立。具體操作,請參見建立網域名稱

    www.demo.com

    路徑(Path)

    設定匹配HTTP請求中的Path參數。

    • 相同匹配規則時,Path越長優先順序越高。

    • 不同匹配規則時,等於 > 首碼是 > 正則匹配

      • 等於:即完全符合。例如,Path等於/user

      • 首碼是:以首碼作為匹配條件。例如,Path以/user開頭。

      • 正則匹配:以Regex作為匹配條件。例如,字元類user

    • 條件:首碼是

    • 路徑:/user

    方法(Method)

    設定匹配HTTP請求中的Method參數,不填表示匹配所有參數,支援選擇多種HTTP方法。

    GET

    要求標頭(Header)

    設定匹配HTTP請求中的Header參數,相同匹配規則時參數越多優先順序越高。

    • 要求標頭:demo

    • 條件:首碼是

    • 值:value

    請求參數(Query)

    設定匹配HTTP請求中的Query參數,相同匹配規則時參數越多優先順序越高。

    • 要求標頭:key

    • 條件:首碼是

    • 值:value

    服務來源

    支援MSE NacosK8s Service兩種註冊中心。

    • MSE Nacos:選擇後,需設定MSE Nacos執行個體MSE Nacos命名空間

    • K8s ServiceSAE支援通過K8s ServiceName進行多語言服務註冊發現,並允許使用固定網域名稱配置應用,以解決部署後執行個體IP變化的問題。

    說明

    與應用的服務註冊發現方式保持一致。

    MSE Nacos執行個體

    使用情境

    選擇當前路由的目標服務類型。

    • 基礎情境

      單服務:將請求分發到唯一一個後端服務,是最常使用的情境。

    • 灰階情境

      多服務:將請求按比例分發到多個後端服務,通常在切流和灰階情境下使用。

    關於目標服務不同類型的說明,請參見路由方式概述

    單服務

    後端服務

    選擇後端應用、服務及其對應的連接埠。

    說明

    涉及權重的目標服務流量比例總和要求為100%。

    • 應用程式名稱:demo

    • 服務名稱:demo

    • 服務合約:自動讀取

    • 服務連接埠:80

    進階配置

    Fallback

    開啟Fallback開關,設定Fallback服務,您需要選擇指定的服務。當路由指向的後端服務沒有可用節點時,原請求會訪問此處指定的Fallback服務。

    說明

    目前僅支援HTTP服務之間的Fallback能力。

    開啟

    逾時時間(秒)

    輸入逾時時間。預設為60秒。如果為0,則表示永不逾時。

    60

    重試次數

    輸入重試次數。如果為0,則表示禁用重試。

    2

    重試條件

    請選擇重試條件。更多資訊,請參見配置重試策略

    connect-failure、cancelled

    重試狀態代碼

    請添加重試狀態代碼。報錯後的提示資訊。

    502

    路由規則建立成功後,可以在網關路由頁面進行查看、編輯等操作。

管理路由規則

建立路由規則後,您可以在網關路由頁面查看轉寄策略、編輯以及刪除網關路由。