tencent cloud

负载均衡

动态与公告
产品动态
产品公告
产品简介
产品概述
产品优势
使用场景
技术原理
产品对比
使用约束
Service Regions and Service Providers
购买指南
计费概述
计费项
CLB 资源包
购买方式
欠费说明
产品属性选择
快速入门
域名化负载均衡快速入门
负载均衡快速入门
IPv6 负载均衡快速入门
CentOS 下部署 Nginx
CentOS 下部署 Java Web
操作指南
负载均衡实例
负载均衡监听器
后端服务器
健康检查
证书管理
日志管理
监控告警
访问管理
传统型负载均衡
实践教程
部署证书到负载均衡(双向认证)
负载均衡开启 Gzip 配置及检测方法说明
HTTPS 转发配置入门指南
如何获取客户端真实 IP
负载均衡配置监控告警最佳实践
产品高可用说明
均衡算法选择与权重配置示例
配置 WAF 对负载均衡的监听域名进行 Web 安全防护
配置 IAP 对负载均衡的域名和路径的web访问进行身份验证
配置 IAP 对负载均衡的域名和路径的程序化访问进行身份验证
运维指南
客户端 timewait 过多解决方案
负载均衡HTTPS服务性能测试
压力测试常见问题
CLB 证书操作权限问题
故障处理
UDP 健康检查出现异常
API 文档
History
Introduction
API Category
Instance APIs
Listener APIs
Backend Service APIs
Target Group APIs
Redirection APIs
Other APIs
Classic CLB APIs
Load Balancing APIs
Making API Requests
Data Types
Error Codes
CLB API 2017
常见问题
计费相关
负载均衡配置相关
健康检查异常排查
HTTPS 相关
WS/WSS 协议支持相关
HTTP/2 协议支持相关
默认域名阻断提示
服务等级协议
联系我们
词汇表

DescribeLoadBalancers

PDF
聚焦模式
字号
最后更新时间: 2024-12-19 14:28:25

API Description

This API is used to obtain the list of CLB instances and output satisfactory CLB instances based on the specified parameters.
Domain name for API calls: lb.api.qcloud.com

Request Parameters

The list below contains only the API request parameters. Common parameters should be added when you call the API. For more information, see Common Request Parameters. The Action field for this API is DescribeLoadBalancers.
Parameter
Required
Type
Description
loadBalancerIds.n
No
String
CLB instance ID.
loadBalancerType
No
Int
Network type of the CLB instance.
2: public network; 3: private network.
forward
No
Int
CLB instance type. 1: CLB; 0: classic CLB, -1: all.
loadBalancerName
No
String
CLB instance name.
domain
No
String
Domain name assigned to a public network classic CLB instance by Tencent Cloud. This field is inapplicable to other types of CLB instances.
loadBalancerVips.n
No
String
VIP address of the CLB instance. You can enter several VIP addresses.
backendWanIps.n
No
String
Public IP of the real server bound to a CLB instance.
backendLanIps.n
No
String
Private IP of the real server bound to a CLB instance.
offset
No
Int
Data offset. Default value: 0.
limit
No
Int
Number of returned CLB instances. Default value: 20.
orderBy
No
String
Sort by field. Valid values: loadBalancerName, createTime, domain, loadBalancerType.
orderTyp
No
Int
1: reverse; 0: sequential. The createTime in reverse chronological order will be used by default.
searchKey
No
String
Search field which fuzzy matches name, domain name, or VIP.
projectId
No
Int
ID of the project to which a CLB instance belongs, which can be obtained via the DescribeProject API.
withRs
No
Int
Whether the CLB instance you want to query is bound to a real server. 0: no; 1: yes; 2: query all.

Response Parameters

Parameter
Type
Description
code
Int
Common error code. 0: success; other values: failure. For more information, see Common Error Codes.
message
String
API-related module error message description.
codeDesc
String
Error code. For a successful operation, "Success" is returned. For a failed operation, a message describing the failure is returned.
totalCount
Int
Total number of CLB instances that meet the filter criteria.
loadBalancerSet
Array
Array of returned CLB instances.
loadBalancerSet structure
Parameter
Type
Description
loadBalancerId
String
CLB instance ID.
unLoadBalancerId
String
CLB instance ID.
loadBalancerName
String
CLB instance name.
loadBalancerType
Int
Network type of the CLB instance.
2: public network; 3: private network.
forward
Int
CLB type identifier. 1: CLB; 0: classic CLB.
domain
String
Domain name assigned to a public network classic CLB instance by Tencent Cloud. This field is inapplicable to other types of CLB instances.
loadBalancerVips
Array
VIP list of the CLB instance.
status
Int
Status of the CLB instance.
0: creating; 1: running.
createTime
String
Creation time of the CLB instance.
statusTime
String
Last time when the status of the CLB instance changes.
projectId
Int
ID of the project to which the CLB instance belongs. 0: default project.
vpcId
Int
Numerical digits of the VPC ID. 0: classic network.
subnetId
Int
Numerical digits of the VPC subnet ID. 0: default subnet.
openBgp
Int
Identifier of a high defense LB. 1: high defense CLB; 0: non-high defense CLB.
snat
Bool
"snat" is enabled for all private network classic CLB instances created before December 2016.
isolation
Int
Isolation status of the CLB instance due to account arrears. 0: not isolated; 1: isolated.
log
String
Log information. Only the public network CLB instances that have HTTP or HTTPS listener can generate logs.

Example

Querying the CLB instance list using default parameters
https://lb.api.qcloud.com/v2/index.php?Action=DescribeLoadBalancers
&<Common request parameters>
&forward=-1
Response
{
"code": 0,
"message": "",
"codeDesc": "Success",
"loadBalancerSet": [
{
"loadBalancerId": "lb-hc1vni0f",
"unLoadBalancerId": "lb-hc1vni0f",
"loadBalancerName": "cls-qbesvs66_ng1",
"loadBalancerType": 2,
"domain": "cls-qbesvs66-ng1.gz.1251707795.clb.myqcloud.com",
"loadBalancerVips": [
"111.230.83.36"
],
"status": 1,
"createTime": "2017-11-30 14:28:45",
"statusTime": "2017-11-30 14:29:11",
"vpcId": 2968,
"uniqVpcId": "vpc-b2h3xykt",
"subnetId": 1,
"projectId": 0,
"forward": 0,
"snat": false,
"openBgp": 0,
"isolation": 0,
"log": ""
}
],
"totalCount": 1
}


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