解绑负载均衡四层监听器物理服务器

最近更新时间:2017-10-20 17:59:58

功能描述

UnbindBmL4ListenerRs 提供了解绑黑石负载均衡四层监听器物理服务器功能。

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

请求

请求示例

GET https://bmlb.api.qcloud.com/v2/index.php?Action=UnbindBmL4ListenerRs
    &<公共请求参数>
    &loadBalancerId=<负载均衡实例ID>
    &listenerId=<四层监听器ID>
    &backends.0.port=<待解绑的主机端口>
    &backends.0.instanceId=<待解绑的主机实例ID>

请求参数

以下请求参数列表仅列出了接口请求参数,其它参数见公共请求参数页面。

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

backends描述待解绑的主机信息,n为下标,backends包含字段如下

参数名称 是否必选 类型 描述
backends.n.port Int 待绑定的主机端口,可选值1~65535。
backends.n.instanceId String 待绑定的主机实例ID。

响应

响应示例

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

响应参数

参数名称 类型 描述
code Int 公共错误码。0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关。
codeDesc 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 该负载均衡四层监听器状态不正确,无法执行当前操作
-21000 InvalidStatus.DeviceInvalidStatus 当前设备状态不允许此操作
14100 InternalError.BmApiAbnormal bmApi服务异常
28000 InternalError.VPCAbnormal VPC 服务异常
30011 InvalidRs.NotExist 主机信息不存在

实际案例

输入

GET https://bmlb.api.qcloud.com/v2/index.php?Action=UnbindBmL4ListenerRs
    &SecretId=AKIDlfdHxN0ntSVt4KPH0xXWnGl21UUFNoO5
    &Nonce=61431
    &Timestamp=1507728683
    &Region=bj
    &loadBalancerId=lb-abcdefgh
    &listenerId=lbl-abcdefgh
    &backends.1.port=1234
    &backends.1.instanceId=cpm-abcdefgh
    &Signature=umZFAAWKzjXEQp4ySgrWAoWOHKI%3D

输出

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