更新HttpApi的路由。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
apig:UpdateHttpApiRoute |
none |
*HttpApi
|
无 | 无 |
请求语法
PUT /v1/http-apis/{httpApiId}/routes/{routeId} HTTP/1.1
路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| httpApiId |
string |
否 |
路由所属的 HTTP API ID。 |
api-cqoub6tlhtgvof7*** |
| routeId |
string |
否 |
路由 ID。 |
hr-cr82undlhtgrl*** |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求 Body。 |
|
| domainIds |
array |
否 |
域名 ID 列表。 |
|
|
string |
否 |
域名 ID。 |
d-cr62ts5lhtgln*** |
|
| match | HttpRouteMatch |
否 |
路由 Match 规则。 |
|
| backendConfig |
object |
否 |
路由的后端服务配置。 |
|
| scene |
string |
否 |
后端服务场景。 枚举值:
|
SingleService |
| services |
array<object> |
否 |
后端服务列表。 |
|
|
object |
否 |
后端服务。 |
||
| serviceId |
string |
否 |
服务 ID。 |
svc-cr6pk4tlhtgm58e*** |
| protocol |
string |
否 |
服务协议:
枚举值:
|
HTTP |
| version |
string |
否 |
服务版本。 |
v1 |
| weight |
integer |
否 |
流量比例的百分比值。 |
49 |
| port |
integer |
否 |
服务端口, 动态端口不传入。 |
8080 |
| environmentId |
string |
否 |
环境 ID。 |
env-cquqsollhtgid*** |
| description |
string |
否 |
路由描述。 |
商品中心服务路由 |
| mcpRouteConfig |
object |
否 |
MCP 路由配置 |
|
| protocol |
string |
否 |
MCP 协议 |
SSE |
| exposedUriPath |
string |
否 |
暴露的 URI 路径 |
/mcp/chat |
| mcpStatisticsEnable |
boolean |
否 |
是否启用 MCP 统计 |
true |
| policyConfigs |
array |
否 |
路由级策略配置 |
|
| HttpApiPolicyConfigs |
否 |
object |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
结构体 |
||
| requestId |
string |
请求 ID。 |
CBEEB8C1-108E-50F0-9BEA-DED79553C309 |
| code |
string |
响应状态码。 |
Ok |
| message |
string |
响应消息。 |
success |
示例
正常返回示例
JSON格式
{
"requestId": "CBEEB8C1-108E-50F0-9BEA-DED79553C309",
"code": "Ok",
"message": "success"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。