绑定虚机IP到负载均衡四层监听器

最近更新时间:2017-11-13 21:35:33

功能描述

BindBmL4ListenerVmIp 提供了绑定虚机IP到黑石负载均衡四层监听器功能。

接口请求域名:bmlb.api.qcloud.com

请求

请求示例

GET https://bmlb.api.qcloud.com/v2/index.php?Action=BindBmL4ListenerVmIp
    &<公共请求参数>
    &loadBalancerId=<负载均衡实例ID>
    &listenerId=<四层监听器实例ID>
    &vmList.0.port=<待绑定的虚机端口>
    &vmList.0.probePort=<自定义探测的虚机端口>
    &vmList.0.vmIp=<待绑定的虚机IP>
    &vmList.0.weight=<待绑定的主机权重>

请求参数

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

参数名称 必选 类型 描述
loadBalancerId String 负载均衡实例ID,可通过接口DescribeBmLoadBalancers查询。
listenerId String 四层监听器实例ID,可通过接口DescribeBmListeners查询。
vmList Array 待绑定的虚机信息。可以绑定多个虚机端口。目前一个四层监听器下面最多允许绑定255个虚机端口。

vmList描述待绑定的虚机信息,n为下标,vmList包含字段如下

参数名称 必选 类型 描述
vmList.n.port Int 待绑定的虚机端口,可选值1~65535。
vmList.n.probePort Int 自定义探测的虚机端口,可选值1~65535。(需要监听器开启自定义健康检查)
vmList.n.vmIp String 待绑定的虚机IP。
vmList.n.weight Int 待绑定的虚机权重,可选值0~100。

响应

响应示例

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "requestId" : <异步任务ID>
}

响应参数

参数名称 类型 描述
code Int 公共错误码。0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关。
requestId Int 任务ID。该接口为异步任务,可根据本参数调用DescribeBmLoadBalancersTaskResult接口来查询任务操作结果

错误码

错误代码 英文提示 错误描述
9003 InvalidParameter 参数错误
9006 InternalError.CCDBAbnormal CCDB 服务异常
11041 InvalidParameter.CCDBLBNotExist CCDB中不存在该负载均衡记录信息
12003 IncorrectStatus.LBWrongStatus 该负载均衡状态不正确,无法执行当前操作
-21001 InvalidStatus.LBInvalidStatus 当前负载均衡状态不允许此操作
-12023 InvalidL4Listener.NotExist CCDB中不存在该四层监听器
-12021 IncorrectStatus.L4ListenerWrongStatus 该负载均衡四层监听器状态不正确,无法执行当前操作
12013 InvalidResource.BindCPMNumberOverLimit 该负载均衡绑定的主机端口数量超过上限
11060 InternalError.TGWAbnormal TGW 服务异常
28000 InternalError.VPCAbnormal VPC 服务异常
14100 InternalError.BmApiAbnormal bmApi服务异常
-12022 InvalidParameter.InvalidMultiL4VportToRsport 此主机端口已经绑定四层监听器
-12024 InvalidVmIp.NotExist 不存在该虚拟IP

实际案例

输入

GET https://bmlb.api.qcloud.com/v2/index.php?Action=BindBmL4ListenerVmIp
    &SecretId=AKIDlfdHxN0ntSVt4KPH0xXWnGl21UUFNoO5
    &Nonce=61431
    &Timestamp=1507728683
    &Region=bj
    &loadBalancerId=lb-abcdefgh
    &listenerId=lbl-abcdefgh
    &vmList.0.port=1234
    &vmList.0.probePort=1234
    &vmList.0.vmIp=1.1.1.1
    &vmList.0.weight=10
    &Signature=umZFAAWKzjXEQp4ySgrWAoWOHKI%3D

输出

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