查询路由列表
更新时间：2026-08-15
查询指定 AI 网关实例下的路由列表，支持按路由名称模糊搜索、分页和排序。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Http
1GET /v1/aigw/cluster/{instanceId}/route?routeName={routeName}&pageNo={pageNo}&pageSize={pageSize}&orderBy={orderBy}&order={order} HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string请求头域
除公共头域外，还需传入以下头域：
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| X-Region | string | 是 | 地域代码，如 bj |
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | string | 是 | URL参数 | AI 网关实例 ID |
| routeName | string | 否 | Query参数 | 路由名称，支持模糊搜索 |
| pageNo | integer | 否 | Query参数 | 页码，从 1 开始，默认为 1 |
| pageSize | integer | 否 | Query参数 | 每页条数，默认为 10 |
| orderBy | string | 否 | Query参数 | 排序字段，默认为 createTime |
| order | string | 否 | Query参数 | 排序方向，取值为 asc 或 desc，默认为 desc |
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | RouteListPage | 路由分页结果；列表仅返回摘要，完整配置请查询路由详情 |
| message | string | 错误信息，仅失败时返回 |
请求示例
Http
1GET http://aigw.bj.baidubce.com/v1/aigw/cluster/aigw-a1b2c3d4/route HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string响应示例
Http
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
4
5Status: 200 Time: 363.325ms
6{
7 "order": "desc",
8 "orderBy": "createTime",
9 "pageNo": 1,
10 "pageSize": 10,
11 "result": [
12 {
13 "associatedDomainCount": 0,
14 "createTime": "2026-08-13 11:23:48",
15 "domains": [ ],
16 "matchPath": {
17 "matchType": "regex",
18 "value": "^/instance(/$)(.*)"
19 },
20 "routeName": "api-route-test",
21 "routeStatus": "PUBLISHED",
22 "srcProduct": "",
23 "targetService": [
24 {
25 "serviceSource": "CCE",
26 "serviceName": "flask-service-v2",
27 "namespace": "default",
28 "servicePort": 80,
29 "loadBalanceAlgorithm": "round-robin"
30 }
31 ]
32 }
33 ],
34 "totalCount": 1
35}错误响应示例：
JSON
1{
2 "success": false,
3 "status": 404,
4 "message": "实例不存在"
5}评价此篇文章