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 协议支持相关
默认域名阻断提示
服务等级协议
联系我们
词汇表

DescribeClassicalLBListeners

PDF
聚焦模式
字号
最后更新时间: 2025-11-25 10:11:29

1. API Description

Domain name for API request: clb.intl.tencentcloudapi.com.

This API (DescribeClassicalLBListeners) is used to get the listener information of a classic CLB.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: DescribeClassicalLBListeners.
Version Yes String Common Params. The value used for this API: 2018-03-17.
Region Yes String Common Params. For more information, please see the list of regions supported by the product.
LoadBalancerId Yes String CLB instance ID
ListenerIds.N No Array of String List of CLB listener IDs
Protocol No String CLB listening protocol. Valid values: TCP, UDP, HTTP, and HTTPS.
ListenerPort No Integer CLB listening port. Value range: 1 - 65535.
Status No Integer Listener status. Valid values: 0 (creating) and 1 (running).

3. Output Parameters

Parameter Name Type Description
Listeners Array of ClassicalListener Specifies the listener list.
RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Retrieving Listener Information for a Classic CLB

Input Example

https://clb.intl.tencentcloudapi.com/?Action=DescribeClassicalLBListeners
&LoadBalancerId=lb-a3u5l5zc
&<Common request parameters>

Output Example

{
    "Response": {
        "Listeners": [
            {
                "ListenerId": "lbl-3jur3gei",
                "ListenerPort": 80,
                "InstancePort": 8080,
                "ListenerName": "HTTP-LISTENER",
                "Protocol": "tcp",
                "SessionExpire": 0,
                "HealthSwitch": 1,
                "TimeOut": 2,
                "IntervalTime": 5,
                "HealthNum": 3,
                "UnhealthNum": 3,
                "HttpHash": "",
                "HttpCode": 31,
                "HttpCheckPath": "",
                "SSLMode": "",
                "CertId": "",
                "CertCaId": "",
                "Status": 1
            }
        ],
        "RequestId": "5da375f4-214d-42bb-8d50-e74bf556b38f"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
FailedOperation Operation failed.
InternalError Internal error.
InvalidParameter Parameter error.
InvalidParameter.FormatError Wrong parameter format.
InvalidParameterValue Incorrect parameter value.
InvalidParameterValue.Length Wrong parameter length.
LimitExceeded Quota exceeded.
ResourceInsufficient Insufficient resources.
UnauthorizedOperation Unauthorized operation.
UnsupportedOperation Unsupported operation.

帮助和支持

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

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

文档反馈