创建路由
更新时间 2026-04-21 15:48:09
最近更新时间: 2026-04-21 15:48:09
本章节介绍如何在HTTP API下创建路由。
概述
输入路由名称，匹配域名、路径、方法、header、query等参数，目标转发地址为服务列表里面配置的地址；路径匹配支持精确匹配和前缀匹配模式，精确匹配如/foo/bar匹配请求路径为/foo/bar的请求，前缀匹配/foo/bar/能够匹配/foo/bar、/foo/bar/baz、/foo/bar/a/b/c等请求。
操作步骤
登录云原生API网关控制台。顶部菜单栏选择 "地域"，然后再左侧导航栏选择 "API"。
选择已创建的HTTP API，单击API名称进入API详情页。
单击 "创建路由"。
在 "创建路由" 弹出框填写路由相关配置，并单击 "保存" 或 "保存并发布" 按钮，如您单击的是 "保存" 按钮，则需要在 "路由列表" 页，单击操作列 "发布" 按钮发布路由；
路由配置的规则之间是“与”的关系，必须全部满足才算匹配，路由配置项说明如下：
| 参数 | 说明 |
|---|---|
| 路由名称 | 路由名称，用于标识一条路由规则。API内需要保证唯一。 |
| 描述 | 路由描述。 |
| 域名 | 用于和请求中的域名进行匹配，不填则任何请求都可以匹配；可选项从域名管理中添加的域名选择。 |
| 路径 | 支持两种匹配方式： 等于：精确匹配。 前缀是：前缀匹配，如配置 /test，则能够匹配所有路径以 /test开头的请求。 |
| 方法 | 匹配请求中的HTTP方法。 |
| 优先级 | 当多个路由同时匹配一个请求时，路径匹配深度较大的路由优先；路径匹配相同的情况下，路由优先级高（数字大）的优先匹配。 |
| 请求头（header） | 匹配请求中的HTTP header。 |
| 请求参数（Query） | 匹配请求中的HTTP query参数。 |
| Cookie | 通过Cookie进行路由匹配，多个参数之间是“与”的关系。 |
| 是否启用参数规整化匹配 | 启用后支持对参数进行取模，并根据取模结果进行精确或者范围匹配。 |
| 参数类型 | 启用参数规整化匹配选择，支持Header、Query、Cookie。 |
| 是否Hash | 启用参数规整化匹配选择，是否对参数进行哈希处理后再取模，哈希函数为Java String hashCode。 |
| 取模数值 | 启用参数规整化匹配选择，自定义填写取模数值。 |
| 标记类型 | 支持精确和匹配精确。 精确匹配，可用英文逗号分隔多个精确值。 范围：最大值和最小值均是闭区间，[min,max]。 |
| 所属实例 | 路由规则所属的实例。 |
| 场景 | 当前支持单服务、多服务、标签路由、mock路由、重定向和dubbo代理。 |
| 后端服务 | 根据选择的场景选择请求需要转发的后端服务。 |
