租户端 网络 负载均衡(CLB) 历史版本(V2接口) 查询应用型负载均衡后端绑定的云服务器列表

查询应用型负载均衡后端绑定的云服务器列表

最近更新时间: 2024-12-19 17:12:00

接口描述

DescribeForwardLBBackends 接口用来查询应用型负载均后端绑定的机器列表。

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

请求参数

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

参数名称必选类型描述
loadBalancerIdString负载均衡实例 ID,可通过 DescribeLoadBalancers 接口同时入参 forward 字段为1或者-1来查询。
listenerIds.nString应用型负载均衡监听器 ID,可通过 DescribeForwardLBListeners 接口查询。
protocolInt监听器协议类型
1:HTTP
2:TCP
3:UDP
4:HTTPS
loadBalancerPortInt负载均衡监听器端口。

返回参数

参数名称类型描述
codeInt公共错误码, 0表示成功,其他值表示失败。详见错误码页面的 公共错误码
messageString模块错误信息描述,与接口相关。
codeDescString英文错误码,成功返回 Success,失败有相应的英文说明。
dataArray返回的数组。

data数组结构:

参数名称类型描述
listenerIdString监听器 ID。
protocolInt监听器的协议。
1:HTTP
2:TCP
3:UDP
4:HTTPS
protocolTypeString监听器的协议。例如 HTTP。
loadBalancerPortInt监听器的监听端口。
rulesArray七层监听器下的转发规则组。
backendsArray四层监听器下的云服务器的信息。

rules 数组结构:

参数名称类型描述
locationIdString转发规则的 ID。
domainString转发规则的域名。
urlString转发规则的路径。
backendsArray后端云服务器的信息。

backends 数组结构:

参数名称类型描述
lanIpString云服务器的内网 IP。
wanIpSetArray云服务器的外网 IP。
portInt云服务器的服务端口。
weightInt云服务器的权重。
instanceStatusInt云服务器的状态,详见 [云服务器数据结构页]。
unInstanceIdString云服务器的 ID。
instanceNameString云服务器的名称。
addTimestampString云服务器绑定的时间。

示例代码

请求示例

https://lb.api.qcloud.com/v2/index.php?Action=DescribeForwardLBBackends
&<公共请求参数>
&loadBalancerId=lb-abcdefgh

返回示例

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": [
        {
            "loadBalancerPort": 80,
            "protocol": 1,
            "protocolType": "http",
            "listenerId": "lbl-fh7o7bgt",
            "rules": [
                {
                    "locationId": "loc-7w5sp6wf",
                    "backends": [
                        {
                            "instanceName": "拨测机器,请勿删除",
                            "lanIp": "10.212.199.17",
                            "wanIpSet": [
                                "45.113.71.7"
                            ],
                            "instanceStatus": 0,
                            "port": 80,
                            "weight": 10,
                            "unInstanceId": "ins-42lrdi7x",
                            "addTimestamp": "2016-11-03 11:21:38"
                        },
                        {
                            "instanceName": "拨测机器,请勿删除",
                            "lanIp": "10.212.199.17",
                            "wanIpSet": [
                                "45.113.71.7"
                            ],
                            "instanceStatus": 0,
                            "port": 443,
                            "weight": 10,
                            "unInstanceId": "ins-42lrdi7x",
                            "addTimestamp": "2016-11-03 11:21:38"
                        }
                    ],
                    "domain": "www.baidu.com",
                    "url": "/second"
                },
                {
                    "locationId": "loc-3n8v5v5b",
                    "backends": [
                        {
                            "instanceName": "拨测机器,请勿删除",
                            "lanIp": "10.212.199.17",
                            "wanIpSet": [
                                "45.113.71.7"
                            ],
                            "instanceStatus": 0,
                            "port": 80,
                            "weight": 10,
                            "unInstanceId": "ins-42lrdi7x",
                            "addTimestamp": "2016-11-03 11:21:38"
                        },
                        {
                            "instanceName": "拨测机器,请勿删除",
                            "lanIp": "10.212.199.17",
                            "wanIpSet": [
                                "45.113.71.7"
                            ],
                            "instanceStatus": 0,
                            "port": 443,
                            "weight": 10,
                            "unInstanceId": "ins-42lrdi7x",
                            "addTimestamp": "2016-11-03 11:21:38"
                        }
                    ],
                    "domain": "www.baidu.com",
                    "url": "/first"
                }
            ]
        }
    ]
}