tencentcloud 1.82.35, Nov 7 25

tencentcloud 1.82.35 published on Friday, Nov 7, 2025 by tencentcloudstack

tencentcloudstack/terraform-provider-tencentcloud

tencentcloud.getClbListeners

Start a Neo task

Explain and create a tencentcloud.getClbListeners resource

tencentcloud 1.82.35 published on Friday, Nov 7, 2025 by tencentcloudstack

tencentcloudstack/terraform-provider-tencentcloud

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as tencentcloud from "@pulumi/tencentcloud";

const foo = tencentcloud.getClbListeners({
    clbId: "lb-k2zjp9lv",
    listenerId: "lbl-mwr6vbtv",
    protocol: "TCP",
    port: 80,
});

import pulumi
import pulumi_tencentcloud as tencentcloud

foo = tencentcloud.get_clb_listeners(clb_id="lb-k2zjp9lv",
    listener_id="lbl-mwr6vbtv",
    protocol="TCP",
    port=80)

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/tencentcloud/tencentcloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := tencentcloud.GetClbListeners(ctx, &tencentcloud.GetClbListenersArgs{
			ClbId:      "lb-k2zjp9lv",
			ListenerId: pulumi.StringRef("lbl-mwr6vbtv"),
			Protocol:   pulumi.StringRef("TCP"),
			Port:       pulumi.Float64Ref(80),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Tencentcloud = Pulumi.Tencentcloud;

return await Deployment.RunAsync(() => 
{
    var foo = Tencentcloud.GetClbListeners.Invoke(new()
    {
        ClbId = "lb-k2zjp9lv",
        ListenerId = "lbl-mwr6vbtv",
        Protocol = "TCP",
        Port = 80,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.tencentcloud.TencentcloudFunctions;
import com.pulumi.tencentcloud.inputs.GetClbListenersArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var foo = TencentcloudFunctions.getClbListeners(GetClbListenersArgs.builder()
            .clbId("lb-k2zjp9lv")
            .listenerId("lbl-mwr6vbtv")
            .protocol("TCP")
            .port(80)
            .build());

    }
}

variables:
  foo:
    fn::invoke:
      function: tencentcloud:getClbListeners
      arguments:
        clbId: lb-k2zjp9lv
        listenerId: lbl-mwr6vbtv
        protocol: TCP
        port: 80

Using getClbListeners

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getClbListeners(args: GetClbListenersArgs, opts?: InvokeOptions): Promise<GetClbListenersResult>
function getClbListenersOutput(args: GetClbListenersOutputArgs, opts?: InvokeOptions): Output<GetClbListenersResult>

def get_clb_listeners(clb_id: Optional[str] = None,
                      id: Optional[str] = None,
                      listener_id: Optional[str] = None,
                      port: Optional[float] = None,
                      protocol: Optional[str] = None,
                      result_output_file: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetClbListenersResult
def get_clb_listeners_output(clb_id: Optional[pulumi.Input[str]] = None,
                      id: Optional[pulumi.Input[str]] = None,
                      listener_id: Optional[pulumi.Input[str]] = None,
                      port: Optional[pulumi.Input[float]] = None,
                      protocol: Optional[pulumi.Input[str]] = None,
                      result_output_file: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetClbListenersResult]

func GetClbListeners(ctx *Context, args *GetClbListenersArgs, opts ...InvokeOption) (*GetClbListenersResult, error)
func GetClbListenersOutput(ctx *Context, args *GetClbListenersOutputArgs, opts ...InvokeOption) GetClbListenersResultOutput

> Note: This function is named GetClbListeners in the Go SDK.

public static class GetClbListeners 
{
    public static Task<GetClbListenersResult> InvokeAsync(GetClbListenersArgs args, InvokeOptions? opts = null)
    public static Output<GetClbListenersResult> Invoke(GetClbListenersInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetClbListenersResult> getClbListeners(GetClbListenersArgs args, InvokeOptions options)
public static Output<GetClbListenersResult> getClbListeners(GetClbListenersArgs args, InvokeOptions options)

fn::invoke:
  function: tencentcloud:index/getClbListeners:getClbListeners
  arguments:
    # arguments dictionary

The following arguments are supported:

ClbId string: Id of the CLB to be queried.
Id string
ListenerId string: Id of the listener to be queried.
Port double: Port of the CLB listener.
Protocol string: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
ResultOutputFile string: Used to save results.

ClbId string: Id of the CLB to be queried.
Id string
ListenerId string: Id of the listener to be queried.
Port float64: Port of the CLB listener.
Protocol string: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
ResultOutputFile string: Used to save results.

clbId String: Id of the CLB to be queried.
id String
listenerId String: Id of the listener to be queried.
port Double: Port of the CLB listener.
protocol String: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
resultOutputFile String: Used to save results.

clbId string: Id of the CLB to be queried.
id string
listenerId string: Id of the listener to be queried.
port number: Port of the CLB listener.
protocol string: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
resultOutputFile string: Used to save results.

clb_id str: Id of the CLB to be queried.
id str
listener_id str: Id of the listener to be queried.
port float: Port of the CLB listener.
protocol str: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
result_output_file str: Used to save results.

clbId String: Id of the CLB to be queried.
id String
listenerId String: Id of the listener to be queried.
port Number: Port of the CLB listener.
protocol String: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
resultOutputFile String: Used to save results.

getClbListeners Result

The following output properties are available:

ClbId string: ID of the CLB.
Id string
ListenerLists List<GetClbListenersListenerList>: A list of listeners of cloud load balancers. Each element contains the following attributes:
ListenerId string: ID of the listener.
Port double: Port of the CLB listener.
Protocol string: Protocol of the listener. Available values are HTTP, HTTPS, TCP, UDP, TCP_SSL.
ResultOutputFile string

ClbId string: ID of the CLB.
Id string
ListenerLists []GetClbListenersListenerList: A list of listeners of cloud load balancers. Each element contains the following attributes:
ListenerId string: ID of the listener.
Port float64: Port of the CLB listener.
Protocol string: Protocol of the listener. Available values are HTTP, HTTPS, TCP, UDP, TCP_SSL.
ResultOutputFile string

clbId String: ID of the CLB.
id String
listenerLists List<GetClbListenersListenerList>: A list of listeners of cloud load balancers. Each element contains the following attributes:
listenerId String: ID of the listener.
port Double: Port of the CLB listener.
protocol String: Protocol of the listener. Available values are HTTP, HTTPS, TCP, UDP, TCP_SSL.
resultOutputFile String

clbId string: ID of the CLB.
id string
listenerLists GetClbListenersListenerList[]: A list of listeners of cloud load balancers. Each element contains the following attributes:
listenerId string: ID of the listener.
port number: Port of the CLB listener.
protocol string: Protocol of the listener. Available values are HTTP, HTTPS, TCP, UDP, TCP_SSL.
resultOutputFile string

clb_id str: ID of the CLB.
id str
listener_lists Sequence[GetClbListenersListenerList]: A list of listeners of cloud load balancers. Each element contains the following attributes:
listener_id str: ID of the listener.
port float: Port of the CLB listener.
protocol str: Protocol of the listener. Available values are HTTP, HTTPS, TCP, UDP, TCP_SSL.
result_output_file str

clbId String: ID of the CLB.
id String
listenerLists List<Property Map>: A list of listeners of cloud load balancers. Each element contains the following attributes:
listenerId String: ID of the listener.
port Number: Port of the CLB listener.
protocol String: Protocol of the listener. Available values are HTTP, HTTPS, TCP, UDP, TCP_SSL.
resultOutputFile String

Supporting Types

GetClbListenersListenerList

CertificateCaId string: Id of the client certificate. It must be set when SSLMode is mutual. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol.
CertificateId string: Id of the server certificate. It must be set when protocol is HTTPS or TCP_SSL. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
CertificateSslMode string: Type of certificate, and available values inclue UNIDIRECTIONAL, MUTUAL. NOTES: Only supports listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
ClbId string: Id of the CLB to be queried.
HealthCheckContextType string: Health check protocol.
HealthCheckHealthNum double: Health threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as healthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
HealthCheckHttpCode double: HTTP health check code of TCP listener.
HealthCheckHttpDomain string: HTTP health check domain of TCP listener.
HealthCheckHttpMethod string: HTTP health check method of TCP listener.
HealthCheckHttpPath string: HTTP health check path of TCP listener.
HealthCheckHttpVersion string: The HTTP version of the backend service.
HealthCheckIntervalTime double: Interval time of health check. The value range is 2-300 sec, and the default is 5 sec. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
HealthCheckPort double: The health check port is the port of the backend service.
HealthCheckRecvContext string: It represents the result returned by the health check.
HealthCheckSendContext string: It represents the content of the request sent by the health check.
HealthCheckSwitch bool: Indicates whether health check is enabled.
HealthCheckTimeOut double: Response timeout of health check. The value range is 2-60 sec, and the default is 2 sec. Response timeout needs to be less than check interval. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration.
HealthCheckType string: Protocol used for health check.
HealthCheckUnhealthNum double: Unhealthy threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as unhealthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
ListenerId string: Id of the listener to be queried.
ListenerName string: Name of the CLB listener.
Port double: Port of the CLB listener.
Protocol string: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
Scheduler string: Scheduling method of the CLB listener, and available values are WRR and LEAST_CONN. The default is WRR. NOTES: The listener of 'HTTP' and HTTPS protocol additionally supports the IP HASH method. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
SessionExpireTime double: Time of session persistence within the CLB listener. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
SniSwitch bool: Indicates whether SNI is enabled. NOTES: Only supported by HTTPS protocol.

CertificateCaId string: Id of the client certificate. It must be set when SSLMode is mutual. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol.
CertificateId string: Id of the server certificate. It must be set when protocol is HTTPS or TCP_SSL. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
CertificateSslMode string: Type of certificate, and available values inclue UNIDIRECTIONAL, MUTUAL. NOTES: Only supports listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
ClbId string: Id of the CLB to be queried.
HealthCheckContextType string: Health check protocol.
HealthCheckHealthNum float64: Health threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as healthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
HealthCheckHttpCode float64: HTTP health check code of TCP listener.
HealthCheckHttpDomain string: HTTP health check domain of TCP listener.
HealthCheckHttpMethod string: HTTP health check method of TCP listener.
HealthCheckHttpPath string: HTTP health check path of TCP listener.
HealthCheckHttpVersion string: The HTTP version of the backend service.
HealthCheckIntervalTime float64: Interval time of health check. The value range is 2-300 sec, and the default is 5 sec. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
HealthCheckPort float64: The health check port is the port of the backend service.
HealthCheckRecvContext string: It represents the result returned by the health check.
HealthCheckSendContext string: It represents the content of the request sent by the health check.
HealthCheckSwitch bool: Indicates whether health check is enabled.
HealthCheckTimeOut float64: Response timeout of health check. The value range is 2-60 sec, and the default is 2 sec. Response timeout needs to be less than check interval. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration.
HealthCheckType string: Protocol used for health check.
HealthCheckUnhealthNum float64: Unhealthy threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as unhealthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
ListenerId string: Id of the listener to be queried.
ListenerName string: Name of the CLB listener.
Port float64: Port of the CLB listener.
Protocol string: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
Scheduler string: Scheduling method of the CLB listener, and available values are WRR and LEAST_CONN. The default is WRR. NOTES: The listener of 'HTTP' and HTTPS protocol additionally supports the IP HASH method. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
SessionExpireTime float64: Time of session persistence within the CLB listener. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
SniSwitch bool: Indicates whether SNI is enabled. NOTES: Only supported by HTTPS protocol.

certificateCaId String: Id of the client certificate. It must be set when SSLMode is mutual. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol.
certificateId String: Id of the server certificate. It must be set when protocol is HTTPS or TCP_SSL. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
certificateSslMode String: Type of certificate, and available values inclue UNIDIRECTIONAL, MUTUAL. NOTES: Only supports listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
clbId String: Id of the CLB to be queried.
healthCheckContextType String: Health check protocol.
healthCheckHealthNum Double: Health threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as healthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
healthCheckHttpCode Double: HTTP health check code of TCP listener.
healthCheckHttpDomain String: HTTP health check domain of TCP listener.
healthCheckHttpMethod String: HTTP health check method of TCP listener.
healthCheckHttpPath String: HTTP health check path of TCP listener.
healthCheckHttpVersion String: The HTTP version of the backend service.
healthCheckIntervalTime Double: Interval time of health check. The value range is 2-300 sec, and the default is 5 sec. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
healthCheckPort Double: The health check port is the port of the backend service.
healthCheckRecvContext String: It represents the result returned by the health check.
healthCheckSendContext String: It represents the content of the request sent by the health check.
healthCheckSwitch Boolean: Indicates whether health check is enabled.
healthCheckTimeOut Double: Response timeout of health check. The value range is 2-60 sec, and the default is 2 sec. Response timeout needs to be less than check interval. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration.
healthCheckType String: Protocol used for health check.
healthCheckUnhealthNum Double: Unhealthy threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as unhealthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
listenerId String: Id of the listener to be queried.
listenerName String: Name of the CLB listener.
port Double: Port of the CLB listener.
protocol String: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
scheduler String: Scheduling method of the CLB listener, and available values are WRR and LEAST_CONN. The default is WRR. NOTES: The listener of 'HTTP' and HTTPS protocol additionally supports the IP HASH method. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
sessionExpireTime Double: Time of session persistence within the CLB listener. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
sniSwitch Boolean: Indicates whether SNI is enabled. NOTES: Only supported by HTTPS protocol.

certificateCaId string: Id of the client certificate. It must be set when SSLMode is mutual. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol.
certificateId string: Id of the server certificate. It must be set when protocol is HTTPS or TCP_SSL. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
certificateSslMode string: Type of certificate, and available values inclue UNIDIRECTIONAL, MUTUAL. NOTES: Only supports listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
clbId string: Id of the CLB to be queried.
healthCheckContextType string: Health check protocol.
healthCheckHealthNum number: Health threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as healthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
healthCheckHttpCode number: HTTP health check code of TCP listener.
healthCheckHttpDomain string: HTTP health check domain of TCP listener.
healthCheckHttpMethod string: HTTP health check method of TCP listener.
healthCheckHttpPath string: HTTP health check path of TCP listener.
healthCheckHttpVersion string: The HTTP version of the backend service.
healthCheckIntervalTime number: Interval time of health check. The value range is 2-300 sec, and the default is 5 sec. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
healthCheckPort number: The health check port is the port of the backend service.
healthCheckRecvContext string: It represents the result returned by the health check.
healthCheckSendContext string: It represents the content of the request sent by the health check.
healthCheckSwitch boolean: Indicates whether health check is enabled.
healthCheckTimeOut number: Response timeout of health check. The value range is 2-60 sec, and the default is 2 sec. Response timeout needs to be less than check interval. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration.
healthCheckType string: Protocol used for health check.
healthCheckUnhealthNum number: Unhealthy threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as unhealthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
listenerId string: Id of the listener to be queried.
listenerName string: Name of the CLB listener.
port number: Port of the CLB listener.
protocol string: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
scheduler string: Scheduling method of the CLB listener, and available values are WRR and LEAST_CONN. The default is WRR. NOTES: The listener of 'HTTP' and HTTPS protocol additionally supports the IP HASH method. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
sessionExpireTime number: Time of session persistence within the CLB listener. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
sniSwitch boolean: Indicates whether SNI is enabled. NOTES: Only supported by HTTPS protocol.

certificate_ca_id str: Id of the client certificate. It must be set when SSLMode is mutual. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol.
certificate_id str: Id of the server certificate. It must be set when protocol is HTTPS or TCP_SSL. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
certificate_ssl_mode str: Type of certificate, and available values inclue UNIDIRECTIONAL, MUTUAL. NOTES: Only supports listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
clb_id str: Id of the CLB to be queried.
health_check_context_type str: Health check protocol.
health_check_health_num float: Health threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as healthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
health_check_http_code float: HTTP health check code of TCP listener.
health_check_http_domain str: HTTP health check domain of TCP listener.
health_check_http_method str: HTTP health check method of TCP listener.
health_check_http_path str: HTTP health check path of TCP listener.
health_check_http_version str: The HTTP version of the backend service.
health_check_interval_time float: Interval time of health check. The value range is 2-300 sec, and the default is 5 sec. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
health_check_port float: The health check port is the port of the backend service.
health_check_recv_context str: It represents the result returned by the health check.
health_check_send_context str: It represents the content of the request sent by the health check.
health_check_switch bool: Indicates whether health check is enabled.
health_check_time_out float: Response timeout of health check. The value range is 2-60 sec, and the default is 2 sec. Response timeout needs to be less than check interval. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration.
health_check_type str: Protocol used for health check.
health_check_unhealth_num float: Unhealthy threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as unhealthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
listener_id str: Id of the listener to be queried.
listener_name str: Name of the CLB listener.
port float: Port of the CLB listener.
protocol str: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
scheduler str: Scheduling method of the CLB listener, and available values are WRR and LEAST_CONN. The default is WRR. NOTES: The listener of 'HTTP' and HTTPS protocol additionally supports the IP HASH method. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
session_expire_time float: Time of session persistence within the CLB listener. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
sni_switch bool: Indicates whether SNI is enabled. NOTES: Only supported by HTTPS protocol.

certificateCaId String: Id of the client certificate. It must be set when SSLMode is mutual. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol.
certificateId String: Id of the server certificate. It must be set when protocol is HTTPS or TCP_SSL. NOTES: only supported by listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
certificateSslMode String: Type of certificate, and available values inclue UNIDIRECTIONAL, MUTUAL. NOTES: Only supports listeners of HTTPS and TCP_SSL protocol and must be set when it is available.
clbId String: Id of the CLB to be queried.
healthCheckContextType String: Health check protocol.
healthCheckHealthNum Number: Health threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as healthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
healthCheckHttpCode Number: HTTP health check code of TCP listener.
healthCheckHttpDomain String: HTTP health check domain of TCP listener.
healthCheckHttpMethod String: HTTP health check method of TCP listener.
healthCheckHttpPath String: HTTP health check path of TCP listener.
healthCheckHttpVersion String: The HTTP version of the backend service.
healthCheckIntervalTime Number: Interval time of health check. The value range is 2-300 sec, and the default is 5 sec. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
healthCheckPort Number: The health check port is the port of the backend service.
healthCheckRecvContext String: It represents the result returned by the health check.
healthCheckSendContext String: It represents the content of the request sent by the health check.
healthCheckSwitch Boolean: Indicates whether health check is enabled.
healthCheckTimeOut Number: Response timeout of health check. The value range is 2-60 sec, and the default is 2 sec. Response timeout needs to be less than check interval. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration.
healthCheckType String: Protocol used for health check.
healthCheckUnhealthNum Number: Unhealthy threshold of health check, and the default is 3. If a success result is returned for the health check three consecutive times, the CVM is identified as unhealthy. The value range is 2-10. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
listenerId String: Id of the listener to be queried.
listenerName String: Name of the CLB listener.
port Number: Port of the CLB listener.
protocol String: Type of protocol within the listener, and available values are TCP, UDP, HTTP, HTTPS and TCP_SSL.
scheduler String: Scheduling method of the CLB listener, and available values are WRR and LEAST_CONN. The default is WRR. NOTES: The listener of 'HTTP' and HTTPS protocol additionally supports the IP HASH method. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
sessionExpireTime Number: Time of session persistence within the CLB listener. NOTES: TCP/UDP/TCP_SSL listener allows direct configuration, HTTP/HTTPS listener needs to be configured in tencentcloud_clb_listener_rule.
sniSwitch Boolean: Indicates whether SNI is enabled. NOTES: Only supported by HTTPS protocol.

Package Details

Repository: tencentcloud tencentcloudstack/terraform-provider-tencentcloud
License
Notes: This Pulumi package is based on the tencentcloud Terraform Provider.

tencentcloud 1.82.35 published on Friday, Nov 7, 2025 by tencentcloudstack

tencentcloudstack/terraform-provider-tencentcloud

tencentcloud.getClbListeners

On this page

On this page

Example Usage

Using getClbListeners

getClbListeners Result

Supporting Types

GetClbListenersListenerList

Package Details

On this page

On this page