雲原生API Gateway在處理收到的請求時,會按照事先配置的路由規則的優先順序逐一進行匹配。匹配過程是從高優先順序規則向低優先順序規則進行遍曆。如果與某條規則匹配成功,則轉寄請求至規則中配置的目標服務;如果匹配失敗,則會返回404錯誤。
路由匹配優先順序
存在多條路由規則時,按照關聯網域名稱 > 路徑(Path)> 要求標頭(Header)> 請求參數(Query)> 建立時間的優先順序從高到低依次進行排序,詳細規則如下:
根據關聯網域名稱進行判斷:網域名稱字串長度越長,優先順序越高。
根據路徑(Path)進行判斷:
匹配規則不同時:等於 > 首碼是 > 正則匹配。
匹配規則相同時:路徑(Path)字串越長,優先順序越高。
根據要求標頭(Header)的索引值對總數進行判斷:總數越大,優先順序越高。
根據請求參數(Query)的索引值對進行判斷:總數越大,優先順序越高。
根據建立時間進行判斷:建立時間越早則優先順序越高。
操作步驟
雲原生API Gateway提供了執行個體內和執行個體外兩種建立路由的方式:
執行個體外API
登入雲原生API Gateway控制台。左側導覽列選擇API,並在頂部功能表列選擇地區。
單擊目標API,在下拉框中選擇需要配置路由策略的執行個體,或選擇全部執行個體。

然後單擊建立路由。
執行個體內API
登入雲原生API Gateway控制台。左側導覽列選擇執行個體,並在頂部功能表列選擇地區。
在執行個體頁面,單擊目標網關執行個體ID。左側導覽列選擇API,單擊目標API。
單擊建立路由。
在建立路由頁面,配置相關項目,然後單擊儲存或儲存並發布。
說明匹配規則之間是“與”關係,即填寫的規則越多匹配的範圍越小。
路由之間匹配的優先順序與路由配置頁面展示排列順序一致。
配置項
描述
路由名稱
自訂路由名稱。
路由描述
單擊添加路由描述,填寫路由的相關描述。
網域名稱
選擇路由需要匹配的網域名稱,支援選擇多個網域名稱。
如需建立新的網域名稱,單擊添加網域名稱,在面板中進行建立。
路徑(Path)
設定匹配HTTP請求中的Path參數。
相同匹配規則時Path越長優先順序越高。
不同匹配規則時等於 > 首碼是 > 正则匹配。
等於:即完全符合。例如,Path等於
/user。首碼是:以首碼作為匹配條件。例如,Path以
/user開頭。正則匹配:以Regex作為匹配條件。
方法(Method)
設定匹配HTTP請求中的Method參數。支援選擇多種HTTP方法,預設為ANY。
要求標頭(Header)
設定匹配HTTP請求中的Header參數,相同匹配規則時參數越多優先順序越高。
請求參數(Query)
設定匹配HTTP請求中的Query參數,相同匹配規則時參數越多優先順序越高。
所屬執行個體
選擇路由生效的所屬雲原生API Gateway執行個體。
使用情境
選擇當前路由的目標服務類型。
基礎情境:單服務
灰階情境:按比例(多服務)、按標籤(標籤路由)
其他情境:Mock、重新導向
關於目標服務不同類型說明,請參見路由。
說明涉及權重的目標服務流量比例總和要求為100%。
後端服務
選擇已關聯的後端服務和連接埠。
說明您可以單擊關聯服務,在面板選擇來源和服務。
不同的來源類型允許添加的來源數量有不同的限制。
Container Service不得超過5個。
Nacos和Zookeeper只能添加一個。
逾時時間(秒)
輸入逾時時間。預設為60秒。如果為0,則表示永不逾時。
Fallback
設定Fallback服務,您需要選擇指定的服務。當路由指向的後端服務沒有可用節點時,原請求會訪問此處指定的Fallback服務。
說明目前僅支援HTTP服務之間的Fallback能力。
重試次數
輸入重試次數。預設為2次。如果為 0,則表示禁用重試。
重試條件
選擇重試條件。
重試狀態代碼
添加重試狀態代碼,可添加多個。