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

接口描述

ModifyForwardSeventhBackends 接口用来修改绑定到负载均衡实例的云服务器权重。通过修改权重来调节请求转发的规则。

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

请求参数

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

参数名称 必选 类型 描述
loadBalancerId String 负载均衡实例 ID,可通过 DescribeLoadBalancers 接口同时入参 forward 字段为1或者-1来查询。
listenerId String 负载均衡监听器 ID,可通过 DescribeForwardLBListeners 接口查询。
locationIds.n String 指定的规则 ID。
domain String 监听器转发规则的域名。
url String 监听器转发规则的路径。
backends.n.instanceId String 云服务器的唯一 ID,可通过 DescribeInstances 接口返回字段中的 unInstanceId 字段获取;
此接口支持同时输入多台主机的实例 ID(如:要输入两台主机,则设置 backends。1. instanceId&backends,2. instanceId)。
每个 backends 只能设置 instanceId 或 eniIp。
backends.n.eniIp string 云服务器绑定弹性网卡的 IP 地址,包括主网卡主 IP,主网卡辅助 IP,辅助网卡主 IP 和辅助网卡辅助 IP;
此接口支持同时输入多个 IP 地址(如:要输入2个 IP,则设置 backends。1. eniIp&backends,2. eniIp)。
每个 backends 只能设置 instanceId 或 eniIp。
backends.n.port Int 负载均衡实例监听器后端云服务器或弹性网卡监听端口,可选值:1 - 65535。
backends.n.weight Int 云服务器或弹性网卡的权重,取值范围:0 - 100,默认为10。

返回参数

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

示例

请求

https://lb.api.qcloud.com/v2/index.php?Action=ModifyForwardSeventhBackends
&<公共请求参数>
loadBalancerId=lb-6efswuxa
&listenerId=lbl-20cxbf40
&locationIds.1=loc-h8uwer1g
&locationIds.0=loc-hvzwsyqq
&backends.0.instanceId=ins-0zsyoybo
&backends.0.port=80
&backends.0.weight=0
&backends.1.eniIp=192.168.0.1
&backends.1.port=88
&backends.1.weight=20

返回


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