1. Packages
  2. Volcenginecc Provider
  3. API Docs
  4. alb
  5. Listener
volcenginecc v0.0.4 published on Monday, Nov 3, 2025 by Volcengine

volcenginecc.alb.Listener

Start a Neo task
Explain and create a volcenginecc.alb.Listener resource
volcenginecc logo
volcenginecc v0.0.4 published on Monday, Nov 3, 2025 by Volcengine

    每个 ALB 实例至少要有一个监听器才能正常工作。监听器接收客户端请求,并根据您配置的转发规则和负载均衡算法将请求分发到后端服务器上。您可以在一个 ALB 实例下创建多个监听器,并为监听器配置不同的监听协议,以处理使用不同协议的客户端请求。

    Example Usage

    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    resources:
      aLBListenerDemo:
        type: volcenginecc:alb:Listener
        name: ALBListenerDemo
        properties:
          loadBalancerId: alb-bdazuxj87hts8dv40noxxxxx
          listenerName: ALBListenerDemo
          protocol: HTTPS
          port: 80
          enabled: on
          serverGroupId: rsp-1pff7rhpf5e68845wfah2xxxx
          aclStatus: on
          aclType: black
          aclIds:
            - acl-xp8avgtjnmrk54ov5fyoxxxx
          customizedCfgId: ccfg-xoblsk63beo054ov5el5xxxx
          description: ALBListenerDemo description
          tags:
            - key: env
              value: test
          certificateSource: cert_center
          certCenterCertificateId: cert-a126f867a19141618ff316a52a50xxxx
          caCertificateSource: pca_root
          pcaRootCaCertificateId: pca_root_xxxxxx
          enableHttp2: on
          enableQuic: off
          domainExtensions:
            - cert_center_certificate_id: cert-7718b7e7afa94e4db38ec9092cxxxxxx
              certificate_source: cert_center
              domain: ""
    

    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,
                 enable_http2: Optional[str] = None,
                 listener_name: Optional[str] = None,
                 cert_center_certificate_id: Optional[str] = None,
                 certificate_id: Optional[str] = None,
                 certificate_source: Optional[str] = None,
                 customized_cfg_id: Optional[str] = None,
                 description: Optional[str] = None,
                 domain_extensions: Optional[Sequence[ListenerDomainExtensionArgs]] = None,
                 access_log_record_customized_headers_enabled: Optional[str] = None,
                 enable_quic: Optional[str] = None,
                 enabled: Optional[str] = None,
                 ca_certificate_source: Optional[str] = None,
                 ca_certificate_id: Optional[str] = None,
                 pca_leaf_certificate_id: Optional[str] = None,
                 pca_root_ca_certificate_id: Optional[str] = None,
                 pca_sub_ca_certificate_id: Optional[str] = None,
                 acl_type: Optional[str] = None,
                 acl_status: Optional[str] = None,
                 acl_ids: Optional[Sequence[str]] = None,
                 server_groups: Optional[Sequence[ListenerServerGroupArgs]] = 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: volcenginecc:alb: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 listenerResource = new Volcenginecc.Alb.Listener("listenerResource", new()
    {
        LoadBalancerId = "string",
        ServerGroupId = "string",
        Protocol = "string",
        Port = 0,
        EnableHttp2 = "string",
        ListenerName = "string",
        CertCenterCertificateId = "string",
        CertificateId = "string",
        CertificateSource = "string",
        CustomizedCfgId = "string",
        Description = "string",
        DomainExtensions = new[]
        {
            new Volcenginecc.Alb.Inputs.ListenerDomainExtensionArgs
            {
                CertCenterCertificateId = "string",
                CertificateId = "string",
                CertificateSource = "string",
                Domain = "string",
                PcaLeafCertificateId = "string",
                San = "string",
            },
        },
        AccessLogRecordCustomizedHeadersEnabled = "string",
        EnableQuic = "string",
        Enabled = "string",
        CaCertificateSource = "string",
        CaCertificateId = "string",
        PcaLeafCertificateId = "string",
        PcaRootCaCertificateId = "string",
        PcaSubCaCertificateId = "string",
        AclType = "string",
        AclStatus = "string",
        AclIds = new[]
        {
            "string",
        },
        ServerGroups = new[]
        {
            new Volcenginecc.Alb.Inputs.ListenerServerGroupArgs
            {
                ServerGroupId = "string",
                ServerGroupName = "string",
            },
        },
        Tags = new[]
        {
            new Volcenginecc.Alb.Inputs.ListenerTagArgs
            {
                Key = "string",
                Value = "string",
            },
        },
    });
    
    example, err := alb.NewListener(ctx, "listenerResource", &alb.ListenerArgs{
    	LoadBalancerId:          pulumi.String("string"),
    	ServerGroupId:           pulumi.String("string"),
    	Protocol:                pulumi.String("string"),
    	Port:                    pulumi.Int(0),
    	EnableHttp2:             pulumi.String("string"),
    	ListenerName:            pulumi.String("string"),
    	CertCenterCertificateId: pulumi.String("string"),
    	CertificateId:           pulumi.String("string"),
    	CertificateSource:       pulumi.String("string"),
    	CustomizedCfgId:         pulumi.String("string"),
    	Description:             pulumi.String("string"),
    	DomainExtensions: alb.ListenerDomainExtensionArray{
    		&alb.ListenerDomainExtensionArgs{
    			CertCenterCertificateId: pulumi.String("string"),
    			CertificateId:           pulumi.String("string"),
    			CertificateSource:       pulumi.String("string"),
    			Domain:                  pulumi.String("string"),
    			PcaLeafCertificateId:    pulumi.String("string"),
    			San:                     pulumi.String("string"),
    		},
    	},
    	AccessLogRecordCustomizedHeadersEnabled: pulumi.String("string"),
    	EnableQuic:                              pulumi.String("string"),
    	Enabled:                                 pulumi.String("string"),
    	CaCertificateSource:                     pulumi.String("string"),
    	CaCertificateId:                         pulumi.String("string"),
    	PcaLeafCertificateId:                    pulumi.String("string"),
    	PcaRootCaCertificateId:                  pulumi.String("string"),
    	PcaSubCaCertificateId:                   pulumi.String("string"),
    	AclType:                                 pulumi.String("string"),
    	AclStatus:                               pulumi.String("string"),
    	AclIds: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	ServerGroups: alb.ListenerServerGroupArray{
    		&alb.ListenerServerGroupArgs{
    			ServerGroupId:   pulumi.String("string"),
    			ServerGroupName: pulumi.String("string"),
    		},
    	},
    	Tags: alb.ListenerTagArray{
    		&alb.ListenerTagArgs{
    			Key:   pulumi.String("string"),
    			Value: pulumi.String("string"),
    		},
    	},
    })
    
    var listenerResource = new com.volcengine.volcenginecc.alb.Listener("listenerResource", com.volcengine.volcenginecc.alb.ListenerArgs.builder()
        .loadBalancerId("string")
        .serverGroupId("string")
        .protocol("string")
        .port(0)
        .enableHttp2("string")
        .listenerName("string")
        .certCenterCertificateId("string")
        .certificateId("string")
        .certificateSource("string")
        .customizedCfgId("string")
        .description("string")
        .domainExtensions(ListenerDomainExtensionArgs.builder()
            .certCenterCertificateId("string")
            .certificateId("string")
            .certificateSource("string")
            .domain("string")
            .pcaLeafCertificateId("string")
            .san("string")
            .build())
        .accessLogRecordCustomizedHeadersEnabled("string")
        .enableQuic("string")
        .enabled("string")
        .caCertificateSource("string")
        .caCertificateId("string")
        .pcaLeafCertificateId("string")
        .pcaRootCaCertificateId("string")
        .pcaSubCaCertificateId("string")
        .aclType("string")
        .aclStatus("string")
        .aclIds("string")
        .serverGroups(ListenerServerGroupArgs.builder()
            .serverGroupId("string")
            .serverGroupName("string")
            .build())
        .tags(ListenerTagArgs.builder()
            .key("string")
            .value("string")
            .build())
        .build());
    
    listener_resource = volcenginecc.alb.Listener("listenerResource",
        load_balancer_id="string",
        server_group_id="string",
        protocol="string",
        port=0,
        enable_http2="string",
        listener_name="string",
        cert_center_certificate_id="string",
        certificate_id="string",
        certificate_source="string",
        customized_cfg_id="string",
        description="string",
        domain_extensions=[{
            "cert_center_certificate_id": "string",
            "certificate_id": "string",
            "certificate_source": "string",
            "domain": "string",
            "pca_leaf_certificate_id": "string",
            "san": "string",
        }],
        access_log_record_customized_headers_enabled="string",
        enable_quic="string",
        enabled="string",
        ca_certificate_source="string",
        ca_certificate_id="string",
        pca_leaf_certificate_id="string",
        pca_root_ca_certificate_id="string",
        pca_sub_ca_certificate_id="string",
        acl_type="string",
        acl_status="string",
        acl_ids=["string"],
        server_groups=[{
            "server_group_id": "string",
            "server_group_name": "string",
        }],
        tags=[{
            "key": "string",
            "value": "string",
        }])
    
    const listenerResource = new volcenginecc.alb.Listener("listenerResource", {
        loadBalancerId: "string",
        serverGroupId: "string",
        protocol: "string",
        port: 0,
        enableHttp2: "string",
        listenerName: "string",
        certCenterCertificateId: "string",
        certificateId: "string",
        certificateSource: "string",
        customizedCfgId: "string",
        description: "string",
        domainExtensions: [{
            certCenterCertificateId: "string",
            certificateId: "string",
            certificateSource: "string",
            domain: "string",
            pcaLeafCertificateId: "string",
            san: "string",
        }],
        accessLogRecordCustomizedHeadersEnabled: "string",
        enableQuic: "string",
        enabled: "string",
        caCertificateSource: "string",
        caCertificateId: "string",
        pcaLeafCertificateId: "string",
        pcaRootCaCertificateId: "string",
        pcaSubCaCertificateId: "string",
        aclType: "string",
        aclStatus: "string",
        aclIds: ["string"],
        serverGroups: [{
            serverGroupId: "string",
            serverGroupName: "string",
        }],
        tags: [{
            key: "string",
            value: "string",
        }],
    });
    
    type: volcenginecc:alb:Listener
    properties:
        accessLogRecordCustomizedHeadersEnabled: string
        aclIds:
            - string
        aclStatus: string
        aclType: string
        caCertificateId: string
        caCertificateSource: string
        certCenterCertificateId: string
        certificateId: string
        certificateSource: string
        customizedCfgId: string
        description: string
        domainExtensions:
            - certCenterCertificateId: string
              certificateId: string
              certificateSource: string
              domain: string
              pcaLeafCertificateId: string
              san: string
        enableHttp2: string
        enableQuic: string
        enabled: string
        listenerName: string
        loadBalancerId: string
        pcaLeafCertificateId: string
        pcaRootCaCertificateId: string
        pcaSubCaCertificateId: string
        port: 0
        protocol: string
        serverGroupId: string
        serverGroups:
            - serverGroupId: string
              serverGroupName: string
        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
    监听器所属的负载均衡实例 ID。
    Port int
    监听器的监听端口,取值:1 - 65535 。
    Protocol string
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    ServerGroupId string
    监听器的默认服务器组。
    AccessLogRecordCustomizedHeadersEnabled string
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    AclIds List<string>
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    AclStatus string
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    AclType string
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    CaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    CaCertificateSource string
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    CertCenterCertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    CertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    CertificateSource string
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    CustomizedCfgId string
    个性化配置ID,未绑定时值为空字符串。
    Description string
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    DomainExtensions List<Volcengine.ListenerDomainExtension>
    EnableHttp2 string
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    EnableQuic string
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    Enabled string
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    ListenerName string
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    PcaLeafCertificateId string
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    PcaRootCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    PcaSubCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    ServerGroups List<Volcengine.ListenerServerGroup>
    Tags List<Volcengine.ListenerTag>
    LoadBalancerId string
    监听器所属的负载均衡实例 ID。
    Port int
    监听器的监听端口,取值:1 - 65535 。
    Protocol string
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    ServerGroupId string
    监听器的默认服务器组。
    AccessLogRecordCustomizedHeadersEnabled string
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    AclIds []string
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    AclStatus string
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    AclType string
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    CaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    CaCertificateSource string
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    CertCenterCertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    CertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    CertificateSource string
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    CustomizedCfgId string
    个性化配置ID,未绑定时值为空字符串。
    Description string
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    DomainExtensions []ListenerDomainExtensionArgs
    EnableHttp2 string
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    EnableQuic string
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    Enabled string
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    ListenerName string
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    PcaLeafCertificateId string
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    PcaRootCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    PcaSubCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    ServerGroups []ListenerServerGroupArgs
    Tags []ListenerTagArgs
    loadBalancerId String
    监听器所属的负载均衡实例 ID。
    port Integer
    监听器的监听端口,取值:1 - 65535 。
    protocol String
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    serverGroupId String
    监听器的默认服务器组。
    accessLogRecordCustomizedHeadersEnabled String
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    aclIds List<String>
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    aclStatus String
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    aclType String
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    caCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    caCertificateSource String
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    certCenterCertificateId String
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    certificateId String
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    certificateSource String
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    customizedCfgId String
    个性化配置ID,未绑定时值为空字符串。
    description String
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    domainExtensions List<ListenerDomainExtension>
    enableHttp2 String
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    enableQuic String
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    enabled String
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    listenerName String
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    pcaLeafCertificateId String
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    pcaRootCaCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    pcaSubCaCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    serverGroups List<ListenerServerGroup>
    tags List<ListenerTag>
    loadBalancerId string
    监听器所属的负载均衡实例 ID。
    port number
    监听器的监听端口,取值:1 - 65535 。
    protocol string
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    serverGroupId string
    监听器的默认服务器组。
    accessLogRecordCustomizedHeadersEnabled string
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    aclIds string[]
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    aclStatus string
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    aclType string
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    caCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    caCertificateSource string
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    certCenterCertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    certificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    certificateSource string
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    customizedCfgId string
    个性化配置ID,未绑定时值为空字符串。
    description string
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    domainExtensions ListenerDomainExtension[]
    enableHttp2 string
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    enableQuic string
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    enabled string
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    listenerName string
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    pcaLeafCertificateId string
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    pcaRootCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    pcaSubCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    serverGroups ListenerServerGroup[]
    tags ListenerTag[]
    load_balancer_id str
    监听器所属的负载均衡实例 ID。
    port int
    监听器的监听端口,取值:1 - 65535 。
    protocol str
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    server_group_id str
    监听器的默认服务器组。
    access_log_record_customized_headers_enabled str
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    acl_ids Sequence[str]
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    acl_status str
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    acl_type str
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    ca_certificate_id str
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    ca_certificate_source str
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    cert_center_certificate_id str
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    certificate_id str
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    certificate_source str
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    customized_cfg_id str
    个性化配置ID,未绑定时值为空字符串。
    description str
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    domain_extensions Sequence[ListenerDomainExtensionArgs]
    enable_http2 str
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    enable_quic str
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    enabled str
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    listener_name str
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    pca_leaf_certificate_id str
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    pca_root_ca_certificate_id str
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    pca_sub_ca_certificate_id str
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    server_groups Sequence[ListenerServerGroupArgs]
    tags Sequence[ListenerTagArgs]
    loadBalancerId String
    监听器所属的负载均衡实例 ID。
    port Number
    监听器的监听端口,取值:1 - 65535 。
    protocol String
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    serverGroupId String
    监听器的默认服务器组。
    accessLogRecordCustomizedHeadersEnabled String
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    aclIds List<String>
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    aclStatus String
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    aclType String
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    caCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    caCertificateSource String
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    certCenterCertificateId String
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    certificateId String
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    certificateSource String
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    customizedCfgId String
    个性化配置ID,未绑定时值为空字符串。
    description String
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    domainExtensions List<Property Map>
    enableHttp2 String
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    enableQuic String
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    enabled String
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    listenerName String
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    pcaLeafCertificateId String
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    pcaRootCaCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    pcaSubCaCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    serverGroups List<Property Map>
    tags List<Property Map>

    Outputs

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

    CreatedTime string
    监听器的创建时间。
    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerId string
    监听器 ID。
    ProjectName string
    监听器所属项目名称。
    Status string
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    UpdatedTime string
    监听器最近一次的操作时间。
    CreatedTime string
    监听器的创建时间。
    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerId string
    监听器 ID。
    ProjectName string
    监听器所属项目名称。
    Status string
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    UpdatedTime string
    监听器最近一次的操作时间。
    createdTime String
    监听器的创建时间。
    id String
    The provider-assigned unique ID for this managed resource.
    listenerId String
    监听器 ID。
    projectName String
    监听器所属项目名称。
    status String
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    updatedTime String
    监听器最近一次的操作时间。
    createdTime string
    监听器的创建时间。
    id string
    The provider-assigned unique ID for this managed resource.
    listenerId string
    监听器 ID。
    projectName string
    监听器所属项目名称。
    status string
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    updatedTime string
    监听器最近一次的操作时间。
    created_time str
    监听器的创建时间。
    id str
    The provider-assigned unique ID for this managed resource.
    listener_id str
    监听器 ID。
    project_name str
    监听器所属项目名称。
    status str
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    updated_time str
    监听器最近一次的操作时间。
    createdTime String
    监听器的创建时间。
    id String
    The provider-assigned unique ID for this managed resource.
    listenerId String
    监听器 ID。
    projectName String
    监听器所属项目名称。
    status String
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    updatedTime String
    监听器最近一次的操作时间。

    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,
            access_log_record_customized_headers_enabled: Optional[str] = None,
            acl_ids: Optional[Sequence[str]] = None,
            acl_status: Optional[str] = None,
            acl_type: Optional[str] = None,
            ca_certificate_id: Optional[str] = None,
            ca_certificate_source: Optional[str] = None,
            cert_center_certificate_id: Optional[str] = None,
            certificate_id: Optional[str] = None,
            certificate_source: Optional[str] = None,
            created_time: Optional[str] = None,
            customized_cfg_id: Optional[str] = None,
            description: Optional[str] = None,
            domain_extensions: Optional[Sequence[ListenerDomainExtensionArgs]] = None,
            enable_http2: Optional[str] = None,
            enable_quic: Optional[str] = None,
            enabled: Optional[str] = None,
            listener_id: Optional[str] = None,
            listener_name: Optional[str] = None,
            load_balancer_id: Optional[str] = None,
            pca_leaf_certificate_id: Optional[str] = None,
            pca_root_ca_certificate_id: Optional[str] = None,
            pca_sub_ca_certificate_id: Optional[str] = None,
            port: Optional[int] = None,
            project_name: Optional[str] = None,
            protocol: Optional[str] = None,
            server_group_id: Optional[str] = None,
            server_groups: Optional[Sequence[ListenerServerGroupArgs]] = None,
            status: Optional[str] = None,
            tags: Optional[Sequence[ListenerTagArgs]] = None,
            updated_time: Optional[str] = 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: volcenginecc:alb: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:
    AccessLogRecordCustomizedHeadersEnabled string
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    AclIds List<string>
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    AclStatus string
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    AclType string
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    CaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    CaCertificateSource string
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    CertCenterCertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    CertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    CertificateSource string
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    CreatedTime string
    监听器的创建时间。
    CustomizedCfgId string
    个性化配置ID,未绑定时值为空字符串。
    Description string
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    DomainExtensions List<Volcengine.ListenerDomainExtension>
    EnableHttp2 string
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    EnableQuic string
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    Enabled string
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    ListenerId string
    监听器 ID。
    ListenerName string
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    LoadBalancerId string
    监听器所属的负载均衡实例 ID。
    PcaLeafCertificateId string
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    PcaRootCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    PcaSubCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    Port int
    监听器的监听端口,取值:1 - 65535 。
    ProjectName string
    监听器所属项目名称。
    Protocol string
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    ServerGroupId string
    监听器的默认服务器组。
    ServerGroups List<Volcengine.ListenerServerGroup>
    Status string
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    Tags List<Volcengine.ListenerTag>
    UpdatedTime string
    监听器最近一次的操作时间。
    AccessLogRecordCustomizedHeadersEnabled string
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    AclIds []string
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    AclStatus string
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    AclType string
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    CaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    CaCertificateSource string
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    CertCenterCertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    CertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    CertificateSource string
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    CreatedTime string
    监听器的创建时间。
    CustomizedCfgId string
    个性化配置ID,未绑定时值为空字符串。
    Description string
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    DomainExtensions []ListenerDomainExtensionArgs
    EnableHttp2 string
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    EnableQuic string
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    Enabled string
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    ListenerId string
    监听器 ID。
    ListenerName string
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    LoadBalancerId string
    监听器所属的负载均衡实例 ID。
    PcaLeafCertificateId string
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    PcaRootCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    PcaSubCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    Port int
    监听器的监听端口,取值:1 - 65535 。
    ProjectName string
    监听器所属项目名称。
    Protocol string
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    ServerGroupId string
    监听器的默认服务器组。
    ServerGroups []ListenerServerGroupArgs
    Status string
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    Tags []ListenerTagArgs
    UpdatedTime string
    监听器最近一次的操作时间。
    accessLogRecordCustomizedHeadersEnabled String
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    aclIds List<String>
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    aclStatus String
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    aclType String
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    caCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    caCertificateSource String
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    certCenterCertificateId String
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    certificateId String
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    certificateSource String
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    createdTime String
    监听器的创建时间。
    customizedCfgId String
    个性化配置ID,未绑定时值为空字符串。
    description String
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    domainExtensions List<ListenerDomainExtension>
    enableHttp2 String
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    enableQuic String
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    enabled String
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    listenerId String
    监听器 ID。
    listenerName String
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    loadBalancerId String
    监听器所属的负载均衡实例 ID。
    pcaLeafCertificateId String
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    pcaRootCaCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    pcaSubCaCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    port Integer
    监听器的监听端口,取值:1 - 65535 。
    projectName String
    监听器所属项目名称。
    protocol String
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    serverGroupId String
    监听器的默认服务器组。
    serverGroups List<ListenerServerGroup>
    status String
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    tags List<ListenerTag>
    updatedTime String
    监听器最近一次的操作时间。
    accessLogRecordCustomizedHeadersEnabled string
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    aclIds string[]
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    aclStatus string
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    aclType string
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    caCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    caCertificateSource string
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    certCenterCertificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    certificateId string
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    certificateSource string
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    createdTime string
    监听器的创建时间。
    customizedCfgId string
    个性化配置ID,未绑定时值为空字符串。
    description string
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    domainExtensions ListenerDomainExtension[]
    enableHttp2 string
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    enableQuic string
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    enabled string
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    listenerId string
    监听器 ID。
    listenerName string
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    loadBalancerId string
    监听器所属的负载均衡实例 ID。
    pcaLeafCertificateId string
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    pcaRootCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    pcaSubCaCertificateId string
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    port number
    监听器的监听端口,取值:1 - 65535 。
    projectName string
    监听器所属项目名称。
    protocol string
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    serverGroupId string
    监听器的默认服务器组。
    serverGroups ListenerServerGroup[]
    status string
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    tags ListenerTag[]
    updatedTime string
    监听器最近一次的操作时间。
    access_log_record_customized_headers_enabled str
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    acl_ids Sequence[str]
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    acl_status str
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    acl_type str
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    ca_certificate_id str
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    ca_certificate_source str
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    cert_center_certificate_id str
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    certificate_id str
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    certificate_source str
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    created_time str
    监听器的创建时间。
    customized_cfg_id str
    个性化配置ID,未绑定时值为空字符串。
    description str
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    domain_extensions Sequence[ListenerDomainExtensionArgs]
    enable_http2 str
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    enable_quic str
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    enabled str
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    listener_id str
    监听器 ID。
    listener_name str
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    load_balancer_id str
    监听器所属的负载均衡实例 ID。
    pca_leaf_certificate_id str
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    pca_root_ca_certificate_id str
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    pca_sub_ca_certificate_id str
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    port int
    监听器的监听端口,取值:1 - 65535 。
    project_name str
    监听器所属项目名称。
    protocol str
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    server_group_id str
    监听器的默认服务器组。
    server_groups Sequence[ListenerServerGroupArgs]
    status str
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    tags Sequence[ListenerTagArgs]
    updated_time str
    监听器最近一次的操作时间。
    accessLogRecordCustomizedHeadersEnabled String
    监听器是否已开启“在访问日志中记录自定义header”的功能:on:表示该功能已开启。off:表示该功能未开启。
    aclIds List<String>
    监听器绑定的访问控制策略组 ID。当AclStatus参数配置为 on 时,AclIds为必填参数。
    aclStatus String
    是否开启访问控制功能。取值如下:on:开启。off :不开启(默认)。
    aclType String
    访问控制的方式,取值如下:white:白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器不会转发任何请求。black:黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。 如果所选策略组中没有添加任何IP,则监听器会转发全部请求。当AclStatus参数配置为 on 时,AclType为必填参数。
    caCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 alb 时,必须指定 CACertificateId 参数。
    caCertificateSource String
    HTTPS 监听器关联的 CA 证书的来源,用于双向认证。alb(默认):表示通过 ALB 上传的证书。标准版 ALB 实例不支持此来源的证书。pcaroot:表示通过火山引擎证书中心购买或上传的私有根 CA 证书。pcasub:表示通过火山引擎证书中心购买或上传的私有子 CA 证书。
    certCenterCertificateId String
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 cert_center 时必传。
    certificateId String
    HTTPS监听器关联的证书 ID。创建 HTTPS 监听器且证书来源为 alb 时必传。
    certificateSource String
    HTTPS监听器关联的默认证书的来源,取值:alb:表示通过 ALB 上传的证书。certcenter:表示通过火山引擎证书中心购买或上传的 SSL 证书。pcaleaf:表示通过火山引擎证书中心购买或上传的私有叶子证书。
    createdTime String
    监听器的创建时间。
    customizedCfgId String
    个性化配置ID,未绑定时值为空字符串。
    description String
    监听器的描述。不能以http://或https://开头。必须以字母或中文开头,可包含数字、英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。) 。长度限制为1 ~ 255个字符。不填默认为空字符串。
    domainExtensions List<Property Map>
    enableHttp2 String
    HTTP2.0 特性开关,该参数仅对 HTTPS 监听器有效。取值如下:on:开启。off:关闭(默认)。
    enableQuic String
    QUIC 特性开关,该参数仅对 HTTPS 监听器有效,取值如下:on:开启。off:关闭(默认)。只有标准版 ALB 实例支持 QUIC。
    enabled String
    监听器开启/关闭,取值如下:on:开启(默认)。off:关闭。
    listenerId String
    监听器 ID。
    listenerName String
    监听器的名字。不填写时以“协议-端口”格式命名。不能以http://或https://开头。必须以字母或中文开头,可包含数字、点(.)、下划线(_)和短横线(-)。长度限制在1-128字符之间。
    loadBalancerId String
    监听器所属的负载均衡实例 ID。
    pcaLeafCertificateId String
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    pcaRootCaCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_root 时,必须指定 PcaRootCACertificateId 参数。
    pcaSubCaCertificateId String
    HTTPS 监听器关联的 CA 证书 ID。该参数用于 HTTPS 监听器的双向认证。当证书来源是 pca_sub 时,必须指定 PcaSubCACertificateId 参数。
    port Number
    监听器的监听端口,取值:1 - 65535 。
    projectName String
    监听器所属项目名称。
    protocol String
    监听器的协议,支持 HTTP 协议和 HTTPS 协议。
    serverGroupId String
    监听器的默认服务器组。
    serverGroups List<Property Map>
    status String
    监听器的状态。取值如下:Creating:创建中。Active: 运行中。Pending: 变配中。Disabled:已停止。Deleting:删除中。
    tags List<Property Map>
    updatedTime String
    监听器最近一次的操作时间。

    Supporting Types

    ListenerDomainExtension, ListenerDomainExtensionArgs

    CertCenterCertificateId string
    域名使用的服务器证书 ID 。当证书来源为 cert_center 时生效。
    CertificateId string
    域名使用的服务器证书 ID。当证书来源为 alb 时生效。
    CertificateSource string
    域名使用的服务器证书的来源,取值:alb:表示通过 ALB 上传的证书。cert_center:表示通过火山引擎证书中心购买或上传的 SSL 证书。
    Domain string
    域名。通常不能为空,若实例支持自动选择扩展证书,即SniAutoMatch为on,则Domain需传入空字符串。需至少包含一个‘.’,且不允许以‘.’开头或结尾。仅允许包含小写字、字、‘.’、‘-‘、‘’。长度限制为1 ~ 128个字符。泛域名:使用“”代替1个或多个字符。“”必须在域名开头或结尾。同一条域名中“”不能出现两次。“*”前后不能有除了.以外的字符。精确域名:符合域名规范的精确域名。同一HTTPS监听器下的域名不能重复。匹配域名时,对域名的大小写不敏感。
    PcaLeafCertificateId string
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    San string
    若实例支持自动选择扩展证书,即SniAutoMatch为on时,则Domain是空字符串。San为证书的扩展域名,用英文,分隔多个域名。
    CertCenterCertificateId string
    域名使用的服务器证书 ID 。当证书来源为 cert_center 时生效。
    CertificateId string
    域名使用的服务器证书 ID。当证书来源为 alb 时生效。
    CertificateSource string
    域名使用的服务器证书的来源,取值:alb:表示通过 ALB 上传的证书。cert_center:表示通过火山引擎证书中心购买或上传的 SSL 证书。
    Domain string
    域名。通常不能为空,若实例支持自动选择扩展证书,即SniAutoMatch为on,则Domain需传入空字符串。需至少包含一个‘.’,且不允许以‘.’开头或结尾。仅允许包含小写字、字、‘.’、‘-‘、‘’。长度限制为1 ~ 128个字符。泛域名:使用“”代替1个或多个字符。“”必须在域名开头或结尾。同一条域名中“”不能出现两次。“*”前后不能有除了.以外的字符。精确域名:符合域名规范的精确域名。同一HTTPS监听器下的域名不能重复。匹配域名时,对域名的大小写不敏感。
    PcaLeafCertificateId string
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    San string
    若实例支持自动选择扩展证书,即SniAutoMatch为on时,则Domain是空字符串。San为证书的扩展域名,用英文,分隔多个域名。
    certCenterCertificateId String
    域名使用的服务器证书 ID 。当证书来源为 cert_center 时生效。
    certificateId String
    域名使用的服务器证书 ID。当证书来源为 alb 时生效。
    certificateSource String
    域名使用的服务器证书的来源,取值:alb:表示通过 ALB 上传的证书。cert_center:表示通过火山引擎证书中心购买或上传的 SSL 证书。
    domain String
    域名。通常不能为空,若实例支持自动选择扩展证书,即SniAutoMatch为on,则Domain需传入空字符串。需至少包含一个‘.’,且不允许以‘.’开头或结尾。仅允许包含小写字、字、‘.’、‘-‘、‘’。长度限制为1 ~ 128个字符。泛域名:使用“”代替1个或多个字符。“”必须在域名开头或结尾。同一条域名中“”不能出现两次。“*”前后不能有除了.以外的字符。精确域名:符合域名规范的精确域名。同一HTTPS监听器下的域名不能重复。匹配域名时,对域名的大小写不敏感。
    pcaLeafCertificateId String
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    san String
    若实例支持自动选择扩展证书,即SniAutoMatch为on时,则Domain是空字符串。San为证书的扩展域名,用英文,分隔多个域名。
    certCenterCertificateId string
    域名使用的服务器证书 ID 。当证书来源为 cert_center 时生效。
    certificateId string
    域名使用的服务器证书 ID。当证书来源为 alb 时生效。
    certificateSource string
    域名使用的服务器证书的来源,取值:alb:表示通过 ALB 上传的证书。cert_center:表示通过火山引擎证书中心购买或上传的 SSL 证书。
    domain string
    域名。通常不能为空,若实例支持自动选择扩展证书,即SniAutoMatch为on,则Domain需传入空字符串。需至少包含一个‘.’,且不允许以‘.’开头或结尾。仅允许包含小写字、字、‘.’、‘-‘、‘’。长度限制为1 ~ 128个字符。泛域名:使用“”代替1个或多个字符。“”必须在域名开头或结尾。同一条域名中“”不能出现两次。“*”前后不能有除了.以外的字符。精确域名:符合域名规范的精确域名。同一HTTPS监听器下的域名不能重复。匹配域名时,对域名的大小写不敏感。
    pcaLeafCertificateId string
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    san string
    若实例支持自动选择扩展证书,即SniAutoMatch为on时,则Domain是空字符串。San为证书的扩展域名,用英文,分隔多个域名。
    cert_center_certificate_id str
    域名使用的服务器证书 ID 。当证书来源为 cert_center 时生效。
    certificate_id str
    域名使用的服务器证书 ID。当证书来源为 alb 时生效。
    certificate_source str
    域名使用的服务器证书的来源,取值:alb:表示通过 ALB 上传的证书。cert_center:表示通过火山引擎证书中心购买或上传的 SSL 证书。
    domain str
    域名。通常不能为空,若实例支持自动选择扩展证书,即SniAutoMatch为on,则Domain需传入空字符串。需至少包含一个‘.’,且不允许以‘.’开头或结尾。仅允许包含小写字、字、‘.’、‘-‘、‘’。长度限制为1 ~ 128个字符。泛域名:使用“”代替1个或多个字符。“”必须在域名开头或结尾。同一条域名中“”不能出现两次。“*”前后不能有除了.以外的字符。精确域名:符合域名规范的精确域名。同一HTTPS监听器下的域名不能重复。匹配域名时,对域名的大小写不敏感。
    pca_leaf_certificate_id str
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    san str
    若实例支持自动选择扩展证书,即SniAutoMatch为on时,则Domain是空字符串。San为证书的扩展域名,用英文,分隔多个域名。
    certCenterCertificateId String
    域名使用的服务器证书 ID 。当证书来源为 cert_center 时生效。
    certificateId String
    域名使用的服务器证书 ID。当证书来源为 alb 时生效。
    certificateSource String
    域名使用的服务器证书的来源,取值:alb:表示通过 ALB 上传的证书。cert_center:表示通过火山引擎证书中心购买或上传的 SSL 证书。
    domain String
    域名。通常不能为空,若实例支持自动选择扩展证书,即SniAutoMatch为on,则Domain需传入空字符串。需至少包含一个‘.’,且不允许以‘.’开头或结尾。仅允许包含小写字、字、‘.’、‘-‘、‘’。长度限制为1 ~ 128个字符。泛域名:使用“”代替1个或多个字符。“”必须在域名开头或结尾。同一条域名中“”不能出现两次。“*”前后不能有除了.以外的字符。精确域名:符合域名规范的精确域名。同一HTTPS监听器下的域名不能重复。匹配域名时,对域名的大小写不敏感。
    pcaLeafCertificateId String
    HTTPS监听器关联的私有叶子证书 ID。创建 HTTPS 监听器且证书来源为 pca_leaf 时必传。
    san String
    若实例支持自动选择扩展证书,即SniAutoMatch为on时,则Domain是空字符串。San为证书的扩展域名,用英文,分隔多个域名。

    ListenerServerGroup, ListenerServerGroupArgs

    ServerGroupId string
    服务器组 ID 。
    ServerGroupName string
    服务器组名称。
    ServerGroupId string
    服务器组 ID 。
    ServerGroupName string
    服务器组名称。
    serverGroupId String
    服务器组 ID 。
    serverGroupName String
    服务器组名称。
    serverGroupId string
    服务器组 ID 。
    serverGroupName string
    服务器组名称。
    server_group_id str
    服务器组 ID 。
    server_group_name str
    服务器组名称。
    serverGroupId String
    服务器组 ID 。
    serverGroupName String
    服务器组名称。

    ListenerTag, ListenerTagArgs

    Key string
    用户标签的标签键。具体规则如下:长度限制为1~128个字符。大小写敏感。不能以volc:的任意大小写组合开头。不能以空格开头或结尾。允许包含各国语言文字、数字、空格)、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。同一资源的标签键不允许重复。
    Value string
    用户标签的标签值。具体规则如下:长度限制为0~256个字符。大小写敏感。不能以空格开头或结尾。允许包含各国语言文字、数字、空格()、下划线(_)、点号(.)、半角冒(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。
    Key string
    用户标签的标签键。具体规则如下:长度限制为1~128个字符。大小写敏感。不能以volc:的任意大小写组合开头。不能以空格开头或结尾。允许包含各国语言文字、数字、空格)、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。同一资源的标签键不允许重复。
    Value string
    用户标签的标签值。具体规则如下:长度限制为0~256个字符。大小写敏感。不能以空格开头或结尾。允许包含各国语言文字、数字、空格()、下划线(_)、点号(.)、半角冒(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。
    key String
    用户标签的标签键。具体规则如下:长度限制为1~128个字符。大小写敏感。不能以volc:的任意大小写组合开头。不能以空格开头或结尾。允许包含各国语言文字、数字、空格)、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。同一资源的标签键不允许重复。
    value String
    用户标签的标签值。具体规则如下:长度限制为0~256个字符。大小写敏感。不能以空格开头或结尾。允许包含各国语言文字、数字、空格()、下划线(_)、点号(.)、半角冒(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。
    key string
    用户标签的标签键。具体规则如下:长度限制为1~128个字符。大小写敏感。不能以volc:的任意大小写组合开头。不能以空格开头或结尾。允许包含各国语言文字、数字、空格)、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。同一资源的标签键不允许重复。
    value string
    用户标签的标签值。具体规则如下:长度限制为0~256个字符。大小写敏感。不能以空格开头或结尾。允许包含各国语言文字、数字、空格()、下划线(_)、点号(.)、半角冒(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。
    key str
    用户标签的标签键。具体规则如下:长度限制为1~128个字符。大小写敏感。不能以volc:的任意大小写组合开头。不能以空格开头或结尾。允许包含各国语言文字、数字、空格)、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。同一资源的标签键不允许重复。
    value str
    用户标签的标签值。具体规则如下:长度限制为0~256个字符。大小写敏感。不能以空格开头或结尾。允许包含各国语言文字、数字、空格()、下划线(_)、点号(.)、半角冒(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。
    key String
    用户标签的标签键。具体规则如下:长度限制为1~128个字符。大小写敏感。不能以volc:的任意大小写组合开头。不能以空格开头或结尾。允许包含各国语言文字、数字、空格)、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。同一资源的标签键不允许重复。
    value String
    用户标签的标签值。具体规则如下:长度限制为0~256个字符。大小写敏感。不能以空格开头或结尾。允许包含各国语言文字、数字、空格()、下划线(_)、点号(.)、半角冒(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。

    Import

    $ pulumi import volcenginecc:alb/listener:Listener 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.4 published on Monday, Nov 3, 2025 by Volcengine
      Meet Neo: Your AI Platform Teammate