1)接口功能介绍
监听器添加转发策略。
2)接口约束
域名与URL至少要指定一个。
3)URI
POST /v1/addListenerRoute。
4)请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
slbListenerId | 是 | String | 负载均衡监听器ID | 235 | |
name | 是 | String | 转发策略名称.sdk默认会生成该字段,建议格式为:forwarding-policy-***。命名要求:小写字母、数字或中划线(-)组成;小写字母开头;数字或小写字母结尾;长度不超过64。 | forwarding-policy-*** | |
slbBackendGroupId | 是 | String | 转发到的后端服务器组ID.通过后端服务器组查询接口GetBackendGroupList获取,只能选择未使用的后端协议类型为HTTP的后端服务器组。 | 1617 | |
domain | 否 | String | 需要转发的域名 . 域名与URL至少要指定一个。如果当前监听器的前端协议是HTTPS,则配置的域名要与证书中的域名相匹配。 | abc.com | |
matchType | 是 | String | URL匹配类型 。Url匹配类型 MATCH_TYPE_EXACT: 精确匹配,MATCH_TYPE_PREFIX: 前缀匹配,MATCH_TYPE_REGULAR: 正则匹配 | MATCH_TYPE_EXACT | |
url | 否 | String | 需要转发的URL.域名与URL至少要指定一个 | EXACT | |
description | 否 | String | 转发策略描述 .最大不超过255个字符 | sdk-test |
5)响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
requestId | 是 | String | 请求id | b84233d3-0796-xxx | |
status | 是 | Object | 应答状态 | status | |
data | 是 | object | 返回数据 | data |
表 status
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
message | 是 | String | 状态描述 | Success | |
code | 是 | String | 状态码 | Success |
表 data
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
routeId | 是 | String | 负载均衡器ID | 22 |
6)请求示例
请求体body
{
"slbListenerId": "5154",
"name": "slb-转发策略-勿删-5150",
"slbBackendGroupId": "5150",
"domain": "1.1.1.1",
"matchType": "MATCH_TYPE_PREFIX",
"description": "test"
}
7)响应示例
{
"requestId": "525e58d1-073e-4b02-ae6c-12cf74c1e36d",
"status": {
"code": "Success",
"message": "Success"
},
"data": {
"routeId": "345"
}
}
8)状态码
状态码 | 描述 |
---|---|
Success | 表示请求成功。 |