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

接口描述

RegisterInstancesWithLoadBalancer 接口用来绑定一台或多台云服务器到负载均衡实例上。

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

请求参数

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

参数名称 必选 类型 描述
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=RegisterInstancesWithLoadBalancer
&<公共请求参数>
&loadBalancerId=lb-abcdefgh
&backends.0.instanceId=ins-1234test
&backends.0.weight=10
&backends.1.instanceId=ins-5678test
&backends.1.weight=6

返回

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