创建路由

通过创建路由功能，可将符合规则的请求，按照设置的流量权重分发至多个目标 Upstream，满足应用的多版本管理等场景。本文为您介绍如何创建路由。

前提条件

• 已创建服务，具体操作可参见 创建服务。
• 已创建 Upstream，具体操作可参见 创建 Upstream。
• 如需对 VKE 类型 Upstream 进行多版本管理，请提前配置 Upstream 版本。具体操作可参见 管理 Upstream 版本。

使用限制

• 一条路由最多支持对接 10 个 Upstream。
• 如果您的多条路由规则存在路径重叠，则来自重叠路径的请求会被转发至最早创建的那条路由。

操作步骤

1. 登录 API 网关控制台。

2. 在顶部导航栏，选择目标地域。

3. 在左侧导航栏选择 路由管理 > 服务列表。

4. 在服务列表页面，单击目标服务名称，进入当前服务概览页面。

5. 在关联路由信息区域，单击 创建路由。

6. 在创建路由页面，按要求配置信息。

   • 基本信息

   配置项	说明
   路由名称	自定义路由名称。同一服务下路由名称唯一。
   所属服务	服务是一组路由的入口。显示当前路由所属的服务名称。
   匹配规则	配置匹配规则，只有符合规则的请求才能转发至目标 Upstream。 请求方法 Method：只允许符合指定方法的请求进行访问。 路径 Path：指定允许访问的请求路径。有如下三种匹配方式，可参考本文下方“路由匹配示例”进行参数配置： 精准匹配：表示请求的路径和设置的路径完全一致，才可以访问。 正则匹配：表示请求的路径和设置的路径正则表达式匹配，即可访问。 前缀匹配：表示请求的路径只要匹配已设定路径的开头，即可访问。 请求参数 QueryString：只允许包含了指定访问参数的请求进行访问。支持添加多条请求参数。
   修改请求头	支持在转发过程中对原请求头的 Header 进行编辑，并将修改后的 Header 转发给网关对接的后端服务。 支持以下三种修改模式。选择对应的模式后，请按界面要求填写对应的 key 和 value，value 不允许为空值。 覆写（set）：如果客户端发送的请求头中没有携带对应的 key，则添加一条新的 Header；如果已携带对应的 key，则该 key 的 value 将被 API 网关侧配置的 value 覆写。 追加（add）：如果客户端发送的请求头中没有携带对应的 key，则添加一条新的 Header；如果已携带对应的 key，则在此条 key 的 value 中追加 API 网关侧配置的 value。 移除（remove）：如果客户端发送的请求头中携带对应的 key，则删除此字段。选择移除模式后，只需填写对应的 key。

   路径匹配示例，如下表所示。

   匹配方式	请求路径	设定路径
   		/apig/test.jpg	/apig	/apig[^\s]*
   精准匹配	/apig/test.jpg	√	-	-
   正则匹配		√	-	√
   前缀匹配		√	√	-

   • Upstream 流量分发

   配置项	说明
   Upstream 流量分发	设置路由至不同 Upstream 的流量权重。单击 + 添加一个 Upstream，最多支持添加 10 个 Upstream。 后端类型：选择接入的 Upstream 类型，当前支持函数服务、云服务器、容器服务、注册中心。 选择 Upstream：选择具体要对接的 Upstream。 权重：设置当前 Upstream 的流量权重。 灰度版本：对于 VKE 类型 Upstream，支持路由至当前应用的某一版本。工作负载在 VKE 侧配置的不同 Label 可区分为不同灰度版本，用于满足应用的多版本管理功能。如不选择灰度版本，则将按照负载均衡策略选择路由至当前应用的具体版本。

7. （可选）填写 高级配置 信息，详细介绍可参见 高级路由策略。

8. 单击 确定，创建完成路由。