1. Packages
  2. Volcenginecc Provider
  3. API Docs
  4. clb
  5. NlbListener
volcenginecc v0.0.2 published on Saturday, Oct 11, 2025 by Volcengine
volcengine/pulumi-volcenginecc

volcenginecc.clb.NlbListener

Deploy with Pulumi
volcenginecc logo
volcenginecc v0.0.2 published on Saturday, Oct 11, 2025 by Volcengine
volcengine/pulumi-volcenginecc

    监听器负责根据指定的协议和端口，监听NLB实例接收到的用户访问请求。NLB将按照该监听器关联的服务器组配置的调度算法，将访问请求转发至该服务器组内健康的后端服务器。

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as volcenginecc from "@volcengine/pulumi-volcenginecc";

const cLBNLBListenerDemo = new volcenginecc.clb.NlbListener("CLBNLBListenerDemo", {
    loadBalancerId: "nlb-11zz9w3jqptz449iegfwvxxxx",
    protocol: "TCP",
    port: 0,
    serverGroupId: "rsp-11zz9wdewa3uo49ieggq8xxxx",
    connectionTimeout: 60,
    description: "CLBNLBListenerDemo description",
    enabled: true,
    listenerName: "CLBNLBListenerDemo",
    tags: [{
        key: "env",
        value: "Test",
    }],
});

    import pulumi
import pulumi_volcenginecc as volcenginecc

