接口描述
ModifyLoadBalancerBackends 接口用来修改绑定到负载均衡实例的云服务器权重。通过修改权重来调节请求转发的规则。
接口访问域名:lb.api.qcloud.com
请求参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 ModifyLoadBalancerBackends。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
loadBalancerId | 是 | String | 负载均衡实例 ID,可通过 DescribeLoadBalancers 接口查询。 |
backends.n.instanceId | 是 | String | 云服务器的唯一 ID,可通 DescribeInstances 接口返回字段中的 unInstanceId 字段获取; 此接口支持同时输入多台主机的实例 ID ( 如:要输入两台主机,则设置 backends.0.instanceId&backends.1.instanceId)。 |
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=ModifyLoadBalancerBackends &<公共请求参数> &loadBalancerId=lb-abcdefgh &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
}