绑定云服务器到应用型负载均衡七层监听器的转发规则
最近更新时间: 2024-10-17 17:10:00
接口描述
RegisterInstancesWithForwardLBSeventhListener 接口用来将一台或多台云服务器绑定到应用型负载均衡监听器的转发规则上。
接口访问域名：lb.api.qcloud.com
请求参数
以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，见 公共请求参数 页面。其中，此接口的 Action 字段为 RegisterInstancesWithForwardLBSeventhListener。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| 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.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=RegisterInstancesWithForwardLBSeventhListener
&<公共请求参数>
&loadBalancerId=lb-abcdefgh
&listenerId=lbl-abcdefgh
&locationIds.0=loc-aaa
&backends.0.instanceId=ins-1234test
&backends.0.port=80
&backends.0.weight=10
&backends.1.instanceId=ins-5678test
&backends.1.port=80
&backends.1.weight=6返回
{
"code" : 0,
"message" : "",
"codeDesc": "Success",
"requestId" : 1234
}