文档平台 API 中心 负载均衡 应用型负载均衡相关接口 云服务器相关接口 修改应用型四层监听器转发规则上云服务器的权重

修改应用型四层监听器转发规则上云服务器的权重

最近更新时间:2018-06-01 10:23:59

1. 接口描述

ModifyForwardFourthBackendsWeight 接口用来修改绑定到负载均衡实例的云服务器权重。通过修改权重来调节请求转发的规则。具体的权重配置说明可以参考产品说明的权重配置

接口访问域名:lb.api.qcloud.com

2. 请求参数

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

参数名称 必选 类型 描述
loadBalancerId String 负载均衡实例ID,可通过DescribeLoadBalancers接口同时入参forward字段为1或者-1来查询。
listenerId String 负载均衡监听器ID,可通过 DescribeForwardLBListeners 接口查询。
backends.n.instanceId String 云服务器的唯一ID,可通过DescribeInstances接口返回字段中的 unInstanceId 字段获取;
此接口支持同时输入多台主机的实例ID( 如:要输入两台主机,则设置 backends.1.instanceId&backends.2.instanceId)。
backends.n.port Int 负载均衡实例监听器后端云服务器监听端口,可选值:1~65535。
backends.n.weight Int 云服务器的权重,取值范围 0-100,默认为 10。

3. 返回参数

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

4. 示例

输入

https://lb.api.qcloud.com/v2/index.php?Action=ModifyForwardFourthBackendsWeight
&<公共请求参数>
&loadBalancerId=lb-abcdefgh
&listenerId=lbl-abddsba
&backends.0.instanceId=ins-6789test
&backends.0.weight=10
&backends.1.instanceId=ins-1234test
&backends.1.weight=6

输出


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