1. Packages
  2. Volcengine
  3. API Docs
  4. clb
  5. Listener
Volcengine v0.0.45 published on Tuesday, Feb 10, 2026 by Volcengine
volcengine logo
Volcengine v0.0.45 published on Tuesday, Feb 10, 2026 by Volcengine

    Provides a resource to manage listener

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as volcengine from "@pulumi/volcengine";
    import * as volcengine from "@volcengine/pulumi";
    
    const fooZones = volcengine.ecs.getZones({});
    const fooVpc = new volcengine.vpc.Vpc("fooVpc", {
        vpcName: "acc-test-vpc",
        cidrBlock: "172.16.0.0/16",
    });
    const fooSubnet = new volcengine.vpc.Subnet("fooSubnet", {
        subnetName: "acc-test-subnet",
        cidrBlock: "172.16.0.0/24",
        zoneId: fooZones.then(fooZones => fooZones.zones?.[0]?.id),
        vpcId: fooVpc.id,
    });
    const fooClb = new volcengine.clb.Clb("fooClb", {
        type: "public",
        subnetId: fooSubnet.id,
        loadBalancerSpec: "small_1",
        description: "acc0Demo",
        loadBalancerName: "acc-test-create",
        eipBillingConfig: {
            isp: "BGP",
            eipBillingType: "PostPaidByBandwidth",
            bandwidth: 1,
        },
    });
    const fooServerGroup = new volcengine.clb.ServerGroup("fooServerGroup", {
        loadBalancerId: fooClb.id,
        serverGroupName: "acc-test-create",
        description: "hello demo11",
    });
    const fooListener = new volcengine.clb.Listener("fooListener", {
        loadBalancerId: fooClb.id,
        listenerName: "acc-test-listener",
        protocol: "HTTP",
        port: 90,
        serverGroupId: fooServerGroup.id,
        healthCheck: {
            enabled: "on",
            interval: 10,
            timeout: 3,
            healthyThreshold: 5,
            unHealthyThreshold: 2,
            domain: "volcengine.com",
            httpCode: "http_2xx",
            method: "GET",
            uri: "/",
        },
        tags: [{
            key: "k1",
            value: "v1",
        }],
        enabled: "on",
    });
    const fooTcp = new volcengine.clb.Listener("fooTcp", {
        loadBalancerId: fooClb.id,
        listenerName: "acc-test-listener",
        protocol: "TCP",
        port: 90,
        serverGroupId: fooServerGroup.id,
        enabled: "on",
        bandwidth: 2,
        proxyProtocolType: "standard",
        persistenceType: "source_ip",
        persistenceTimeout: 100,
        connectionDrainEnabled: "on",
        connectionDrainTimeout: 100,
    });
    const fooHttps = new volcengine.clb.Listener("fooHttps", {
        loadBalancerId: fooClb.id,
        listenerName: "acc-test-listener-https",
        protocol: "HTTPS",
        port: 100,
        serverGroupId: fooServerGroup.id,
        healthCheck: {
            enabled: "on",
            interval: 10,
            timeout: 3,
            healthyThreshold: 5,
            unHealthyThreshold: 2,
            domain: "volcengine.com",
            httpCode: "http_2xx,http_3xx",
            method: "GET",
            uri: "/",
        },
        enabled: "on",
        clientHeaderTimeout: 80,
        clientBodyTimeout: 80,
        keepaliveTimeout: 80,
        proxyConnectTimeout: 20,
        proxySendTimeout: 1800,
        proxyReadTimeout: 1800,
        certificateSource: "clb",
        certificateId: "cert-mjpctunmog745smt1a******",
        tags: [{
            key: "k1",
            value: "v1",
        }],
    });
    
    import pulumi
    import pulumi_volcengine as volcengine
    
    foo_zones = volcengine.ecs.get_zones()
    foo_vpc = volcengine.vpc.Vpc("fooVpc",
        vpc_name="acc-test-vpc",
        cidr_block="172.16.0.0/16")
    foo_subnet = volcengine.vpc.Subnet("fooSubnet",
        subnet_name="acc-test-subnet",
        cidr_block="172.16.0.0/24",
        zone_id=foo_zones.zones[0].id,
        vpc_id=foo_vpc.id)
    foo_clb = volcengine.clb.Clb("fooClb",
        type="public",
        subnet_id=foo_subnet.id,
        load_balancer_spec="small_1",
        description="acc0Demo",
        load_balancer_name="acc-test-create",
        eip_billing_config=volcengine.clb.ClbEipBillingConfigArgs(
            isp="BGP",
            eip_billing_type="PostPaidByBandwidth",
            bandwidth=1,
        ))
    foo_server_group = volcengine.clb.ServerGroup("fooServerGroup",
        load_balancer_id=foo_clb.id,
        server_group_name="acc-test-create",
        description="hello demo11")
    foo_listener = volcengine.clb.Listener("fooListener",
        load_balancer_id=foo_clb.id,
        listener_name="acc-test-listener",
        protocol="HTTP",
        port=90,
        server_group_id=foo_server_group.id,
        health_check=volcengine.clb.ListenerHealthCheckArgs(
            enabled="on",
            interval=10,
            timeout=3,
            healthy_threshold=5,
            un_healthy_threshold=2,
            domain="volcengine.com",
            http_code="http_2xx",
            method="GET",
            uri="/",
        ),
        tags=[volcengine.clb.ListenerTagArgs(
            key="k1",
            value="v1",
        )],
        enabled="on")
    foo_tcp = volcengine.clb.Listener("fooTcp",
        load_balancer_id=foo_clb.id,
        listener_name="acc-test-listener",
        protocol="TCP",
        port=90,
        server_group_id=foo_server_group.id,
        enabled="on",
        bandwidth=2,
        proxy_protocol_type="standard",
        persistence_type="source_ip",
        persistence_timeout=100,
        connection_drain_enabled="on",
        connection_drain_timeout=100)
    foo_https = volcengine.clb.Listener("fooHttps",
        load_balancer_id=foo_clb.id,
        listener_name="acc-test-listener-https",
        protocol="HTTPS",
        port=100,
        server_group_id=foo_server_group.id,
        health_check=volcengine.clb.ListenerHealthCheckArgs(
            enabled="on",
            interval=10,
            timeout=3,
            healthy_threshold=5,
            un_healthy_threshold=2,
            domain="volcengine.com",
            http_code="http_2xx,http_3xx",
            method="GET",
            uri="/",
        ),
        enabled="on",
        client_header_timeout=80,
        client_body_timeout=80,
        keepalive_timeout=80,
        proxy_connect_timeout=20,
        proxy_send_timeout=1800,
        proxy_read_timeout=1800,
        certificate_source="clb",
        certificate_id="cert-mjpctunmog745smt1a******",
        tags=[volcengine.clb.ListenerTagArgs(
            key="k1",
            value="v1",
        )])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/clb"
    	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/ecs"
    	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/vpc"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		fooZones, err := ecs.GetZones(ctx, nil, nil)
    		if err != nil {
    			return err
    		}
    		fooVpc, err := vpc.NewVpc(ctx, "fooVpc", &vpc.VpcArgs{
    			VpcName:   pulumi.String("acc-test-vpc"),
    			CidrBlock: pulumi.String("172.16.0.0/16"),
    		})
    		if err != nil {
    			return err
    		}
    		fooSubnet, err := vpc.NewSubnet(ctx, "fooSubnet", &vpc.SubnetArgs{
    			SubnetName: pulumi.String("acc-test-subnet"),
    			CidrBlock:  pulumi.String("172.16.0.0/24"),
    			ZoneId:     pulumi.String(fooZones.Zones[0].Id),
    			VpcId:      fooVpc.ID(),
    		})
    		if err != nil {
    			return err
    		}
    		fooClb, err := clb.NewClb(ctx, "fooClb", &clb.ClbArgs{
    			Type:             pulumi.String("public"),
    			SubnetId:         fooSubnet.ID(),
    			LoadBalancerSpec: pulumi.String("small_1"),
    			Description:      pulumi.String("acc0Demo"),
    			LoadBalancerName: pulumi.String("acc-test-create"),
    			EipBillingConfig: &clb.ClbEipBillingConfigArgs{
    				Isp:            pulumi.String("BGP"),
    				EipBillingType: pulumi.String("PostPaidByBandwidth"),
    				Bandwidth:      pulumi.Int(1),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		fooServerGroup, err := clb.NewServerGroup(ctx, "fooServerGroup", &clb.ServerGroupArgs{
    			LoadBalancerId:  fooClb.ID(),
    			ServerGroupName: pulumi.String("acc-test-create"),
    			Description:     pulumi.String("hello demo11"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = clb.NewListener(ctx, "fooListener", &clb.ListenerArgs{
    			LoadBalancerId: fooClb.ID(),
    			ListenerName:   pulumi.String("acc-test-listener"),
    			Protocol:       pulumi.String("HTTP"),
    			Port:           pulumi.Int(90),
    			ServerGroupId:  fooServerGroup.ID(),
    			HealthCheck: &clb.ListenerHealthCheckArgs{
    				Enabled:            pulumi.String("on"),
    				Interval:           pulumi.Int(10),
    				Timeout:            pulumi.Int(3),
    				HealthyThreshold:   pulumi.Int(5),
    				UnHealthyThreshold: pulumi.Int(2),
    				Domain:             pulumi.String("volcengine.com"),
    				HttpCode:           pulumi.String("http_2xx"),
    				Method:             pulumi.String("GET"),
    				Uri:                pulumi.String("/"),
    			},
    			Tags: clb.ListenerTagArray{
    				&clb.ListenerTagArgs{
    					Key:   pulumi.String("k1"),
    					Value: pulumi.String("v1"),
    				},
    			},
    			Enabled: pulumi.String("on"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = clb.NewListener(ctx, "fooTcp", &clb.ListenerArgs{
    			LoadBalancerId:         fooClb.ID(),
    			ListenerName:           pulumi.String("acc-test-listener"),
    			Protocol:               pulumi.String("TCP"),
    			Port:                   pulumi.Int(90),
    			ServerGroupId:          fooServerGroup.ID(),
    			Enabled:                pulumi.String("on"),
    			Bandwidth:              pulumi.Int(2),
    			ProxyProtocolType:      pulumi.String("standard"),
    			PersistenceType:        pulumi.String("source_ip"),
    			PersistenceTimeout:     pulumi.Int(100),
    			ConnectionDrainEnabled: pulumi.String("on"),
    			ConnectionDrainTimeout: pulumi.Int(100),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = clb.NewListener(ctx, "fooHttps", &clb.ListenerArgs{
    			LoadBalancerId: fooClb.ID(),
    			ListenerName:   pulumi.String("acc-test-listener-https"),
    			Protocol:       pulumi.String("HTTPS"),
    			Port:           pulumi.Int(100),
    			ServerGroupId:  fooServerGroup.ID(),
    			HealthCheck: &clb.ListenerHealthCheckArgs{
    				Enabled:            pulumi.String("on"),
    				Interval:           pulumi.Int(10),
    				Timeout:            pulumi.Int(3),
    				HealthyThreshold:   pulumi.Int(5),
    				UnHealthyThreshold: pulumi.Int(2),
    				Domain:             pulumi.String("volcengine.com"),
    				HttpCode:           pulumi.String("http_2xx,http_3xx"),
    				Method:             pulumi.String("GET"),
    				Uri:                pulumi.String("/"),
    			},
    			Enabled:             pulumi.String("on"),
    			ClientHeaderTimeout: pulumi.Int(80),
    			ClientBodyTimeout:   pulumi.Int(80),
    			KeepaliveTimeout:    pulumi.Int(80),
    			ProxyConnectTimeout: pulumi.Int(20),
    			ProxySendTimeout:    pulumi.Int(1800),
    			ProxyReadTimeout:    pulumi.Int(1800),
    			CertificateSource:   pulumi.String("clb"),
    			CertificateId:       pulumi.String("cert-mjpctunmog745smt1a******"),
    			Tags: clb.ListenerTagArray{
    				&clb.ListenerTagArgs{
    					Key:   pulumi.String("k1"),
    					Value: pulumi.String("v1"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Volcengine = Pulumi.Volcengine;
    
    return await Deployment.RunAsync(() => 
    {
        var fooZones = Volcengine.Ecs.GetZones.Invoke();
    
        var fooVpc = new Volcengine.Vpc.Vpc("fooVpc", new()
        {
            VpcName = "acc-test-vpc",
            CidrBlock = "172.16.0.0/16",
        });
    
        var fooSubnet = new Volcengine.Vpc.Subnet("fooSubnet", new()
        {
            SubnetName = "acc-test-subnet",
            CidrBlock = "172.16.0.0/24",
            ZoneId = fooZones.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
            VpcId = fooVpc.Id,
        });
    
        var fooClb = new Volcengine.Clb.Clb("fooClb", new()
        {
            Type = "public",
            SubnetId = fooSubnet.Id,
            LoadBalancerSpec = "small_1",
            Description = "acc0Demo",
            LoadBalancerName = "acc-test-create",
            EipBillingConfig = new Volcengine.Clb.Inputs.ClbEipBillingConfigArgs
            {
                Isp = "BGP",
                EipBillingType = "PostPaidByBandwidth",
                Bandwidth = 1,
            },
        });
    
        var fooServerGroup = new Volcengine.Clb.ServerGroup("fooServerGroup", new()
        {
            LoadBalancerId = fooClb.Id,
            ServerGroupName = "acc-test-create",
            Description = "hello demo11",
        });
    
        var fooListener = new Volcengine.Clb.Listener("fooListener", new()
        {
            LoadBalancerId = fooClb.Id,
            ListenerName = "acc-test-listener",
            Protocol = "HTTP",
            Port = 90,
            ServerGroupId = fooServerGroup.Id,
            HealthCheck = new Volcengine.Clb.Inputs.ListenerHealthCheckArgs
            {
                Enabled = "on",
                Interval = 10,
                Timeout = 3,
                HealthyThreshold = 5,
                UnHealthyThreshold = 2,
                Domain = "volcengine.com",
                HttpCode = "http_2xx",
                Method = "GET",
                Uri = "/",
            },
            Tags = new[]
            {
                new Volcengine.Clb.Inputs.ListenerTagArgs
                {
                    Key = "k1",
                    Value = "v1",
                },
            },
            Enabled = "on",
        });
    
        var fooTcp = new Volcengine.Clb.Listener("fooTcp", new()
        {
            LoadBalancerId = fooClb.Id,
            ListenerName = "acc-test-listener",
            Protocol = "TCP",
            Port = 90,
            ServerGroupId = fooServerGroup.Id,
            Enabled = "on",
            Bandwidth = 2,
            ProxyProtocolType = "standard",
            PersistenceType = "source_ip",
            PersistenceTimeout = 100,
            ConnectionDrainEnabled = "on",
            ConnectionDrainTimeout = 100,
        });
    
        var fooHttps = new Volcengine.Clb.Listener("fooHttps", new()
        {
            LoadBalancerId = fooClb.Id,
            ListenerName = "acc-test-listener-https",
            Protocol = "HTTPS",
            Port = 100,
            ServerGroupId = fooServerGroup.Id,
            HealthCheck = new Volcengine.Clb.Inputs.ListenerHealthCheckArgs
            {
                Enabled = "on",
                Interval = 10,
                Timeout = 3,
                HealthyThreshold = 5,
                UnHealthyThreshold = 2,
                Domain = "volcengine.com",
                HttpCode = "http_2xx,http_3xx",
                Method = "GET",
                Uri = "/",
            },
            Enabled = "on",
            ClientHeaderTimeout = 80,
            ClientBodyTimeout = 80,
            KeepaliveTimeout = 80,
            ProxyConnectTimeout = 20,
            ProxySendTimeout = 1800,
            ProxyReadTimeout = 1800,
            CertificateSource = "clb",
            CertificateId = "cert-mjpctunmog745smt1a******",
            Tags = new[]
            {
                new Volcengine.Clb.Inputs.ListenerTagArgs
                {
                    Key = "k1",
                    Value = "v1",
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.volcengine.ecs.EcsFunctions;
    import com.pulumi.volcengine.ecs.inputs.GetZonesArgs;
    import com.pulumi.volcengine.vpc.Vpc;
    import com.pulumi.volcengine.vpc.VpcArgs;
    import com.pulumi.volcengine.vpc.Subnet;
    import com.pulumi.volcengine.vpc.SubnetArgs;
    import com.pulumi.volcengine.clb.Clb;
    import com.pulumi.volcengine.clb.ClbArgs;
    import com.pulumi.volcengine.clb.inputs.ClbEipBillingConfigArgs;
    import com.pulumi.volcengine.clb.ServerGroup;
    import com.pulumi.volcengine.clb.ServerGroupArgs;
    import com.pulumi.volcengine.clb.Listener;
    import com.pulumi.volcengine.clb.ListenerArgs;
    import com.pulumi.volcengine.clb.inputs.ListenerHealthCheckArgs;
    import com.pulumi.volcengine.clb.inputs.ListenerTagArgs;
    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 fooZones = EcsFunctions.getZones();
    
            var fooVpc = new Vpc("fooVpc", VpcArgs.builder()        
                .vpcName("acc-test-vpc")
                .cidrBlock("172.16.0.0/16")
                .build());
    
            var fooSubnet = new Subnet("fooSubnet", SubnetArgs.builder()        
                .subnetName("acc-test-subnet")
                .cidrBlock("172.16.0.0/24")
                .zoneId(fooZones.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
                .vpcId(fooVpc.id())
                .build());
    
            var fooClb = new Clb("fooClb", ClbArgs.builder()        
                .type("public")
                .subnetId(fooSubnet.id())
                .loadBalancerSpec("small_1")
                .description("acc0Demo")
                .loadBalancerName("acc-test-create")
                .eipBillingConfig(ClbEipBillingConfigArgs.builder()
                    .isp("BGP")
                    .eipBillingType("PostPaidByBandwidth")
                    .bandwidth(1)
                    .build())
                .build());
    
            var fooServerGroup = new ServerGroup("fooServerGroup", ServerGroupArgs.builder()        
                .loadBalancerId(fooClb.id())
                .serverGroupName("acc-test-create")
                .description("hello demo11")
                .build());
    
            var fooListener = new Listener("fooListener", ListenerArgs.builder()        
                .loadBalancerId(fooClb.id())
                .listenerName("acc-test-listener")
                .protocol("HTTP")
                .port(90)
                .serverGroupId(fooServerGroup.id())
                .healthCheck(ListenerHealthCheckArgs.builder()
                    .enabled("on")
                    .interval(10)
                    .timeout(3)
                    .healthyThreshold(5)
                    .unHealthyThreshold(2)
                    .domain("volcengine.com")
                    .httpCode("http_2xx")
                    .method("GET")
                    .uri("/")
                    .build())
                .tags(ListenerTagArgs.builder()
                    .key("k1")
                    .value("v1")
                    .build())
                .enabled("on")
                .build());
    
            var fooTcp = new Listener("fooTcp", ListenerArgs.builder()        
                .loadBalancerId(fooClb.id())
                .listenerName("acc-test-listener")
                .protocol("TCP")
                .port(90)
                .serverGroupId(fooServerGroup.id())
                .enabled("on")
                .bandwidth(2)
                .proxyProtocolType("standard")
                .persistenceType("source_ip")
                .persistenceTimeout(100)
                .connectionDrainEnabled("on")
                .connectionDrainTimeout(100)
                .build());
    
            var fooHttps = new Listener("fooHttps", ListenerArgs.builder()        
                .loadBalancerId(fooClb.id())
                .listenerName("acc-test-listener-https")
                .protocol("HTTPS")
                .port(100)
                .serverGroupId(fooServerGroup.id())
                .healthCheck(ListenerHealthCheckArgs.builder()
                    .enabled("on")
                    .interval(10)
                    .timeout(3)
                    .healthyThreshold(5)
                    .unHealthyThreshold(2)
                    .domain("volcengine.com")
                    .httpCode("http_2xx,http_3xx")
                    .method("GET")
                    .uri("/")
                    .build())
                .enabled("on")
                .clientHeaderTimeout(80)
                .clientBodyTimeout(80)
                .keepaliveTimeout(80)
                .proxyConnectTimeout(20)
                .proxySendTimeout(1800)
                .proxyReadTimeout(1800)
                .certificateSource("clb")
                .certificateId("cert-mjpctunmog745smt1a******")
                .tags(ListenerTagArgs.builder()
                    .key("k1")
                    .value("v1")
                    .build())
                .build());
    
        }
    }
    
    resources:
      fooVpc:
        type: volcengine:vpc:Vpc
        properties:
          vpcName: acc-test-vpc
          cidrBlock: 172.16.0.0/16
      fooSubnet:
        type: volcengine:vpc:Subnet
        properties:
          subnetName: acc-test-subnet
          cidrBlock: 172.16.0.0/24
          zoneId: ${fooZones.zones[0].id}
          vpcId: ${fooVpc.id}
      fooClb:
        type: volcengine:clb:Clb
        properties:
          type: public
          subnetId: ${fooSubnet.id}
          loadBalancerSpec: small_1
          description: acc0Demo
          loadBalancerName: acc-test-create
          eipBillingConfig:
            isp: BGP
            eipBillingType: PostPaidByBandwidth
            bandwidth: 1
      fooServerGroup:
        type: volcengine:clb:ServerGroup
        properties:
          loadBalancerId: ${fooClb.id}
          serverGroupName: acc-test-create
          description: hello demo11
      fooListener:
        type: volcengine:clb:Listener
        properties:
          loadBalancerId: ${fooClb.id}
          listenerName: acc-test-listener
          protocol: HTTP
          port: 90
          serverGroupId: ${fooServerGroup.id}
          healthCheck:
            enabled: on
            interval: 10
            timeout: 3
            healthyThreshold: 5
            unHealthyThreshold: 2
            domain: volcengine.com
            httpCode: http_2xx
            method: GET
            uri: /
          tags:
            - key: k1
              value: v1
          enabled: on
      fooTcp:
        type: volcengine:clb:Listener
        properties:
          loadBalancerId: ${fooClb.id}
          listenerName: acc-test-listener
          protocol: TCP
          port: 90
          serverGroupId: ${fooServerGroup.id}
          enabled: on
          bandwidth: 2
          proxyProtocolType: standard
          persistenceType: source_ip
          persistenceTimeout: 100
          connectionDrainEnabled: on
          connectionDrainTimeout: 100
      fooHttps:
        type: volcengine:clb:Listener
        properties:
          loadBalancerId: ${fooClb.id}
          listenerName: acc-test-listener-https
          protocol: HTTPS
          port: 100
          serverGroupId: ${fooServerGroup.id}
          healthCheck:
            enabled: on
            interval: 10
            timeout: 3
            healthyThreshold: 5
            unHealthyThreshold: 2
            domain: volcengine.com
            httpCode: http_2xx,http_3xx
            method: GET
            uri: /
          enabled: on
          clientHeaderTimeout: 80
          clientBodyTimeout: 80
          keepaliveTimeout: 80
          proxyConnectTimeout: 20
          proxySendTimeout: 1800
          proxyReadTimeout: 1800
          certificateSource: clb
          certificateId: cert-mjpctunmog745smt1a******
          tags:
            - key: k1
              value: v1
    variables:
      fooZones:
        fn::invoke:
          Function: volcengine:ecs:getZones
          Arguments: {}
    

    Create Listener Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Listener(name: string, args: ListenerArgs, opts?: CustomResourceOptions);
    @overload
    def Listener(resource_name: str,
                 args: ListenerArgs,
                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def Listener(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 load_balancer_id: Optional[str] = None,
                 server_group_id: Optional[str] = None,
                 protocol: Optional[str] = None,
                 port: Optional[int] = None,
                 client_body_timeout: Optional[int] = None,
                 keepalive_timeout: Optional[int] = None,
                 cert_center_certificate_id: Optional[str] = None,
                 certificate_id: Optional[str] = None,
                 certificate_source: Optional[str] = None,
                 acl_ids: Optional[Sequence[str]] = None,
                 client_header_timeout: Optional[int] = None,
                 connection_drain_enabled: Optional[str] = None,
                 connection_drain_timeout: Optional[int] = None,
                 cookie: Optional[str] = None,
                 cps: Optional[int] = None,
                 description: Optional[str] = None,
                 enabled: Optional[str] = None,
                 end_port: Optional[int] = None,
                 established_timeout: Optional[int] = None,
                 health_check: Optional[ListenerHealthCheckArgs] = None,
                 http2_enabled: Optional[str] = None,
                 ca_enabled: Optional[str] = None,
                 listener_name: Optional[str] = None,
                 ca_certificate_id: Optional[str] = None,
                 max_connections: Optional[int] = None,
                 persistence_timeout: Optional[int] = None,
                 persistence_type: Optional[str] = None,
                 bandwidth: Optional[int] = None,
                 acl_type: Optional[str] = None,
                 proxy_connect_timeout: Optional[int] = None,
                 proxy_protocol_type: Optional[str] = None,
                 proxy_read_timeout: Optional[int] = None,
                 proxy_send_timeout: Optional[int] = None,
                 scheduler: Optional[str] = None,
                 security_policy_id: Optional[str] = None,
                 send_timeout: Optional[int] = None,
                 acl_status: Optional[str] = None,
                 start_port: Optional[int] = None,
                 tags: Optional[Sequence[ListenerTagArgs]] = None)
    func NewListener(ctx *Context, name string, args ListenerArgs, opts ...ResourceOption) (*Listener, error)
    public Listener(string name, ListenerArgs args, CustomResourceOptions? opts = null)
    public Listener(String name, ListenerArgs args)
    public Listener(String name, ListenerArgs args, CustomResourceOptions options)
    
    type: volcengine:clb:Listener
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args ListenerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ListenerArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ListenerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ListenerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ListenerArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var volcengineListenerResource = new Volcengine.Clb.Listener("volcengineListenerResource", new()
    {
        LoadBalancerId = "string",
        ServerGroupId = "string",
        Protocol = "string",
        Port = 0,
        ClientBodyTimeout = 0,
        KeepaliveTimeout = 0,
        CertCenterCertificateId = "string",
        CertificateId = "string",
        CertificateSource = "string",
        AclIds = new[]
        {
            "string",
        },
        ClientHeaderTimeout = 0,
        ConnectionDrainEnabled = "string",
        ConnectionDrainTimeout = 0,
        Cookie = "string",
        Cps = 0,
        Description = "string",
        Enabled = "string",
        EndPort = 0,
        EstablishedTimeout = 0,
        HealthCheck = new Volcengine.Clb.Inputs.ListenerHealthCheckArgs
        {
            Domain = "string",
            Enabled = "string",
            HealthyThreshold = 0,
            HttpCode = "string",
            Interval = 0,
            Method = "string",
            Port = 0,
            Timeout = 0,
            UdpExpect = "string",
            UdpRequest = "string",
            UnHealthyThreshold = 0,
            Uri = "string",
        },
        Http2Enabled = "string",
        CaEnabled = "string",
        ListenerName = "string",
        CaCertificateId = "string",
        MaxConnections = 0,
        PersistenceTimeout = 0,
        PersistenceType = "string",
        Bandwidth = 0,
        AclType = "string",
        ProxyConnectTimeout = 0,
        ProxyProtocolType = "string",
        ProxyReadTimeout = 0,
        ProxySendTimeout = 0,
        Scheduler = "string",
        SecurityPolicyId = "string",
        SendTimeout = 0,
        AclStatus = "string",
        StartPort = 0,
        Tags = new[]
        {
            new Volcengine.Clb.Inputs.ListenerTagArgs
            {
                Key = "string",
                Value = "string",
            },
        },
    });
    
    example, err := clb.NewListener(ctx, "volcengineListenerResource", &clb.ListenerArgs{
    	LoadBalancerId:          pulumi.String("string"),
    	ServerGroupId:           pulumi.String("string"),
    	Protocol:                pulumi.String("string"),
    	Port:                    pulumi.Int(0),
    	ClientBodyTimeout:       pulumi.Int(0),
    	KeepaliveTimeout:        pulumi.Int(0),
    	CertCenterCertificateId: pulumi.String("string"),
    	CertificateId:           pulumi.String("string"),
    	CertificateSource:       pulumi.String("string"),
    	AclIds: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	ClientHeaderTimeout:    pulumi.Int(0),
    	ConnectionDrainEnabled: pulumi.String("string"),
    	ConnectionDrainTimeout: pulumi.Int(0),
    	Cookie:                 pulumi.String("string"),
    	Cps:                    pulumi.Int(0),
    	Description:            pulumi.String("string"),
    	Enabled:                pulumi.String("string"),
    	EndPort:                pulumi.Int(0),
    	EstablishedTimeout:     pulumi.Int(0),
    	HealthCheck: &clb.ListenerHealthCheckArgs{
    		Domain:             pulumi.String("string"),
    		Enabled:            pulumi.String("string"),
    		HealthyThreshold:   pulumi.Int(0),
    		HttpCode:           pulumi.String("string"),
    		Interval:           pulumi.Int(0),
    		Method:             pulumi.String("string"),
    		Port:               pulumi.Int(0),
    		Timeout:            pulumi.Int(0),
    		UdpExpect:          pulumi.String("string"),
    		UdpRequest:         pulumi.String("string"),
    		UnHealthyThreshold: pulumi.Int(0),
    		Uri:                pulumi.String("string"),
    	},
    	Http2Enabled:        pulumi.String("string"),
    	CaEnabled:           pulumi.String("string"),
    	ListenerName:        pulumi.String("string"),
    	CaCertificateId:     pulumi.String("string"),
    	MaxConnections:      pulumi.Int(0),
    	PersistenceTimeout:  pulumi.Int(0),
    	PersistenceType:     pulumi.String("string"),
    	Bandwidth:           pulumi.Int(0),
    	AclType:             pulumi.String("string"),
    	ProxyConnectTimeout: pulumi.Int(0),
    	ProxyProtocolType:   pulumi.String("string"),
    	ProxyReadTimeout:    pulumi.Int(0),
    	ProxySendTimeout:    pulumi.Int(0),
    	Scheduler:           pulumi.String("string"),
    	SecurityPolicyId:    pulumi.String("string"),
    	SendTimeout:         pulumi.Int(0),
    	AclStatus:           pulumi.String("string"),
    	StartPort:           pulumi.Int(0),
    	Tags: clb.ListenerTagArray{
    		&clb.ListenerTagArgs{
    			Key:   pulumi.String("string"),
    			Value: pulumi.String("string"),
    		},
    	},
    })
    
    var volcengineListenerResource = new com.pulumi.volcengine.clb.Listener("volcengineListenerResource", com.pulumi.volcengine.clb.ListenerArgs.builder()
        .loadBalancerId("string")
        .serverGroupId("string")
        .protocol("string")
        .port(0)
        .clientBodyTimeout(0)
        .keepaliveTimeout(0)
        .certCenterCertificateId("string")
        .certificateId("string")
        .certificateSource("string")
        .aclIds("string")
        .clientHeaderTimeout(0)
        .connectionDrainEnabled("string")
        .connectionDrainTimeout(0)
        .cookie("string")
        .cps(0)
        .description("string")
        .enabled("string")
        .endPort(0)
        .establishedTimeout(0)
        .healthCheck(ListenerHealthCheckArgs.builder()
            .domain("string")
            .enabled("string")
            .healthyThreshold(0)
            .httpCode("string")
            .interval(0)
            .method("string")
            .port(0)
            .timeout(0)
            .udpExpect("string")
            .udpRequest("string")
            .unHealthyThreshold(0)
            .uri("string")
            .build())
        .http2Enabled("string")
        .caEnabled("string")
        .listenerName("string")
        .caCertificateId("string")
        .maxConnections(0)
        .persistenceTimeout(0)
        .persistenceType("string")
        .bandwidth(0)
        .aclType("string")
        .proxyConnectTimeout(0)
        .proxyProtocolType("string")
        .proxyReadTimeout(0)
        .proxySendTimeout(0)
        .scheduler("string")
        .securityPolicyId("string")
        .sendTimeout(0)
        .aclStatus("string")
        .startPort(0)
        .tags(ListenerTagArgs.builder()
            .key("string")
            .value("string")
            .build())
        .build());
    
    volcengine_listener_resource = volcengine.clb.Listener("volcengineListenerResource",
        load_balancer_id="string",
        server_group_id="string",
        protocol="string",
        port=0,
        client_body_timeout=0,
        keepalive_timeout=0,
        cert_center_certificate_id="string",
        certificate_id="string",
        certificate_source="string",
        acl_ids=["string"],
        client_header_timeout=0,
        connection_drain_enabled="string",
        connection_drain_timeout=0,
        cookie="string",
        cps=0,
        description="string",
        enabled="string",
        end_port=0,
        established_timeout=0,
        health_check={
            "domain": "string",
            "enabled": "string",
            "healthy_threshold": 0,
            "http_code": "string",
            "interval": 0,
            "method": "string",
            "port": 0,
            "timeout": 0,
            "udp_expect": "string",
            "udp_request": "string",
            "un_healthy_threshold": 0,
            "uri": "string",
        },
        http2_enabled="string",
        ca_enabled="string",
        listener_name="string",
        ca_certificate_id="string",
        max_connections=0,
        persistence_timeout=0,
        persistence_type="string",
        bandwidth=0,
        acl_type="string",
        proxy_connect_timeout=0,
        proxy_protocol_type="string",
        proxy_read_timeout=0,
        proxy_send_timeout=0,
        scheduler="string",
        security_policy_id="string",
        send_timeout=0,
        acl_status="string",
        start_port=0,
        tags=[{
            "key": "string",
            "value": "string",
        }])
    
    const volcengineListenerResource = new volcengine.clb.Listener("volcengineListenerResource", {
        loadBalancerId: "string",
        serverGroupId: "string",
        protocol: "string",
        port: 0,
        clientBodyTimeout: 0,
        keepaliveTimeout: 0,
        certCenterCertificateId: "string",
        certificateId: "string",
        certificateSource: "string",
        aclIds: ["string"],
        clientHeaderTimeout: 0,
        connectionDrainEnabled: "string",
        connectionDrainTimeout: 0,
        cookie: "string",
        cps: 0,
        description: "string",
        enabled: "string",
        endPort: 0,
        establishedTimeout: 0,
        healthCheck: {
            domain: "string",
            enabled: "string",
            healthyThreshold: 0,
            httpCode: "string",
            interval: 0,
            method: "string",
            port: 0,
            timeout: 0,
            udpExpect: "string",
            udpRequest: "string",
            unHealthyThreshold: 0,
            uri: "string",
        },
        http2Enabled: "string",
        caEnabled: "string",
        listenerName: "string",
        caCertificateId: "string",
        maxConnections: 0,
        persistenceTimeout: 0,
        persistenceType: "string",
        bandwidth: 0,
        aclType: "string",
        proxyConnectTimeout: 0,
        proxyProtocolType: "string",
        proxyReadTimeout: 0,
        proxySendTimeout: 0,
        scheduler: "string",
        securityPolicyId: "string",
        sendTimeout: 0,
        aclStatus: "string",
        startPort: 0,
        tags: [{
            key: "string",
            value: "string",
        }],
    });
    
    type: volcengine:clb:Listener
    properties:
        aclIds:
            - string
        aclStatus: string
        aclType: string
        bandwidth: 0
        caCertificateId: string
        caEnabled: string
        certCenterCertificateId: string
        certificateId: string
        certificateSource: string
        clientBodyTimeout: 0
        clientHeaderTimeout: 0
        connectionDrainEnabled: string
        connectionDrainTimeout: 0
        cookie: string
        cps: 0
        description: string
        enabled: string
        endPort: 0
        establishedTimeout: 0
        healthCheck:
            domain: string
            enabled: string
            healthyThreshold: 0
            httpCode: string
            interval: 0
            method: string
            port: 0
            timeout: 0
            udpExpect: string
            udpRequest: string
            unHealthyThreshold: 0
            uri: string
        http2Enabled: string
        keepaliveTimeout: 0
        listenerName: string
        loadBalancerId: string
        maxConnections: 0
        persistenceTimeout: 0
        persistenceType: string
        port: 0
        protocol: string
        proxyConnectTimeout: 0
        proxyProtocolType: string
        proxyReadTimeout: 0
        proxySendTimeout: 0
        scheduler: string
        securityPolicyId: string
        sendTimeout: 0
        serverGroupId: string
        startPort: 0
        tags:
            - key: string
              value: string
    

    Listener Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Listener resource accepts the following input properties:

    LoadBalancerId string
    The region of the request.
    Port int
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    Protocol string
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    ServerGroupId string
    The server group id associated with the listener.
    AclIds List<string>
    The id list of the Acl.
    AclStatus string
    The enable status of Acl. Optional choice contains on, off.
    AclType string
    The type of the Acl. Optional choice contains white, black.
    Bandwidth int
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    CaCertificateId string
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    CaEnabled string
    Whether to enable CACertificate two-way authentication. Values: on, off.
    CertCenterCertificateId string
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    CertificateId string
    The certificate id associated with the listener.
    CertificateSource string
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    ClientBodyTimeout int
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    ClientHeaderTimeout int
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    ConnectionDrainEnabled string
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    ConnectionDrainTimeout int
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    Cookie string
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    Cps int
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    Description string
    The description of the Listener.
    Enabled string
    The enable status of the Listener. Optional choice contains on, off.
    EndPort int
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    EstablishedTimeout int
    The connection timeout of the Listener.
    HealthCheck ListenerHealthCheck
    The config of health check.
    Http2Enabled string
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    KeepaliveTimeout int
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    ListenerName string
    The name of the Listener.
    MaxConnections int
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    PersistenceTimeout int
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    PersistenceType string
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    ProxyConnectTimeout int
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    ProxyProtocolType string
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    ProxyReadTimeout int
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    ProxySendTimeout int
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    Scheduler string
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    SecurityPolicyId string
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    SendTimeout int
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    StartPort int
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    Tags List<ListenerTag>
    Tags.
    LoadBalancerId string
    The region of the request.
    Port int
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    Protocol string
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    ServerGroupId string
    The server group id associated with the listener.
    AclIds []string
    The id list of the Acl.
    AclStatus string
    The enable status of Acl. Optional choice contains on, off.
    AclType string
    The type of the Acl. Optional choice contains white, black.
    Bandwidth int
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    CaCertificateId string
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    CaEnabled string
    Whether to enable CACertificate two-way authentication. Values: on, off.
    CertCenterCertificateId string
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    CertificateId string
    The certificate id associated with the listener.
    CertificateSource string
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    ClientBodyTimeout int
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    ClientHeaderTimeout int
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    ConnectionDrainEnabled string
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    ConnectionDrainTimeout int
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    Cookie string
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    Cps int
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    Description string
    The description of the Listener.
    Enabled string
    The enable status of the Listener. Optional choice contains on, off.
    EndPort int
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    EstablishedTimeout int
    The connection timeout of the Listener.
    HealthCheck ListenerHealthCheckArgs
    The config of health check.
    Http2Enabled string
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    KeepaliveTimeout int
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    ListenerName string
    The name of the Listener.
    MaxConnections int
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    PersistenceTimeout int
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    PersistenceType string
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    ProxyConnectTimeout int
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    ProxyProtocolType string
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    ProxyReadTimeout int
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    ProxySendTimeout int
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    Scheduler string
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    SecurityPolicyId string
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    SendTimeout int
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    StartPort int
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    Tags []ListenerTagArgs
    Tags.
    loadBalancerId String
    The region of the request.
    port Integer
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    protocol String
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    serverGroupId String
    The server group id associated with the listener.
    aclIds List<String>
    The id list of the Acl.
    aclStatus String
    The enable status of Acl. Optional choice contains on, off.
    aclType String
    The type of the Acl. Optional choice contains white, black.
    bandwidth Integer
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    caCertificateId String
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    caEnabled String
    Whether to enable CACertificate two-way authentication. Values: on, off.
    certCenterCertificateId String
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    certificateId String
    The certificate id associated with the listener.
    certificateSource String
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    clientBodyTimeout Integer
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    clientHeaderTimeout Integer
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    connectionDrainEnabled String
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    connectionDrainTimeout Integer
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    cookie String
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    cps Integer
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    description String
    The description of the Listener.
    enabled String
    The enable status of the Listener. Optional choice contains on, off.
    endPort Integer
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    establishedTimeout Integer
    The connection timeout of the Listener.
    healthCheck ListenerHealthCheck
    The config of health check.
    http2Enabled String
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    keepaliveTimeout Integer
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    listenerName String
    The name of the Listener.
    maxConnections Integer
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    persistenceTimeout Integer
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    persistenceType String
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    proxyConnectTimeout Integer
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    proxyProtocolType String
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    proxyReadTimeout Integer
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    proxySendTimeout Integer
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    scheduler String
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    securityPolicyId String
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    sendTimeout Integer
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    startPort Integer
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    tags List<ListenerTag>
    Tags.
    loadBalancerId string
    The region of the request.
    port number
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    protocol string
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    serverGroupId string
    The server group id associated with the listener.
    aclIds string[]
    The id list of the Acl.
    aclStatus string
    The enable status of Acl. Optional choice contains on, off.
    aclType string
    The type of the Acl. Optional choice contains white, black.
    bandwidth number
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    caCertificateId string
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    caEnabled string
    Whether to enable CACertificate two-way authentication. Values: on, off.
    certCenterCertificateId string
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    certificateId string
    The certificate id associated with the listener.
    certificateSource string
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    clientBodyTimeout number
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    clientHeaderTimeout number
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    connectionDrainEnabled string
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    connectionDrainTimeout number
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    cookie string
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    cps number
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    description string
    The description of the Listener.
    enabled string
    The enable status of the Listener. Optional choice contains on, off.
    endPort number
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    establishedTimeout number
    The connection timeout of the Listener.
    healthCheck ListenerHealthCheck
    The config of health check.
    http2Enabled string
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    keepaliveTimeout number
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    listenerName string
    The name of the Listener.
    maxConnections number
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    persistenceTimeout number
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    persistenceType string
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    proxyConnectTimeout number
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    proxyProtocolType string
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    proxyReadTimeout number
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    proxySendTimeout number
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    scheduler string
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    securityPolicyId string
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    sendTimeout number
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    startPort number
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    tags ListenerTag[]
    Tags.
    load_balancer_id str
    The region of the request.
    port int
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    protocol str
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    server_group_id str
    The server group id associated with the listener.
    acl_ids Sequence[str]
    The id list of the Acl.
    acl_status str
    The enable status of Acl. Optional choice contains on, off.
    acl_type str
    The type of the Acl. Optional choice contains white, black.
    bandwidth int
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    ca_certificate_id str
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    ca_enabled str
    Whether to enable CACertificate two-way authentication. Values: on, off.
    cert_center_certificate_id str
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    certificate_id str
    The certificate id associated with the listener.
    certificate_source str
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    client_body_timeout int
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    client_header_timeout int
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    connection_drain_enabled str
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    connection_drain_timeout int
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    cookie str
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    cps int
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    description str
    The description of the Listener.
    enabled str
    The enable status of the Listener. Optional choice contains on, off.
    end_port int
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    established_timeout int
    The connection timeout of the Listener.
    health_check ListenerHealthCheckArgs
    The config of health check.
    http2_enabled str
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    keepalive_timeout int
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    listener_name str
    The name of the Listener.
    max_connections int
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    persistence_timeout int
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    persistence_type str
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    proxy_connect_timeout int
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    proxy_protocol_type str
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    proxy_read_timeout int
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    proxy_send_timeout int
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    scheduler str
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    security_policy_id str
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    send_timeout int
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    start_port int
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    tags Sequence[ListenerTagArgs]
    Tags.
    loadBalancerId String
    The region of the request.
    port Number
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    protocol String
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    serverGroupId String
    The server group id associated with the listener.
    aclIds List<String>
    The id list of the Acl.
    aclStatus String
    The enable status of Acl. Optional choice contains on, off.
    aclType String
    The type of the Acl. Optional choice contains white, black.
    bandwidth Number
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    caCertificateId String
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    caEnabled String
    Whether to enable CACertificate two-way authentication. Values: on, off.
    certCenterCertificateId String
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    certificateId String
    The certificate id associated with the listener.
    certificateSource String
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    clientBodyTimeout Number
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    clientHeaderTimeout Number
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    connectionDrainEnabled String
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    connectionDrainTimeout Number
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    cookie String
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    cps Number
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    description String
    The description of the Listener.
    enabled String
    The enable status of the Listener. Optional choice contains on, off.
    endPort Number
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    establishedTimeout Number
    The connection timeout of the Listener.
    healthCheck Property Map
    The config of health check.
    http2Enabled String
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    keepaliveTimeout Number
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    listenerName String
    The name of the Listener.
    maxConnections Number
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    persistenceTimeout Number
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    persistenceType String
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    proxyConnectTimeout Number
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    proxyProtocolType String
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    proxyReadTimeout Number
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    proxySendTimeout Number
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    scheduler String
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    securityPolicyId String
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    sendTimeout Number
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    startPort Number
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    tags List<Property Map>
    Tags.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Listener resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerId string
    The ID of the Listener.
    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerId string
    The ID of the Listener.
    id String
    The provider-assigned unique ID for this managed resource.
    listenerId String
    The ID of the Listener.
    id string
    The provider-assigned unique ID for this managed resource.
    listenerId string
    The ID of the Listener.
    id str
    The provider-assigned unique ID for this managed resource.
    listener_id str
    The ID of the Listener.
    id String
    The provider-assigned unique ID for this managed resource.
    listenerId String
    The ID of the Listener.

    Look up Existing Listener Resource

    Get an existing Listener resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ListenerState, opts?: CustomResourceOptions): Listener
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            acl_ids: Optional[Sequence[str]] = None,
            acl_status: Optional[str] = None,
            acl_type: Optional[str] = None,
            bandwidth: Optional[int] = None,
            ca_certificate_id: Optional[str] = None,
            ca_enabled: Optional[str] = None,
            cert_center_certificate_id: Optional[str] = None,
            certificate_id: Optional[str] = None,
            certificate_source: Optional[str] = None,
            client_body_timeout: Optional[int] = None,
            client_header_timeout: Optional[int] = None,
            connection_drain_enabled: Optional[str] = None,
            connection_drain_timeout: Optional[int] = None,
            cookie: Optional[str] = None,
            cps: Optional[int] = None,
            description: Optional[str] = None,
            enabled: Optional[str] = None,
            end_port: Optional[int] = None,
            established_timeout: Optional[int] = None,
            health_check: Optional[ListenerHealthCheckArgs] = None,
            http2_enabled: Optional[str] = None,
            keepalive_timeout: Optional[int] = None,
            listener_id: Optional[str] = None,
            listener_name: Optional[str] = None,
            load_balancer_id: Optional[str] = None,
            max_connections: Optional[int] = None,
            persistence_timeout: Optional[int] = None,
            persistence_type: Optional[str] = None,
            port: Optional[int] = None,
            protocol: Optional[str] = None,
            proxy_connect_timeout: Optional[int] = None,
            proxy_protocol_type: Optional[str] = None,
            proxy_read_timeout: Optional[int] = None,
            proxy_send_timeout: Optional[int] = None,
            scheduler: Optional[str] = None,
            security_policy_id: Optional[str] = None,
            send_timeout: Optional[int] = None,
            server_group_id: Optional[str] = None,
            start_port: Optional[int] = None,
            tags: Optional[Sequence[ListenerTagArgs]] = None) -> Listener
    func GetListener(ctx *Context, name string, id IDInput, state *ListenerState, opts ...ResourceOption) (*Listener, error)
    public static Listener Get(string name, Input<string> id, ListenerState? state, CustomResourceOptions? opts = null)
    public static Listener get(String name, Output<String> id, ListenerState state, CustomResourceOptions options)
    resources:  _:    type: volcengine:clb:Listener    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AclIds List<string>
    The id list of the Acl.
    AclStatus string
    The enable status of Acl. Optional choice contains on, off.
    AclType string
    The type of the Acl. Optional choice contains white, black.
    Bandwidth int
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    CaCertificateId string
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    CaEnabled string
    Whether to enable CACertificate two-way authentication. Values: on, off.
    CertCenterCertificateId string
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    CertificateId string
    The certificate id associated with the listener.
    CertificateSource string
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    ClientBodyTimeout int
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    ClientHeaderTimeout int
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    ConnectionDrainEnabled string
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    ConnectionDrainTimeout int
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    Cookie string
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    Cps int
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    Description string
    The description of the Listener.
    Enabled string
    The enable status of the Listener. Optional choice contains on, off.
    EndPort int
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    EstablishedTimeout int
    The connection timeout of the Listener.
    HealthCheck ListenerHealthCheck
    The config of health check.
    Http2Enabled string
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    KeepaliveTimeout int
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    ListenerId string
    The ID of the Listener.
    ListenerName string
    The name of the Listener.
    LoadBalancerId string
    The region of the request.
    MaxConnections int
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    PersistenceTimeout int
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    PersistenceType string
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    Port int
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    Protocol string
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    ProxyConnectTimeout int
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    ProxyProtocolType string
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    ProxyReadTimeout int
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    ProxySendTimeout int
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    Scheduler string
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    SecurityPolicyId string
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    SendTimeout int
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    ServerGroupId string
    The server group id associated with the listener.
    StartPort int
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    Tags List<ListenerTag>
    Tags.
    AclIds []string
    The id list of the Acl.
    AclStatus string
    The enable status of Acl. Optional choice contains on, off.
    AclType string
    The type of the Acl. Optional choice contains white, black.
    Bandwidth int
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    CaCertificateId string
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    CaEnabled string
    Whether to enable CACertificate two-way authentication. Values: on, off.
    CertCenterCertificateId string
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    CertificateId string
    The certificate id associated with the listener.
    CertificateSource string
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    ClientBodyTimeout int
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    ClientHeaderTimeout int
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    ConnectionDrainEnabled string
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    ConnectionDrainTimeout int
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    Cookie string
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    Cps int
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    Description string
    The description of the Listener.
    Enabled string
    The enable status of the Listener. Optional choice contains on, off.
    EndPort int
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    EstablishedTimeout int
    The connection timeout of the Listener.
    HealthCheck ListenerHealthCheckArgs
    The config of health check.
    Http2Enabled string
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    KeepaliveTimeout int
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    ListenerId string
    The ID of the Listener.
    ListenerName string
    The name of the Listener.
    LoadBalancerId string
    The region of the request.
    MaxConnections int
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    PersistenceTimeout int
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    PersistenceType string
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    Port int
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    Protocol string
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    ProxyConnectTimeout int
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    ProxyProtocolType string
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    ProxyReadTimeout int
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    ProxySendTimeout int
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    Scheduler string
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    SecurityPolicyId string
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    SendTimeout int
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    ServerGroupId string
    The server group id associated with the listener.
    StartPort int
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    Tags []ListenerTagArgs
    Tags.
    aclIds List<String>
    The id list of the Acl.
    aclStatus String
    The enable status of Acl. Optional choice contains on, off.
    aclType String
    The type of the Acl. Optional choice contains white, black.
    bandwidth Integer
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    caCertificateId String
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    caEnabled String
    Whether to enable CACertificate two-way authentication. Values: on, off.
    certCenterCertificateId String
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    certificateId String
    The certificate id associated with the listener.
    certificateSource String
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    clientBodyTimeout Integer
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    clientHeaderTimeout Integer
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    connectionDrainEnabled String
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    connectionDrainTimeout Integer
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    cookie String
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    cps Integer
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    description String
    The description of the Listener.
    enabled String
    The enable status of the Listener. Optional choice contains on, off.
    endPort Integer
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    establishedTimeout Integer
    The connection timeout of the Listener.
    healthCheck ListenerHealthCheck
    The config of health check.
    http2Enabled String
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    keepaliveTimeout Integer
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    listenerId String
    The ID of the Listener.
    listenerName String
    The name of the Listener.
    loadBalancerId String
    The region of the request.
    maxConnections Integer
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    persistenceTimeout Integer
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    persistenceType String
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    port Integer
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    protocol String
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    proxyConnectTimeout Integer
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    proxyProtocolType String
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    proxyReadTimeout Integer
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    proxySendTimeout Integer
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    scheduler String
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    securityPolicyId String
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    sendTimeout Integer
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    serverGroupId String
    The server group id associated with the listener.
    startPort Integer
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    tags List<ListenerTag>
    Tags.
    aclIds string[]
    The id list of the Acl.
    aclStatus string
    The enable status of Acl. Optional choice contains on, off.
    aclType string
    The type of the Acl. Optional choice contains white, black.
    bandwidth number
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    caCertificateId string
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    caEnabled string
    Whether to enable CACertificate two-way authentication. Values: on, off.
    certCenterCertificateId string
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    certificateId string
    The certificate id associated with the listener.
    certificateSource string
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    clientBodyTimeout number
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    clientHeaderTimeout number
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    connectionDrainEnabled string
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    connectionDrainTimeout number
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    cookie string
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    cps number
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    description string
    The description of the Listener.
    enabled string
    The enable status of the Listener. Optional choice contains on, off.
    endPort number
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    establishedTimeout number
    The connection timeout of the Listener.
    healthCheck ListenerHealthCheck
    The config of health check.
    http2Enabled string
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    keepaliveTimeout number
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    listenerId string
    The ID of the Listener.
    listenerName string
    The name of the Listener.
    loadBalancerId string
    The region of the request.
    maxConnections number
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    persistenceTimeout number
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    persistenceType string
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    port number
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    protocol string
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    proxyConnectTimeout number
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    proxyProtocolType string
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    proxyReadTimeout number
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    proxySendTimeout number
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    scheduler string
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    securityPolicyId string
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    sendTimeout number
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    serverGroupId string
    The server group id associated with the listener.
    startPort number
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    tags ListenerTag[]
    Tags.
    acl_ids Sequence[str]
    The id list of the Acl.
    acl_status str
    The enable status of Acl. Optional choice contains on, off.
    acl_type str
    The type of the Acl. Optional choice contains white, black.
    bandwidth int
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    ca_certificate_id str
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    ca_enabled str
    Whether to enable CACertificate two-way authentication. Values: on, off.
    cert_center_certificate_id str
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    certificate_id str
    The certificate id associated with the listener.
    certificate_source str
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    client_body_timeout int
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    client_header_timeout int
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    connection_drain_enabled str
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    connection_drain_timeout int
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    cookie str
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    cps int
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    description str
    The description of the Listener.
    enabled str
    The enable status of the Listener. Optional choice contains on, off.
    end_port int
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    established_timeout int
    The connection timeout of the Listener.
    health_check ListenerHealthCheckArgs
    The config of health check.
    http2_enabled str
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    keepalive_timeout int
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    listener_id str
    The ID of the Listener.
    listener_name str
    The name of the Listener.
    load_balancer_id str
    The region of the request.
    max_connections int
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    persistence_timeout int
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    persistence_type str
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    port int
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    protocol str
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    proxy_connect_timeout int
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    proxy_protocol_type str
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    proxy_read_timeout int
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    proxy_send_timeout int
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    scheduler str
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    security_policy_id str
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    send_timeout int
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    server_group_id str
    The server group id associated with the listener.
    start_port int
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    tags Sequence[ListenerTagArgs]
    Tags.
    aclIds List<String>
    The id list of the Acl.
    aclStatus String
    The enable status of Acl. Optional choice contains on, off.
    aclType String
    The type of the Acl. Optional choice contains white, black.
    bandwidth Number
    The bandwidth of the Listener. Unit: Mbps. Default is -1, indicating that the Listener does not specify a speed limit.
    caCertificateId String
    The ID of the CA certificate which is associated with the listener. When ca_enabled is on, this parameter is required.
    caEnabled String
    Whether to enable CACertificate two-way authentication. Values: on, off.
    certCenterCertificateId String
    The ID of the certificate in Certificate Center. When certificate_source is cert_center, this parameter is required.
    certificateId String
    The certificate id associated with the listener.
    certificateSource String
    The source of the certificate which is associated with the listener. Values: clb, cert_center.
    clientBodyTimeout Number
    The client body timeout of the Listener. Only HTTP/HTTPS listeners support this parameter. value range: 30-120.
    clientHeaderTimeout Number
    The client header timeout of the Listener. Only HTTP/HTTPS listeners support this parameter, i.e., protocol=HTTP or HTTPS. value range: 30-120.
    connectionDrainEnabled String
    Whether to enable connection drain of the Listener. Valid values: off, on. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    connectionDrainTimeout Number
    The connection drain timeout of the Listener. Valid value range is 0-900. This filed is required when the value of field connection_drain_enabled is on.
    cookie String
    The name of the cookie for session persistence configured on the backend server. When PersistenceType is configured as server, this parameter is required. When PersistenceType is configured as any other value, this parameter is not effective.
    cps Number
    The maximum number of new connections per second allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    description String
    The description of the Listener.
    enabled String
    The enable status of the Listener. Optional choice contains on, off.
    endPort Number
    The end port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required, and must be greater than start_port.
    establishedTimeout Number
    The connection timeout of the Listener.
    healthCheck Property Map
    The config of health check.
    http2Enabled String
    Whether the HTTPS protocol listener enables the front-end HTTP 2.0 protocol. value range: on, off.
    keepaliveTimeout Number
    The timeout period for the long connection between the client and the CLB. Only HTTP/HTTPS listeners support this parameter. value range: 0-900.
    listenerId String
    The ID of the Listener.
    listenerName String
    The name of the Listener.
    loadBalancerId String
    The region of the request.
    maxConnections Number
    The maximum number of connections allowed for the Listener. Default value: -1, no limit, which is the upper limit of new connections for the CLB instance.
    persistenceTimeout Number
    The persistence timeout of the Listener. Unit: second. Default is 1000. When PersistenceType is configured as source_ip, the value range is 1-3600. When PersistenceType is configured as insert, the value range is 1-86400. This filed is valid only when the value of field persistence_type is source_ip or insert.
    persistenceType String
    The persistence type of the Listener. Valid values: off, source_ip, insert, server. Default is off. source_ip: Represents the source IP address, only effective for TCP/UDP protocols. insert: means implanting a cookie, only effective for HTTP/HTTPS protocol and when the scheduler is wrr. server: Indicates rewriting cookies, only effective for HTTP/HTTPS protocols and when the scheduler is wrr.
    port Number
    The port receiving request of the Listener, the value range in 0~65535. When protocol is TCP or UDP, 0 can be passed in, indicating that full port listening is enabled.
    protocol String
    The protocol of the Listener. Optional choice contains TCP, UDP, HTTP, HTTPS.
    proxyConnectTimeout Number
    The timeout period for establishing a connection between the CLB and the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 4-120.
    proxyProtocolType String
    Whether to enable proxy protocol. Valid values: off, standard. Default is off. This filed is valid only when the value of field protocol is TCP or UDP.
    proxyReadTimeout Number
    The timeout period for CLB to read the response from the backend server. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    proxySendTimeout Number
    The timeout period for CLB to transmit requests to backend servers. Only HTTP/HTTPS listeners support this parameter. value range: 30-3600.
    scheduler String
    The scheduling algorithm of the Listener. Optional choice contains wrr, wlc, sh.
    securityPolicyId String
    The TLS security policy of the HTTPS listener. Only HTTPS listeners support this parameter. value range: default_policy, tls_cipher_policy_1_0, tls_cipher_policy_1_1, tls_cipher_policy_1_2, tls_cipher_policy_1_2_strict.
    sendTimeout Number
    The timeout period for CLB to send responses to the client. Only HTTP/HTTPS listeners support this parameter. value range: 1-3600.
    serverGroupId String
    The server group id associated with the listener.
    startPort Number
    The start port for full port listening, with a value range of 1-65535. When port is 0, this parameter is required.
    tags List<Property Map>
    Tags.

    Supporting Types

    ListenerHealthCheck, ListenerHealthCheckArgs

    Domain string
    The domain of health check.
    Enabled string
    The enable status of health check function. Optional choice contains on, off.
    HealthyThreshold int
    The healthy threshold of health check, default 3, range in 2~10.
    HttpCode string
    The normal http status code of health check, the value can be http_2xx or http_3xx or http_4xx or http_5xx.
    Interval int
    The interval executing health check, default 2, range in 1~300.
    Method string
    The method of health check, the value can be GET or HEAD.
    Port int
    The port for health check, with a value range of 1-65535.
    Timeout int
    The response timeout of health check, default 2, range in 1~60..
    UdpExpect string
    The UDP expect of health check. This field must be specified simultaneously with field udp_request.
    UdpRequest string
    The UDP request of health check. This field must be specified simultaneously with field udp_expect.
    UnHealthyThreshold int
    The unhealthy threshold of health check, default 3, range in 2~10.
    Uri string
    The uri of health check.
    Domain string
    The domain of health check.
    Enabled string
    The enable status of health check function. Optional choice contains on, off.
    HealthyThreshold int
    The healthy threshold of health check, default 3, range in 2~10.
    HttpCode string
    The normal http status code of health check, the value can be http_2xx or http_3xx or http_4xx or http_5xx.
    Interval int
    The interval executing health check, default 2, range in 1~300.
    Method string
    The method of health check, the value can be GET or HEAD.
    Port int
    The port for health check, with a value range of 1-65535.
    Timeout int
    The response timeout of health check, default 2, range in 1~60..
    UdpExpect string
    The UDP expect of health check. This field must be specified simultaneously with field udp_request.
    UdpRequest string
    The UDP request of health check. This field must be specified simultaneously with field udp_expect.
    UnHealthyThreshold int
    The unhealthy threshold of health check, default 3, range in 2~10.
    Uri string
    The uri of health check.
    domain String
    The domain of health check.
    enabled String
    The enable status of health check function. Optional choice contains on, off.
    healthyThreshold Integer
    The healthy threshold of health check, default 3, range in 2~10.
    httpCode String
    The normal http status code of health check, the value can be http_2xx or http_3xx or http_4xx or http_5xx.
    interval Integer
    The interval executing health check, default 2, range in 1~300.
    method String
    The method of health check, the value can be GET or HEAD.
    port Integer
    The port for health check, with a value range of 1-65535.
    timeout Integer
    The response timeout of health check, default 2, range in 1~60..
    udpExpect String
    The UDP expect of health check. This field must be specified simultaneously with field udp_request.
    udpRequest String
    The UDP request of health check. This field must be specified simultaneously with field udp_expect.
    unHealthyThreshold Integer
    The unhealthy threshold of health check, default 3, range in 2~10.
    uri String
    The uri of health check.
    domain string
    The domain of health check.
    enabled string
    The enable status of health check function. Optional choice contains on, off.
    healthyThreshold number
    The healthy threshold of health check, default 3, range in 2~10.
    httpCode string
    The normal http status code of health check, the value can be http_2xx or http_3xx or http_4xx or http_5xx.
    interval number
    The interval executing health check, default 2, range in 1~300.
    method string
    The method of health check, the value can be GET or HEAD.
    port number
    The port for health check, with a value range of 1-65535.
    timeout number
    The response timeout of health check, default 2, range in 1~60..
    udpExpect string
    The UDP expect of health check. This field must be specified simultaneously with field udp_request.
    udpRequest string
    The UDP request of health check. This field must be specified simultaneously with field udp_expect.
    unHealthyThreshold number
    The unhealthy threshold of health check, default 3, range in 2~10.
    uri string
    The uri of health check.
    domain str
    The domain of health check.
    enabled str
    The enable status of health check function. Optional choice contains on, off.
    healthy_threshold int
    The healthy threshold of health check, default 3, range in 2~10.
    http_code str
    The normal http status code of health check, the value can be http_2xx or http_3xx or http_4xx or http_5xx.
    interval int
    The interval executing health check, default 2, range in 1~300.
    method str
    The method of health check, the value can be GET or HEAD.
    port int
    The port for health check, with a value range of 1-65535.
    timeout int
    The response timeout of health check, default 2, range in 1~60..
    udp_expect str
    The UDP expect of health check. This field must be specified simultaneously with field udp_request.
    udp_request str
    The UDP request of health check. This field must be specified simultaneously with field udp_expect.
    un_healthy_threshold int
    The unhealthy threshold of health check, default 3, range in 2~10.
    uri str
    The uri of health check.
    domain String
    The domain of health check.
    enabled String
    The enable status of health check function. Optional choice contains on, off.
    healthyThreshold Number
    The healthy threshold of health check, default 3, range in 2~10.
    httpCode String
    The normal http status code of health check, the value can be http_2xx or http_3xx or http_4xx or http_5xx.
    interval Number
    The interval executing health check, default 2, range in 1~300.
    method String
    The method of health check, the value can be GET or HEAD.
    port Number
    The port for health check, with a value range of 1-65535.
    timeout Number
    The response timeout of health check, default 2, range in 1~60..
    udpExpect String
    The UDP expect of health check. This field must be specified simultaneously with field udp_request.
    udpRequest String
    The UDP request of health check. This field must be specified simultaneously with field udp_expect.
    unHealthyThreshold Number
    The unhealthy threshold of health check, default 3, range in 2~10.
    uri String
    The uri of health check.

    ListenerTag, ListenerTagArgs

    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.
    key string
    The Key of Tags.
    value string
    The Value of Tags.
    key str
    The Key of Tags.
    value str
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.

    Import

    Listener can be imported using the id, e.g.

    $ pulumi import volcengine:clb/listener:Listener default lsn-273yv0mhs5xj47fap8sehiiso
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    volcengine volcengine/pulumi-volcengine
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the volcengine Terraform Provider.
    volcengine logo
    Volcengine v0.0.45 published on Tuesday, Feb 10, 2026 by Volcengine
      Meet Neo: Your AI Platform Teammate