API 网关
API 网关
文档指南
请输入
- 文档首页
API 网关API 参考路由管理UpdateRoute - 更新路由
复制全文
下载 pdfUpdateRoute - 更新路由
文档反馈
问问助手更新路由。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：UpdateRoute
要执行的操作，取值：UpdateRoute。
Version string 必选 示例值：2022-11-12
API的版本，取值：2022-11-12。
Name string 必选 示例值：example
路由名称。长度限制为 2~255 个字符。
Id string 必选 示例值：rd93****
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 状态码。
Enable boolean 可选 示例值：true
是否开启路由上下线功能。取值：
- true：开启。
- false：不开启。
说明
该功能目前处于 邀测 阶段，如需使用，请联系客户经理。
Priority long 可选 示例值：100
优先级。整数形式，取值范围为 0～100。数字越小，优先级越高。当取值为 0 时，表示最高优先级，全局最先匹配强制优先路由。
FallbackSetting object 可选 示例值：-
Fallback 配置。
Enable boolean 可选 示例值：false
是否开启 Fallback。取值
- true：开启。
- false：不开启。
FallbackUpstreams object[] 可选 示例值：-
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[] 可选 示例值：false
Fallback条件，取值：
- 4xx：后端服务器返回 4xx 状态码。
- 5xx：后端服务器返回 5xx 状态码，或发生连接断开、重置、读取超时事件。
返回参数
Id string 示例值：rd93****
路由 ID。
请求示例
返回示例
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParameter | The required parameter %s is missing. | 缺少必要的请求参数。请确认参数后重试。 |
400 | InvalidParameter | The specified parameter %s is invalid. | 请求参数值不合法。请确认参数后重试。 |
400 | DomainPending | A custom domain is creating or deleting. | 自定义域名正在创建或删除。请稍后重试。 |
403 | OperationDenied | Operation is denied because %s. | 操作不合法。请修改后重试。 |
404 | ResourceNotFound | 指定资源找不到。请确认参数后重试。 | |
409 | DuplicatedResource | Resource %s %s already exists. | 资源已重复。请确认参数后重试。 |
500 | InternalError | The request has failed due to an unknown error. |
最近更新时间：2026.10.28 14:59:49
这个页面对您有帮助吗？
有用
有用
无用
无用