有奖捉虫:云通信与企业服务文档专题,速来> HOT

接口描述

CreateForwardLBListenerRules 接口提供了创建负载均衡七层监听器转发规则的能力。
接口访问域名:lb.api.qcloud.com

请求参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 CreateForwardLBListenerRules。

参数名称 必选 类型 描述
loadBalancerId String 负载均衡实例 ID,可通过 DescribeLoadBalancers 接口同时入参 forward 字段为1或者-1来查询。
listenerId String 负载均衡监听器 ID,可通过 DescribeForwardLBListeners 接口查询。
rules.n.domain String 负载均衡监听器转发规则的域名。长度限制为:1 - 80。有三种使用格式:非正则表达式格式,通配符格式,正则表达式格式。非正则表达式格式只能使用字母、数字、‘-’、‘.’。通配符格式的使用 ‘*’ 只能在开头或者结尾。正则表达式以'~'开头,支持 Nginx 原生的正则表达式。
rules.n.url String 负载均衡监听器转发规则的路径。长度限制为:1 - 80。使用格式有两种:无修饰符格式,有修饰符格式。修饰符可以使用的有:~、 ~* 、 ^~ 、 = 其中 ~ 表示接下来的表达式为大小写敏感的正则表达式,~* 修饰符表示大小写不敏感的正则表达式。^~ 修饰符表示如果该表达式被认定为最佳匹配,那么不再进行以下的搜索匹配。= 表示精确匹配,只有请求与该表达式完全相同才满足该转发。非正则表达式可用的字符包括字母、数字、‘_’、‘-’、‘.’、‘=’、‘?’、‘/’。
rules.n.sessionExpire Int 负载均衡监听器转发规则的会话保持时间,0表示关闭,可选值:30 - 3600。
rules.n.healthSwitch Int 负载均衡监听器转发规则健康检查,1:开启、0:关闭。默认值1表示打开。
rules.n.intervalTime Int 负载均衡监听器转发规则健康检查的检查间隔时间,默认值5,可选值:5 - 300,单位:秒。
rules.n.healthNum Int 负载均衡监听器转发规则健康阈值,默认值3,表示当连续探测三次健康则表示该转发正常,可选值:2 - 10,单位:次。
rules.n.unhealthNum Int 负载均衡监听器转发规则不健康阈值,默认值3,表示当连续探测三次不健康则表示该转发不正常,可选值:2 - 10,单位:次。
rules.n.httpHash String 负载均衡监听器转发规则的转发方式。可选值:wrr、ip_hash,least_conn
分别表示按权重轮询、根据源 IP 进行哈希到后端机器,最小连接数的调度方式,默认为 wrr。
rules.n.httpCode Int 负载均衡监听器转发规则的健康状态码。可选值:1 - 31,默认31。
1表示探测后返回值 1xx 表示健康,2表示返回 2xx 表示健康,4表示返回 3xx 表示健康,8表示返回 4xx 表示健康,16表示返回 5xx 表示健康。若希望多种码都表示健康,则将相应的值相加。
rules.n.httpCheckPath String 负载均衡监听器转发规则的探测路径,默认/,必须以/开头。长度限制为:1 - 80,可用的字符包括字母、数字、‘_’、‘-’、‘.’、‘=’、‘?’、‘/’。

返回参数

参数名称 类型 描述
code Int 公共错误码,0表示成功,其他值表示失败。详见错误码页面的 公共错误码
message String 模块错误信息描述,与接口相关。
codeDesc String 英文错误码,成功返回 Success,失败有相应的英文说明。
requestId Int 请求任务 ID,可根据 DescribeLoadBalancersTaskResult 接口查询操作状态。

示例

请求

https://lb.api.qcloud.com/v2/index.php?Action=CreateForwardLBListenerRules
&<公共请求参数>
&loadBalancerId=lb-6efswuxa
&listenerId=lbl-20cxbf40
&rules.0.domain=www.tencent.com
&rules.0.url=fourth
&rules.0.sessionExpire=211
&rules.0.healthSwitch=0
&rules.0.httpHash=ip_hash
&rules.1.domain=www.ali.com
&rules.1.url=/second
&rules.1.sessionExpire=321
&rules.1.healthSwitch=1
&rules.1.httpHash=ip_hash

返回

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "requestId": 28182
}