API 网关
API 网关
文档指南
请输入
- 文档首页
API 网关API 参考路由管理GetRoute - 查询路由详情
复制全文
下载 pdfGetRoute - 查询路由详情
文档反馈
问问助手查询路由详情。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：GetRoute
要执行的操作，取值：GetRoute。
Version string 必选 示例值：2022-11-12
API的版本，取值：2022-11-12。
Id string 必选 示例值：rd93****
返回参数
Route object 示例值：-
路由详情。
Id string 示例值：rd93****
路由 ID。
Name string 示例值：example
路由名称。
ServiceId string 示例值：sd84****
路由所属服务的 ID。
ServiceName string 示例值：example
路由所属服务的名称。
MatchRule object 示例值：-
匹配规则。
Path object 示例值：-
允许访问的请求路径。
- 必须以（/）开头，（/）不能超过 30 个。
- 支持 ASCII 可打印字符，长度限制为 1~256 个字符。
- 不能包含空格。
MatchType string 示例值：Exact
请求匹配类型，取值：
- Exact：精准匹配。
- Prefix：前缀匹配。
- Regex：正则匹配。
MatchContent string 示例值：example-value
请求匹配值。
- 支持 ASCII 可打印字符，长度限制为 1~256 个字符。
- 不能包含空格。
Method string[] 示例值：["GET","POST","PUT","DELETE","HEAD","OPTIONS","CONNECT","PATCH"]
请求方法，取值：
- GET
- POST
- PUT
- DELETE
- HEAD
- OPTIONS
- CONNECT
- PATCH
QueryString object[] 示例值：-
请求参数。
- 支持 ASCII 可打印字符，长度限制为 1~256 个字符。
- 不能包含空格。
Key string 示例值：example-key
请求匹配键。
Value object 示例值：-
请求匹配值。
MatchType string 示例值：Exact
请求匹配类型，取值：
- Exact：精准匹配。
- Prefix：前缀匹配。
- Regex：正则匹配。
MatchContent string 示例值：example-value
请求匹配值。
- 支持 ASCII 可打印字符，长度限制为 1~256 个字符。
- 不能包含空格。
Header object[] 示例值：-
请求头。
- 长度限制为 0~5 个。
- 支持大小写字母、数字、中划线（-）和下划线（_），长度限制为 1~256 个字符。
- 不能包含空格。
Key string 示例值：example-key
请求匹配键。
Value object 示例值：-
请求匹配值。
MatchType string 示例值：Exact
匹配类型，取值：
- Exact：精准匹配。
- Prefix：前缀匹配。
- Regex：正则匹配。
MatchContent string 示例值：example-value
匹配值。
- 支持 ASCII 可打印字符，长度限制为 1~256 个字符。
- 不能包含空格。
UpstreamList object[] 示例值：-
Upstream 流量分发。
UpstreamId string 示例值：ud93*****
Weight integer 示例值：100
当前 Upstream 的流量权重。整数形式，取值范围为 1～1000。
说明
系统会根据 Upstream 配置的权重总值和各 Upstream 的权重占比，按比例显示流量划分，百分比数字精确到两位小数。
Version string 示例值：test
灰度版本。
- 请输入 2~63 个字符。
- 字符中只能包含大小写字母、数字、和中划线（-）。
- 不能以中划线（-）开头。
AIProviderSettings object 示例值：-
AI 模型配置。
说明
当 Upstream 类型为 AI 模型代理时，需要配置本参数。
Model string 示例值：doubao-seed-2-0-pro-260215
目标模型。
TargetPath string 示例值：/chat/completions
精准重写路径。请求路径会由 Base URL 和精准重写路径拼接而成。例如当 Base URL 为/api/v3，精准重写路径为/chat/completions时，请求路径为/api/v3/chat/completions。
说明
当精准重写路径和前缀重写路径同时设置时，精准重写路径生效。
PrefixPath string 示例值：/ep
前缀重写路径。请求路径的前缀重写路径部分将改写为 Base URL。例如当 Base URL 为/api/v3，前缀重写路径为/ep时，请求路径/ep/chat/completions将被改写为/api/v3/chat/completions。
说明
当精准重写路径和前缀重写路径同时设置时，精准重写路径生效。
AdvancedSetting object 示例值：-
高级配置。
TimeoutSetting object 示例值：-
超时配置。
Enable boolean 示例值：true
是否开启超时配置。取值：
- true：开启。
- false：不开启。
Timeout long 示例值：10
超时时间，单位为秒。
CorsPolicySetting object 示例值：-
跨域配置。
Enable boolean 示例值：true
是否开启跨域配置。取值：
- true：开启。
- false：不开启。
AllowCredentials boolean 示例值：false
是否携带凭证。取值：
- true：携带。
- false：不携带。
AllowMethods string[] 示例值：["GET","POST","PUT","DELETE","HEAD","OPTIONS","CONNECT","PATCH"]
允许的 HTTP 方法，取值：
- GET
- POST
- PUT
- DELETE
- HEAD
- OPTIONS
- CONNECT
- PATCH
AllowOrigins object[] 示例值：-
允许的访问来源列表。
Value string 示例值：true
跨域列表。
MatchType string 示例值：exact
匹配类型，取值：
- exact：精准匹配。
- regex：正则匹配。
AllowHeaders string[] 示例值：["example-header"]
允许的非简单请求头。
ExposeHeaders string[] 示例值：["example-header"]
允许客户端获取的非简单响应头。
MaxAge long 示例值：86400
缓存时间。预检请求结果的有效缓存时间，单位为秒。
URLRewriteSetting object 示例值：-
URL 重写配置。
说明
当 Upstream 类型为 AI 模型代理时，URL 重写不生效。
Enable boolean 示例值：true
是否开启 URL 重写。取值：
- true：开启。
- false：不开启。
URLRewrite string 示例值：/v2/
重写路径。
- 必须以（/）开头，以（/）结尾，（/）不能超过 30 个。
- 支持 ASCII 可打印字符，长度限制为 1~256 个字符。
HeaderOperations object[] 示例值：-
修改请求头。长度限制为 0~5 个。
Operation string 示例值：set
请求头修改模式，取值：
- set：覆写。
- add：追加。
- remove：移除。
Key string 示例值：example-key
请求头的键。支持大小写字母、数字、中划线（-）和下划线（_），长度限制为 1~256 个字符。
Value string 示例值：example-value
请求头的值。支持大小写字母、数字、中划线（-）和下划线（_），长度限制为 1~256 个字符。
MirrorPolicies object[] 示例值：-
流量镜像。长度限制为 0~1 个。
Upstream object 示例值：-
后端 Upstream 配置。
Type string 示例值：-
镜像后端 Upstream 类型。
说明
当Upstream 类型为函数服务或 AI 模型代理时，流量镜像不生效。
UpstreamId string 示例值：ud93****
Version string 示例值：-
灰度版本。
Percent object 示例值：-
镜像比例配置。
Value double 示例值：50
复制到镜像后端服务的流量比例值。取值范围为 0~100，取值为 0 时，表示不复制流量到镜像服务。
RetryPolicySetting object 示例值：-
重试配置。
Enable boolean 示例值：true
是否开启重试配置。取值：
- true：开启。
- false：不开启。
Attempts long 示例值：2
重试次数。
RetryOn string[] 示例值：["5xx","reset","connect-failure"]
重试条件，取值：
- 5xx：后端服务器返回 5xx 状态码，或发生连接断开、重置、读取超时事件。
- reset：发生连接断开、重置、读取超时事件。
- connect-failure：与后端服务器连接失败，请求出错。
- refused-stream：后端服务使用REFUSED\_STREAM错误码来重置流。
- cancelled：后端服务响应头中的 gRPC 状态码为cancelled。
- deadline-exceeded：后端服务响应头中的 gRPC 状态码为deadline-exceeded。
- internal：后端服务响应头中的 gRPC 状态码为internal。
- resource-exhausted：后端服务响应头中的 gRPC 状态码为resource-exhausted。
- unavailable：后端服务响应头中的 gRPC 状态码为unavailable。
HttpCodes string[] 示例值：["500"]
需要进行重试的 HTTP 状态码。
Domains object[] 示例值：-
默认域名。
Domain string 示例值：http://example.apigateway-cn-beijing.volceapi.com
默认域名地址。
Type string 示例值：public
默认域名类型，取值：
- public：公网。
- private：私网。
Status string 示例值：-
路由状态。
Reason string 示例值：-
不可用原因。
Enable boolean 示例值：true
是否开启路由上下线功能。取值：
- true：开启。
- false：不开启。
说明
该功能目前处于 邀测 阶段，如需使用，请联系客户经理。
Priority long 示例值：100
优先级。整数形式，取值范围为 0～100。数字越小，优先级越高。
CustomDomains object[] 示例值：-
自定义域名。
Id string 示例值：d****
自定义域名 ID。
Domain string 示例值：example.com
自定义域名。
FallbackSetting object 示例值：-
Fallback 配置。
Enable boolean 示例值：false
是否开启 Fallback。取值
- true：开启。
- false：不开启。
FallbackUpstreams object[] 示例值：false
Fallback Upstream 列表。长度限制为 1 个。
UpstreamId string 示例值：ud93****
Weight integer 示例值：100
当前 Upstream 的流量权重。整数形式，取值范围为 1～1000。
说明
系统会根据 Upstream 配置的权重总值和各 Upstream 的权重占比，按比例显示流量划分，百分比数字精确到两位小数。
Version string 示例值：test
灰度版本。
- 请输入 2~63 个字符。
- 字符中只能包含大小写字母、数字、和中划线（-）。
- 不能以中划线（-）开头。
AIProviderSettings object 示例值：-
AI 模型配置。
说明
当 Upstream 类型为 AI 模型代理时，需要配置本参数。
Model string 示例值：doubao-seed-2-0-pro-260215
目标模型。
TargetPath string 示例值：/chat/completions
精准重写路径。请求路径会由 Base URL 和精准重写路径拼接而成。例如当 Base URL 为/api/v3，精准重写路径为/chat/completions时，请求路径为/api/v3/chat/completions。
说明
当精准重写路径和前缀重写路径同时设置时，精准重写路径生效。
PrefixPath string 示例值：/ep
前缀重写路径。请求路径的前缀重写路径部分将改写为 Base URL。例如当 Base URL 为/api/v3，前缀重写路径为/ep时，请求路径/ep/chat/completions将被改写为/api/v3/chat/completions。
说明
当精准重写路径和前缀重写路径同时设置时，精准重写路径生效。
Conditions string[] 示例值：["4xx"]
Fallback 条件，取值：
- 4xx：后端服务器返回 4xx 状态码。
- 5xx：后端服务器返回 5xx 状态码，或发生连接断开、重置、读取超时事件。
Scene string 示例值：-
使用场景。
MockSetting object 示例值：-
Mock配置。
Status long 示例值：400
状态码。
ResponseBody string 示例值：Bad Request.
响应体。
RedirectSetting object 示例值：-
重定向配置。
Status long 示例值：301
状态码，取值：
- 301。
- 302。
- 303。
- 307。
- 308。
- 默认值为301。
Authority string 示例值：example.com
请求域名。
- 请求域名和请求路径至少填写1个。
- 留空时会使用请求时的域名。
Path string 示例值：/index.html
请求路径。
- 请求域名和请求路径至少填写1个。
- 留空时会使用请求时的路径。
请求示例
返回示例
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParameter | The required parameter %s is missing. | 缺少必要的请求参数。请确认参数后重试。 |
404 | ResourceNotFound | The specified resource %s %s cannot be found. | 指定资源找不到。请确认参数后重试。 |
500 | InternalError | The request has failed due to an unknown error. |
最近更新时间：2026.10.28 14:59:49
这个页面对您有帮助吗？
有用
有用
无用
无用