c_lbnlb_listener_demo = volcenginecc.clb.NlbListener("CLBNLBListenerDemo",
    load_balancer_id="nlb-11zz9w3jqptz449iegfwvxxxx",
    protocol="TCP",
    port=0,
    server_group_id="rsp-11zz9wdewa3uo49ieggq8xxxx",
    connection_timeout=60,
    description="CLBNLBListenerDemo description",
    enabled=True,
    listener_name="CLBNLBListenerDemo",
    tags=[{
        "key": "env",
        "value": "Test",
    }])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/volcengine/pulumi-volcenginecc/sdk/go/volcenginecc/clb"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := clb.NewNlbListener(ctx, "CLBNLBListenerDemo", &clb.NlbListenerArgs{
			LoadBalancerId:    pulumi.String("nlb-11zz9w3jqptz449iegfwvxxxx"),
			Protocol:          pulumi.String("TCP"),
			Port:              pulumi.Int(0),
			ServerGroupId:     pulumi.String("rsp-11zz9wdewa3uo49ieggq8xxxx"),
			ConnectionTimeout: pulumi.Int(60),
			Description:       pulumi.String("CLBNLBListenerDemo description"),
			Enabled:           pulumi.Bool(true),
			ListenerName:      pulumi.String("CLBNLBListenerDemo"),
			Tags: clb.NlbListenerTagArray{
				&clb.NlbListenerTagArgs{
					Key:   pulumi.String("env"),
					Value: pulumi.String("Test"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Volcenginecc = Volcengine.Pulumi.Volcenginecc;

return await Deployment.RunAsync(() => 
{
    var cLBNLBListenerDemo = new Volcenginecc.Clb.NlbListener("CLBNLBListenerDemo", new()
    {
        LoadBalancerId = "nlb-11zz9w3jqptz449iegfwvxxxx",
        Protocol = "TCP",
        Port = 0,
        ServerGroupId = "rsp-11zz9wdewa3uo49ieggq8xxxx",
        ConnectionTimeout = 60,
        Description = "CLBNLBListenerDemo description",
        Enabled = true,
        ListenerName = "CLBNLBListenerDemo",
        Tags = new[]
        {
            new Volcenginecc.Clb.Inputs.NlbListenerTagArgs
            {
                Key = "env",
                Value = "Test",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.volcengine.volcenginecc.clb.NlbListener;
import com.volcengine.volcenginecc.clb.NlbListenerArgs;
import com.pulumi.volcenginecc.clb.inputs.NlbListenerTagArgs;
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) {
        var cLBNLBListenerDemo = new NlbListener("cLBNLBListenerDemo", NlbListenerArgs.builder()
            .loadBalancerId("nlb-11zz9w3jqptz449iegfwvxxxx")
            .protocol("TCP")
            .port(0)
            .serverGroupId("rsp-11zz9wdewa3uo49ieggq8xxxx")
            .connectionTimeout(60)
            .description("CLBNLBListenerDemo description")
            .enabled(true)
            .listenerName("CLBNLBListenerDemo")
            .tags(NlbListenerTagArgs.builder()
                .key("env")
                .value("Test")
                .build())
            .build());

    }
}

    resources:
  cLBNLBListenerDemo:
    type: volcenginecc:clb:NlbListener
    name: CLBNLBListenerDemo
    properties:
      loadBalancerId: nlb-11zz9w3jqptz449iegfwvxxxx
      protocol: TCP
      port: 0
      serverGroupId: rsp-11zz9wdewa3uo49ieggq8xxxx
      connectionTimeout: 60
      description: CLBNLBListenerDemo description
      enabled: true
      listenerName: CLBNLBListenerDemo
      tags:
        - key: env
          value: Test

    Create NlbListener Resource

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

    Constructor syntax

    new NlbListener(name: string, args: NlbListenerArgs, opts?: CustomResourceOptions);
    @overload
def NlbListener(resource_name: str,
                args: NlbListenerArgs,
                opts: Optional[ResourceOptions] = None)

@overload
def NlbListener(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,
                enabled: Optional[bool] = None,
                healths: Optional[Sequence[NlbListenerHealthArgs]] = None,
                listener_name: Optional[str] = None,
                end_port: Optional[int] = None,
                certificate_id: Optional[str] = None,
                description: Optional[str] = None,
                security_policy_id: Optional[str] = None,
                connection_timeout: Optional[int] = None,
                start_port: Optional[int] = None,
                tags: Optional[Sequence[NlbListenerTagArgs]] = None)
    func NewNlbListener(ctx *Context, name string, args NlbListenerArgs, opts ...ResourceOption) (*NlbListener, error)
    public NlbListener(string name, NlbListenerArgs args, CustomResourceOptions? opts = null)
    public NlbListener(String name, NlbListenerArgs args)
public NlbListener(String name, NlbListenerArgs args, CustomResourceOptions options)

    type: volcenginecc:clb:NlbListener
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 NlbListenerArgs
    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 NlbListenerArgs
    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 NlbListenerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args NlbListenerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args NlbListenerArgs
    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 nlbListenerResource = new Volcenginecc.Clb.NlbListener("nlbListenerResource", new()
{
    LoadBalancerId = "string",
    ServerGroupId = "string",
    Protocol = "string",
    Port = 0,
    Enabled = false,
    Healths = new[]
    {
        new Volcenginecc.Clb.Inputs.NlbListenerHealthArgs
        {
            InstanceId = "string",
            Ip = "string",
            Port = 0,
            ServerId = "string",
            ServerType = "string",
            Status = "string",
            UpdatedTime = "string",
            ZoneId = "string",
        },
    },
    ListenerName = "string",
    EndPort = 0,
    CertificateId = "string",
    Description = "string",
    SecurityPolicyId = "string",
    ConnectionTimeout = 0,
    StartPort = 0,
    Tags = new[]
    {
        new Volcenginecc.Clb.Inputs.NlbListenerTagArgs
        {
            Key = "string",
            Value = "string",
        },
    },
});

    example, err := clb.NewNlbListener(ctx, "nlbListenerResource", &clb.NlbListenerArgs{
	LoadBalancerId: pulumi.String("string"),
	ServerGroupId:  pulumi.String("string"),
	Protocol:       pulumi.String("string"),
	Port:           pulumi.Int(0),
	Enabled:        pulumi.Bool(false),
	Healths: clb.NlbListenerHealthArray{
		&clb.NlbListenerHealthArgs{
			InstanceId:  pulumi.String("string"),
			Ip:          pulumi.String("string"),
			Port:        pulumi.Int(0),
			ServerId:    pulumi.String("string"),
			ServerType:  pulumi.String("string"),
			Status:      pulumi.String("string"),
			UpdatedTime: pulumi.String("string"),
			ZoneId:      pulumi.String("string"),
		},
	},
	ListenerName:      pulumi.String("string"),
	EndPort:           pulumi.Int(0),
	CertificateId:     pulumi.String("string"),
	Description:       pulumi.String("string"),
	SecurityPolicyId:  pulumi.String("string"),
	ConnectionTimeout: pulumi.Int(0),
	StartPort:         pulumi.Int(0),
	Tags: clb.NlbListenerTagArray{
		&clb.NlbListenerTagArgs{
			Key:   pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
})

    var nlbListenerResource = new NlbListener("nlbListenerResource", NlbListenerArgs.builder()
    .loadBalancerId("string")
    .serverGroupId("string")
    .protocol("string")
    .port(0)
    .enabled(false)
    .healths(NlbListenerHealthArgs.builder()
        .instanceId("string")
        .ip("string")
        .port(0)
        .serverId("string")
        .serverType("string")
        .status("string")
        .updatedTime("string")
        .zoneId("string")
        .build())
    .listenerName("string")
    .endPort(0)
    .certificateId("string")
    .description("string")
    .securityPolicyId("string")
    .connectionTimeout(0)
    .startPort(0)
    .tags(NlbListenerTagArgs.builder()
        .key("string")
        .value("string")
        .build())
    .build());

    nlb_listener_resource = volcenginecc.clb.NlbListener("nlbListenerResource",
    load_balancer_id="string",
    server_group_id="string",
    protocol="string",
    port=0,
    enabled=False,
    healths=[{
        "instance_id": "string",
        "ip": "string",
        "port": 0,
        "server_id": "string",
        "server_type": "string",
        "status": "string",
        "updated_time": "string",
        "zone_id": "string",
    }],
    listener_name="string",
    end_port=0,
    certificate_id="string",
    description="string",
    security_policy_id="string",
    connection_timeout=0,
    start_port=0,
    tags=[{
        "key": "string",
        "value": "string",
    }])

    const nlbListenerResource = new volcenginecc.clb.NlbListener("nlbListenerResource", {
    loadBalancerId: "string",
    serverGroupId: "string",
    protocol: "string",
    port: 0,
    enabled: false,
    healths: [{
        instanceId: "string",
        ip: "string",
        port: 0,
        serverId: "string",
        serverType: "string",
        status: "string",
        updatedTime: "string",
        zoneId: "string",
    }],
    listenerName: "string",
    endPort: 0,
    certificateId: "string",
    description: "string",
    securityPolicyId: "string",
    connectionTimeout: 0,
    startPort: 0,
    tags: [{
        key: "string",
        value: "string",
    }],
});

    type: volcenginecc:clb:NlbListener
properties:
    certificateId: string
    connectionTimeout: 0
    description: string
    enabled: false
    endPort: 0
    healths:
        - instanceId: string
          ip: string
          port: 0
          serverId: string
          serverType: string
          status: string
          updatedTime: string
          zoneId: string
    listenerName: string
    loadBalancerId: string
    port: 0
    protocol: string
    securityPolicyId: string
    serverGroupId: string
    startPort: 0
    tags:
        - key: string
          value: string

    NlbListener 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 NlbListener resource accepts the following input properties:

    LoadBalancerId string
    负载均衡实例ID。
    Port int
    监听器接收请求的端口，0表示启用全端口监听。
    Protocol string
    监听协议类型。
    ServerGroupId string
    监听器关联的服务器组ID。
    CertificateId string
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    ConnectionTimeout int
    监听器的连接超时时间（秒）。
    Description string
    监听器描述信息。
    Enabled bool
    是否启用监听器。true：开启；false：关闭。
    EndPort int
    全端口监听的结束端口，仅当Port为0时有效。
    Healths List<Volcengine.NlbListenerHealth>
    ListenerName string
    监听器名称。
    SecurityPolicyId string
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    StartPort int
    全端口监听的起始端口，仅当Port为0时有效。
    Tags List<Volcengine.NlbListenerTag>
    LoadBalancerId string
    负载均衡实例ID。
    Port int
    监听器接收请求的端口，0表示启用全端口监听。
    Protocol string
    监听协议类型。
    ServerGroupId string
    监听器关联的服务器组ID。
    CertificateId string
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    ConnectionTimeout int
    监听器的连接超时时间（秒）。
    Description string
    监听器描述信息。
    Enabled bool
    是否启用监听器。true：开启；false：关闭。
    EndPort int
    全端口监听的结束端口，仅当Port为0时有效。
    Healths []NlbListenerHealthArgs
    ListenerName string
    监听器名称。
    SecurityPolicyId string
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    StartPort int
    全端口监听的起始端口，仅当Port为0时有效。
    Tags []NlbListenerTagArgs
    loadBalancerId String
    负载均衡实例ID。
    port Integer
    监听器接收请求的端口，0表示启用全端口监听。
    protocol String
    监听协议类型。
    serverGroupId String
    监听器关联的服务器组ID。
    certificateId String
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    connectionTimeout Integer
    监听器的连接超时时间（秒）。
    description String
    监听器描述信息。
    enabled Boolean
    是否启用监听器。true：开启；false：关闭。
    endPort Integer
    全端口监听的结束端口，仅当Port为0时有效。
    healths List<NlbListenerHealth>
    listenerName String
    监听器名称。
    securityPolicyId String
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    startPort Integer
    全端口监听的起始端口，仅当Port为0时有效。
    tags List<NlbListenerTag>
    loadBalancerId string
    负载均衡实例ID。
    port number
    监听器接收请求的端口，0表示启用全端口监听。
    protocol string
    监听协议类型。
    serverGroupId string
    监听器关联的服务器组ID。
    certificateId string
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    connectionTimeout number
    监听器的连接超时时间（秒）。
    description string
    监听器描述信息。
    enabled boolean
    是否启用监听器。true：开启；false：关闭。
    endPort number
    全端口监听的结束端口，仅当Port为0时有效。
    healths NlbListenerHealth[]
    listenerName string
    监听器名称。
    securityPolicyId string
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    startPort number
    全端口监听的起始端口，仅当Port为0时有效。
    tags NlbListenerTag[]
    load_balancer_id str
    负载均衡实例ID。
    port int
    监听器接收请求的端口，0表示启用全端口监听。
    protocol str
    监听协议类型。
    server_group_id str
    监听器关联的服务器组ID。
    certificate_id str
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    connection_timeout int
    监听器的连接超时时间（秒）。
    description str
    监听器描述信息。
    enabled bool
    是否启用监听器。true：开启；false：关闭。
    end_port int
    全端口监听的结束端口，仅当Port为0时有效。
    healths Sequence[NlbListenerHealthArgs]
    listener_name str
    监听器名称。
    security_policy_id str
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    start_port int
    全端口监听的起始端口，仅当Port为0时有效。
    tags Sequence[NlbListenerTagArgs]
    loadBalancerId String
    负载均衡实例ID。
    port Number
    监听器接收请求的端口，0表示启用全端口监听。
    protocol String
    监听协议类型。
    serverGroupId String
    监听器关联的服务器组ID。
    certificateId String
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    connectionTimeout Number
    监听器的连接超时时间（秒）。
    description String
    监听器描述信息。
    enabled Boolean
    是否启用监听器。true：开启；false：关闭。
    endPort Number
    全端口监听的结束端口，仅当Port为0时有效。
    healths List<Property Map>
    listenerName String
    监听器名称。
    securityPolicyId String
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    startPort Number
    全端口监听的起始端口，仅当Port为0时有效。
    tags List<Property Map>

    Outputs

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

    CreatedTime string
    监听器的创建时间。
    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerId string
    监听器唯一标识。
    Status string
    监听器的状态。
    UpdatedTime string
    监听器最近操作时间。
    CreatedTime string
    监听器的创建时间。
    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerId string
    监听器唯一标识。
    Status string
    监听器的状态。
    UpdatedTime string
    监听器最近操作时间。
    createdTime String
    监听器的创建时间。
    id String
    The provider-assigned unique ID for this managed resource.
    listenerId String
    监听器唯一标识。
    status String
    监听器的状态。
    updatedTime String
    监听器最近操作时间。
    createdTime string
    监听器的创建时间。
    id string
    The provider-assigned unique ID for this managed resource.
    listenerId string
    监听器唯一标识。
    status string
    监听器的状态。
    updatedTime string
    监听器最近操作时间。
    created_time str
    监听器的创建时间。
    id str
    The provider-assigned unique ID for this managed resource.
    listener_id str
    监听器唯一标识。
    status str
    监听器的状态。
    updated_time str
    监听器最近操作时间。
    createdTime String
    监听器的创建时间。
    id String
    The provider-assigned unique ID for this managed resource.
    listenerId String
    监听器唯一标识。
    status String
    监听器的状态。
    updatedTime String
    监听器最近操作时间。

    Look up Existing NlbListener Resource

    Get an existing NlbListener 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?: NlbListenerState, opts?: CustomResourceOptions): NlbListener
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        certificate_id: Optional[str] = None,
        connection_timeout: Optional[int] = None,
        created_time: Optional[str] = None,
        description: Optional[str] = None,
        enabled: Optional[bool] = None,
        end_port: Optional[int] = None,
        healths: Optional[Sequence[NlbListenerHealthArgs]] = None,
        listener_id: Optional[str] = None,
        listener_name: Optional[str] = None,
        load_balancer_id: Optional[str] = None,
        port: Optional[int] = None,
        protocol: Optional[str] = None,
        security_policy_id: Optional[str] = None,
        server_group_id: Optional[str] = None,
        start_port: Optional[int] = None,
        status: Optional[str] = None,
        tags: Optional[Sequence[NlbListenerTagArgs]] = None,
        updated_time: Optional[str] = None) -> NlbListener
    func GetNlbListener(ctx *Context, name string, id IDInput, state *NlbListenerState, opts ...ResourceOption) (*NlbListener, error)
    public static NlbListener Get(string name, Input<string> id, NlbListenerState? state, CustomResourceOptions? opts = null)
    public static NlbListener get(String name, Output<String> id, NlbListenerState state, CustomResourceOptions options)
    resources:  _:    type: volcenginecc:clb:NlbListener    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:
    CertificateId string
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    ConnectionTimeout int
    监听器的连接超时时间（秒）。
    CreatedTime string
    监听器的创建时间。
    Description string
    监听器描述信息。
    Enabled bool
    是否启用监听器。true：开启；false：关闭。
    EndPort int
    全端口监听的结束端口，仅当Port为0时有效。
    Healths List<Volcengine.NlbListenerHealth>
    ListenerId string
    监听器唯一标识。
    ListenerName string
    监听器名称。
    LoadBalancerId string
    负载均衡实例ID。
    Port int
    监听器接收请求的端口，0表示启用全端口监听。
    Protocol string
    监听协议类型。
    SecurityPolicyId string
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    ServerGroupId string
    监听器关联的服务器组ID。
    StartPort int
    全端口监听的起始端口，仅当Port为0时有效。
    Status string
    监听器的状态。
    Tags List<Volcengine.NlbListenerTag>
    UpdatedTime string
    监听器最近操作时间。
    CertificateId string
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    ConnectionTimeout int
    监听器的连接超时时间（秒）。
    CreatedTime string
    监听器的创建时间。
    Description string
    监听器描述信息。
    Enabled bool
    是否启用监听器。true：开启；false：关闭。
    EndPort int
    全端口监听的结束端口，仅当Port为0时有效。
    Healths []NlbListenerHealthArgs
    ListenerId string
    监听器唯一标识。
    ListenerName string
    监听器名称。
    LoadBalancerId string
    负载均衡实例ID。
    Port int
    监听器接收请求的端口，0表示启用全端口监听。
    Protocol string
    监听协议类型。
    SecurityPolicyId string
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    ServerGroupId string
    监听器关联的服务器组ID。
    StartPort int
    全端口监听的起始端口，仅当Port为0时有效。
    Status string
    监听器的状态。
    Tags []NlbListenerTagArgs
    UpdatedTime string
    监听器最近操作时间。
    certificateId String
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    connectionTimeout Integer
    监听器的连接超时时间（秒）。
    createdTime String
    监听器的创建时间。
    description String
    监听器描述信息。
    enabled Boolean
    是否启用监听器。true：开启；false：关闭。
    endPort Integer
    全端口监听的结束端口，仅当Port为0时有效。
    healths List<NlbListenerHealth>
    listenerId String
    监听器唯一标识。
    listenerName String
    监听器名称。
    loadBalancerId String
    负载均衡实例ID。
    port Integer
    监听器接收请求的端口，0表示启用全端口监听。
    protocol String
    监听协议类型。
    securityPolicyId String
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    serverGroupId String
    监听器关联的服务器组ID。
    startPort Integer
    全端口监听的起始端口，仅当Port为0时有效。
    status String
    监听器的状态。
    tags List<NlbListenerTag>
    updatedTime String
    监听器最近操作时间。
    certificateId string
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    connectionTimeout number
    监听器的连接超时时间（秒）。
    createdTime string
    监听器的创建时间。
    description string
    监听器描述信息。
    enabled boolean
    是否启用监听器。true：开启；false：关闭。
    endPort number
    全端口监听的结束端口，仅当Port为0时有效。
    healths NlbListenerHealth[]
    listenerId string
    监听器唯一标识。
    listenerName string
    监听器名称。
    loadBalancerId string
    负载均衡实例ID。
    port number
    监听器接收请求的端口，0表示启用全端口监听。
    protocol string
    监听协议类型。
    securityPolicyId string
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    serverGroupId string
    监听器关联的服务器组ID。
    startPort number
    全端口监听的起始端口，仅当Port为0时有效。
    status string
    监听器的状态。
    tags NlbListenerTag[]
    updatedTime string
    监听器最近操作时间。
    certificate_id str
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    connection_timeout int
    监听器的连接超时时间（秒）。
    created_time str
    监听器的创建时间。
    description str
    监听器描述信息。
    enabled bool
    是否启用监听器。true：开启；false：关闭。
    end_port int
    全端口监听的结束端口，仅当Port为0时有效。
    healths Sequence[NlbListenerHealthArgs]
    listener_id str
    监听器唯一标识。
    listener_name str
    监听器名称。
    load_balancer_id str
    负载均衡实例ID。
    port int
    监听器接收请求的端口，0表示启用全端口监听。
    protocol str
    监听协议类型。
    security_policy_id str
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    server_group_id str
    监听器关联的服务器组ID。
    start_port int
    全端口监听的起始端口，仅当Port为0时有效。
    status str
    监听器的状态。
    tags Sequence[NlbListenerTagArgs]
    updated_time str
    监听器最近操作时间。
    certificateId String
    TLS监听器服务器证书的ID，仅支持传入火山引擎证书中心 SSL 证书。。
    connectionTimeout Number
    监听器的连接超时时间（秒）。
    createdTime String
    监听器的创建时间。
    description String
    监听器描述信息。
    enabled Boolean
    是否启用监听器。true：开启；false：关闭。
    endPort Number
    全端口监听的结束端口，仅当Port为0时有效。
    healths List<Property Map>
    listenerId String
    监听器唯一标识。
    listenerName String
    监听器名称。
    loadBalancerId String
    负载均衡实例ID。
    port Number
    监听器接收请求的端口，0表示启用全端口监听。
    protocol String
    监听协议类型。
    securityPolicyId String
    TLS 安全策略ID，支持系统安全策略和自定义安全策略。系统安全策略取值：.tlscipherpolicy10.tlscipherpolicy11.tlscipherpolicy12.tlscipherpolicy12strict.tlscipherpolicy12strictwith1_3.自定义安全策略：输入自定义安全策略 ID。当Protocol为TLS 时，该参数为必填。。
    serverGroupId String
    监听器关联的服务器组ID。
    startPort Number
    全端口监听的起始端口，仅当Port为0时有效。
    status String
    监听器的状态。
    tags List<Property Map>
    updatedTime String
    监听器最近操作时间。

    Supporting Types

    NlbListenerHealth, NlbListenerHealthArgs

    InstanceId string
    后端服务器的实例 ID或IP地址。
    Ip string
    后端服务器的IP地址。
    Port int
    后端服务器提供服务的端口。
    ServerId string
    后端服务器ID。
    ServerType string
    后端服务器的类型。ecs：云服务器实例（即主网卡）；eni：辅助网卡；ip：IP地址
    Status string
    后端服务器的健康状态。Up：正常；Down：异常；Unused：未被使用（NLB实例已关闭跨可用区转发，且没有来自该后端服务器可用区的访问流量）。
    UpdatedTime string
    健康状态最后更新时间。
    ZoneId string
    后端服务器接收访问流量的可用区ID。
    InstanceId string
    后端服务器的实例 ID或IP地址。
    Ip string
    后端服务器的IP地址。
    Port int
    后端服务器提供服务的端口。
    ServerId string
    后端服务器ID。
    ServerType string
    后端服务器的类型。ecs：云服务器实例（即主网卡）；eni：辅助网卡；ip：IP地址
    Status string
    后端服务器的健康状态。Up：正常；Down：异常；Unused：未被使用（NLB实例已关闭跨可用区转发，且没有来自该后端服务器可用区的访问流量）。
    UpdatedTime string
    健康状态最后更新时间。
    ZoneId string
    后端服务器接收访问流量的可用区ID。
    instanceId String
    后端服务器的实例 ID或IP地址。
    ip String
    后端服务器的IP地址。
    port Integer
    后端服务器提供服务的端口。
    serverId String
    后端服务器ID。
    serverType String
    后端服务器的类型。ecs：云服务器实例（即主网卡）；eni：辅助网卡；ip：IP地址
    status String
    后端服务器的健康状态。Up：正常；Down：异常；Unused：未被使用（NLB实例已关闭跨可用区转发，且没有来自该后端服务器可用区的访问流量）。
    updatedTime String
    健康状态最后更新时间。
    zoneId String
    后端服务器接收访问流量的可用区ID。
    instanceId string
    后端服务器的实例 ID或IP地址。
    ip string
    后端服务器的IP地址。
    port number
    后端服务器提供服务的端口。
    serverId string
    后端服务器ID。
    serverType string
    后端服务器的类型。ecs：云服务器实例（即主网卡）；eni：辅助网卡；ip：IP地址
    status string
    后端服务器的健康状态。Up：正常；Down：异常；Unused：未被使用（NLB实例已关闭跨可用区转发，且没有来自该后端服务器可用区的访问流量）。
    updatedTime string
    健康状态最后更新时间。
    zoneId string
    后端服务器接收访问流量的可用区ID。
    instance_id str
    后端服务器的实例 ID或IP地址。
    ip str
    后端服务器的IP地址。
    port int
    后端服务器提供服务的端口。
    server_id str
    后端服务器ID。
    server_type str
    后端服务器的类型。ecs：云服务器实例（即主网卡）；eni：辅助网卡；ip：IP地址
    status str
    后端服务器的健康状态。Up：正常；Down：异常；Unused：未被使用（NLB实例已关闭跨可用区转发，且没有来自该后端服务器可用区的访问流量）。
    updated_time str
    健康状态最后更新时间。
    zone_id str
    后端服务器接收访问流量的可用区ID。
    instanceId String
    后端服务器的实例 ID或IP地址。
    ip String
    后端服务器的IP地址。
    port Number
    后端服务器提供服务的端口。
    serverId String
    后端服务器ID。
    serverType String
    后端服务器的类型。ecs：云服务器实例（即主网卡）；eni：辅助网卡；ip：IP地址
    status String
    后端服务器的健康状态。Up：正常；Down：异常；Unused：未被使用（NLB实例已关闭跨可用区转发，且没有来自该后端服务器可用区的访问流量）。
    updatedTime String
    健康状态最后更新时间。
    zoneId String
    后端服务器接收访问流量的可用区ID。

    NlbListenerTag, NlbListenerTagArgs

    Key string
    标签键。
    Value string
    标签值。
    Key string
    标签键。
    Value string
    标签值。
    key String
    标签键。
    value String
    标签值。
    key string
    标签键。
    value string
    标签值。
    key str
    标签键。
    value str
    标签值。
    key String
    标签键。
    value String
    标签值。

    Import

    $ pulumi import volcenginecc:clb/nlbListener:NlbListener example "listener_id"

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

    Package Details

    Repository
    volcenginecc volcengine/pulumi-volcenginecc
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the volcenginecc Terraform Provider.
    volcenginecc logo
    volcenginecc v0.0.2 published on Saturday, Oct 11, 2025 by Volcengine
    volcengine/pulumi-volcenginecc
      Meet Neo: Your AI Platform Teammate