1. Packages
  2. Flexibleengine Provider
  3. API Docs
  4. LbListenerV3
flexibleengine 1.46.0 published on Monday, Apr 14, 2025 by flexibleenginecloud

flexibleengine.LbListenerV3

Explore with Pulumi AI

flexibleengine logo
flexibleengine 1.46.0 published on Monday, Apr 14, 2025 by flexibleenginecloud

    Manages an ELB v3 listener resource within FlexibleEngine.

    Create LbListenerV3 Resource

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

    Constructor syntax

    new LbListenerV3(name: string, args: LbListenerV3Args, opts?: CustomResourceOptions);
    @overload
    def LbListenerV3(resource_name: str,
                     args: LbListenerV3Args,
                     opts: Optional[ResourceOptions] = None)
    
    @overload
    def LbListenerV3(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     loadbalancer_id: Optional[str] = None,
                     protocol_port: Optional[float] = None,
                     protocol: Optional[str] = None,
                     forward_host: Optional[bool] = None,
                     protection_reason: Optional[str] = None,
                     force_delete: Optional[bool] = None,
                     forward_eip: Optional[bool] = None,
                     access_policy: Optional[str] = None,
                     forward_port: Optional[bool] = None,
                     forward_request_port: Optional[bool] = None,
                     http2_enable: Optional[bool] = None,
                     idle_timeout: Optional[float] = None,
                     ip_group: Optional[str] = None,
                     lb_listener_v3_id: Optional[str] = None,
                     default_pool_id: Optional[str] = None,
                     name: Optional[str] = None,
                     description: Optional[str] = None,
                     protection_status: Optional[str] = None,
                     ca_certificate: Optional[str] = None,
                     advanced_forwarding_enabled: Optional[bool] = None,
                     region: Optional[str] = None,
                     request_timeout: Optional[float] = None,
                     response_timeout: Optional[float] = None,
                     server_certificate: Optional[str] = None,
                     sni_certificates: Optional[Sequence[str]] = None,
                     tags: Optional[Mapping[str, str]] = None,
                     timeouts: Optional[LbListenerV3TimeoutsArgs] = None,
                     tls_ciphers_policy: Optional[str] = None)
    func NewLbListenerV3(ctx *Context, name string, args LbListenerV3Args, opts ...ResourceOption) (*LbListenerV3, error)
    public LbListenerV3(string name, LbListenerV3Args args, CustomResourceOptions? opts = null)
    public LbListenerV3(String name, LbListenerV3Args args)
    public LbListenerV3(String name, LbListenerV3Args args, CustomResourceOptions options)
    
    type: flexibleengine:LbListenerV3
    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 LbListenerV3Args
    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 LbListenerV3Args
    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 LbListenerV3Args
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LbListenerV3Args
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LbListenerV3Args
    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 lbListenerV3Resource = new Flexibleengine.LbListenerV3("lbListenerV3Resource", new()
    {
        LoadbalancerId = "string",
        ProtocolPort = 0,
        Protocol = "string",
        ForwardHost = false,
        ProtectionReason = "string",
        ForceDelete = false,
        ForwardEip = false,
        AccessPolicy = "string",
        ForwardPort = false,
        ForwardRequestPort = false,
        Http2Enable = false,
        IdleTimeout = 0,
        IpGroup = "string",
        LbListenerV3Id = "string",
        DefaultPoolId = "string",
        Name = "string",
        Description = "string",
        ProtectionStatus = "string",
        CaCertificate = "string",
        AdvancedForwardingEnabled = false,
        Region = "string",
        RequestTimeout = 0,
        ResponseTimeout = 0,
        ServerCertificate = "string",
        SniCertificates = new[]
        {
            "string",
        },
        Tags = 
        {
            { "string", "string" },
        },
        Timeouts = new Flexibleengine.Inputs.LbListenerV3TimeoutsArgs
        {
            Create = "string",
            Delete = "string",
            Update = "string",
        },
        TlsCiphersPolicy = "string",
    });
    
    example, err := flexibleengine.NewLbListenerV3(ctx, "lbListenerV3Resource", &flexibleengine.LbListenerV3Args{
    	LoadbalancerId:            pulumi.String("string"),
    	ProtocolPort:              pulumi.Float64(0),
    	Protocol:                  pulumi.String("string"),
    	ForwardHost:               pulumi.Bool(false),
    	ProtectionReason:          pulumi.String("string"),
    	ForceDelete:               pulumi.Bool(false),
    	ForwardEip:                pulumi.Bool(false),
    	AccessPolicy:              pulumi.String("string"),
    	ForwardPort:               pulumi.Bool(false),
    	ForwardRequestPort:        pulumi.Bool(false),
    	Http2Enable:               pulumi.Bool(false),
    	IdleTimeout:               pulumi.Float64(0),
    	IpGroup:                   pulumi.String("string"),
    	LbListenerV3Id:            pulumi.String("string"),
    	DefaultPoolId:             pulumi.String("string"),
    	Name:                      pulumi.String("string"),
    	Description:               pulumi.String("string"),
    	ProtectionStatus:          pulumi.String("string"),
    	CaCertificate:             pulumi.String("string"),
    	AdvancedForwardingEnabled: pulumi.Bool(false),
    	Region:                    pulumi.String("string"),
    	RequestTimeout:            pulumi.Float64(0),
    	ResponseTimeout:           pulumi.Float64(0),
    	ServerCertificate:         pulumi.String("string"),
    	SniCertificates: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Timeouts: &flexibleengine.LbListenerV3TimeoutsArgs{
    		Create: pulumi.String("string"),
    		Delete: pulumi.String("string"),
    		Update: pulumi.String("string"),
    	},
    	TlsCiphersPolicy: pulumi.String("string"),
    })
    
    var lbListenerV3Resource = new LbListenerV3("lbListenerV3Resource", LbListenerV3Args.builder()
        .loadbalancerId("string")
        .protocolPort(0)
        .protocol("string")
        .forwardHost(false)
        .protectionReason("string")
        .forceDelete(false)
        .forwardEip(false)
        .accessPolicy("string")
        .forwardPort(false)
        .forwardRequestPort(false)
        .http2Enable(false)
        .idleTimeout(0)
        .ipGroup("string")
        .lbListenerV3Id("string")
        .defaultPoolId("string")
        .name("string")
        .description("string")
        .protectionStatus("string")
        .caCertificate("string")
        .advancedForwardingEnabled(false)
        .region("string")
        .requestTimeout(0)
        .responseTimeout(0)
        .serverCertificate("string")
        .sniCertificates("string")
        .tags(Map.of("string", "string"))
        .timeouts(LbListenerV3TimeoutsArgs.builder()
            .create("string")
            .delete("string")
            .update("string")
            .build())
        .tlsCiphersPolicy("string")
        .build());
    
    lb_listener_v3_resource = flexibleengine.LbListenerV3("lbListenerV3Resource",
        loadbalancer_id="string",
        protocol_port=0,
        protocol="string",
        forward_host=False,
        protection_reason="string",
        force_delete=False,
        forward_eip=False,
        access_policy="string",
        forward_port=False,
        forward_request_port=False,
        http2_enable=False,
        idle_timeout=0,
        ip_group="string",
        lb_listener_v3_id="string",
        default_pool_id="string",
        name="string",
        description="string",
        protection_status="string",
        ca_certificate="string",
        advanced_forwarding_enabled=False,
        region="string",
        request_timeout=0,
        response_timeout=0,
        server_certificate="string",
        sni_certificates=["string"],
        tags={
            "string": "string",
        },
        timeouts={
            "create": "string",
            "delete": "string",
            "update": "string",
        },
        tls_ciphers_policy="string")
    
    const lbListenerV3Resource = new flexibleengine.LbListenerV3("lbListenerV3Resource", {
        loadbalancerId: "string",
        protocolPort: 0,
        protocol: "string",
        forwardHost: false,
        protectionReason: "string",
        forceDelete: false,
        forwardEip: false,
        accessPolicy: "string",
        forwardPort: false,
        forwardRequestPort: false,
        http2Enable: false,
        idleTimeout: 0,
        ipGroup: "string",
        lbListenerV3Id: "string",
        defaultPoolId: "string",
        name: "string",
        description: "string",
        protectionStatus: "string",
        caCertificate: "string",
        advancedForwardingEnabled: false,
        region: "string",
        requestTimeout: 0,
        responseTimeout: 0,
        serverCertificate: "string",
        sniCertificates: ["string"],
        tags: {
            string: "string",
        },
        timeouts: {
            create: "string",
            "delete": "string",
            update: "string",
        },
        tlsCiphersPolicy: "string",
    });
    
    type: flexibleengine:LbListenerV3
    properties:
        accessPolicy: string
        advancedForwardingEnabled: false
        caCertificate: string
        defaultPoolId: string
        description: string
        forceDelete: false
        forwardEip: false
        forwardHost: false
        forwardPort: false
        forwardRequestPort: false
        http2Enable: false
        idleTimeout: 0
        ipGroup: string
        lbListenerV3Id: string
        loadbalancerId: string
        name: string
        protectionReason: string
        protectionStatus: string
        protocol: string
        protocolPort: 0
        region: string
        requestTimeout: 0
        responseTimeout: 0
        serverCertificate: string
        sniCertificates:
            - string
        tags:
            string: string
        timeouts:
            create: string
            delete: string
            update: string
        tlsCiphersPolicy: string
    

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

    LoadbalancerId string
    The load balancer on which to provision this listener. Changing this creates a new listener.
    Protocol string
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    ProtocolPort double
    The port on which to listen for client traffic. Changing this creates a new listener.
    AccessPolicy string
    Specifies the access policy for the listener. Valid options are white and black.
    AdvancedForwardingEnabled bool
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    CaCertificate string
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    DefaultPoolId string
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    Description string
    Human-readable description for the listener.
    ForceDelete bool
    ForwardEip bool
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    ForwardHost bool
    ForwardPort bool
    ForwardRequestPort bool
    Http2Enable bool
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    IdleTimeout double
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    IpGroup string
    Specifies the ip group id for the listener.
    LbListenerV3Id string
    The unique ID for the listener.
    Name string
    Human-readable name for the listener.
    ProtectionReason string
    ProtectionStatus string
    Region string
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    RequestTimeout double
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    ResponseTimeout double
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    ServerCertificate string
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    SniCertificates List<string>
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    Tags Dictionary<string, string>
    The key/value pairs to associate with the listener.
    Timeouts LbListenerV3Timeouts
    TlsCiphersPolicy string
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    LoadbalancerId string
    The load balancer on which to provision this listener. Changing this creates a new listener.
    Protocol string
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    ProtocolPort float64
    The port on which to listen for client traffic. Changing this creates a new listener.
    AccessPolicy string
    Specifies the access policy for the listener. Valid options are white and black.
    AdvancedForwardingEnabled bool
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    CaCertificate string
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    DefaultPoolId string
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    Description string
    Human-readable description for the listener.
    ForceDelete bool
    ForwardEip bool
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    ForwardHost bool
    ForwardPort bool
    ForwardRequestPort bool
    Http2Enable bool
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    IdleTimeout float64
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    IpGroup string
    Specifies the ip group id for the listener.
    LbListenerV3Id string
    The unique ID for the listener.
    Name string
    Human-readable name for the listener.
    ProtectionReason string
    ProtectionStatus string
    Region string
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    RequestTimeout float64
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    ResponseTimeout float64
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    ServerCertificate string
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    SniCertificates []string
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    Tags map[string]string
    The key/value pairs to associate with the listener.
    Timeouts LbListenerV3TimeoutsArgs
    TlsCiphersPolicy string
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    loadbalancerId String
    The load balancer on which to provision this listener. Changing this creates a new listener.
    protocol String
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    protocolPort Double
    The port on which to listen for client traffic. Changing this creates a new listener.
    accessPolicy String
    Specifies the access policy for the listener. Valid options are white and black.
    advancedForwardingEnabled Boolean
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    caCertificate String
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    defaultPoolId String
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    description String
    Human-readable description for the listener.
    forceDelete Boolean
    forwardEip Boolean
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    forwardHost Boolean
    forwardPort Boolean
    forwardRequestPort Boolean
    http2Enable Boolean
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    idleTimeout Double
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    ipGroup String
    Specifies the ip group id for the listener.
    lbListenerV3Id String
    The unique ID for the listener.
    name String
    Human-readable name for the listener.
    protectionReason String
    protectionStatus String
    region String
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    requestTimeout Double
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    responseTimeout Double
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    serverCertificate String
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    sniCertificates List<String>
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    tags Map<String,String>
    The key/value pairs to associate with the listener.
    timeouts LbListenerV3Timeouts
    tlsCiphersPolicy String
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    loadbalancerId string
    The load balancer on which to provision this listener. Changing this creates a new listener.
    protocol string
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    protocolPort number
    The port on which to listen for client traffic. Changing this creates a new listener.
    accessPolicy string
    Specifies the access policy for the listener. Valid options are white and black.
    advancedForwardingEnabled boolean
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    caCertificate string
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    defaultPoolId string
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    description string
    Human-readable description for the listener.
    forceDelete boolean
    forwardEip boolean
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    forwardHost boolean
    forwardPort boolean
    forwardRequestPort boolean
    http2Enable boolean
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    idleTimeout number
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    ipGroup string
    Specifies the ip group id for the listener.
    lbListenerV3Id string
    The unique ID for the listener.
    name string
    Human-readable name for the listener.
    protectionReason string
    protectionStatus string
    region string
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    requestTimeout number
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    responseTimeout number
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    serverCertificate string
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    sniCertificates string[]
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    tags {[key: string]: string}
    The key/value pairs to associate with the listener.
    timeouts LbListenerV3Timeouts
    tlsCiphersPolicy string
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    loadbalancer_id str
    The load balancer on which to provision this listener. Changing this creates a new listener.
    protocol str
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    protocol_port float
    The port on which to listen for client traffic. Changing this creates a new listener.
    access_policy str
    Specifies the access policy for the listener. Valid options are white and black.
    advanced_forwarding_enabled bool
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    ca_certificate str
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    default_pool_id str
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    description str
    Human-readable description for the listener.
    force_delete bool
    forward_eip bool
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    forward_host bool
    forward_port bool
    forward_request_port bool
    http2_enable bool
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    idle_timeout float
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    ip_group str
    Specifies the ip group id for the listener.
    lb_listener_v3_id str
    The unique ID for the listener.
    name str
    Human-readable name for the listener.
    protection_reason str
    protection_status str
    region str
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    request_timeout float
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    response_timeout float
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    server_certificate str
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    sni_certificates Sequence[str]
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    tags Mapping[str, str]
    The key/value pairs to associate with the listener.
    timeouts LbListenerV3TimeoutsArgs
    tls_ciphers_policy str
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    loadbalancerId String
    The load balancer on which to provision this listener. Changing this creates a new listener.
    protocol String
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    protocolPort Number
    The port on which to listen for client traffic. Changing this creates a new listener.
    accessPolicy String
    Specifies the access policy for the listener. Valid options are white and black.
    advancedForwardingEnabled Boolean
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    caCertificate String
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    defaultPoolId String
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    description String
    Human-readable description for the listener.
    forceDelete Boolean
    forwardEip Boolean
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    forwardHost Boolean
    forwardPort Boolean
    forwardRequestPort Boolean
    http2Enable Boolean
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    idleTimeout Number
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    ipGroup String
    Specifies the ip group id for the listener.
    lbListenerV3Id String
    The unique ID for the listener.
    name String
    Human-readable name for the listener.
    protectionReason String
    protectionStatus String
    region String
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    requestTimeout Number
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    responseTimeout Number
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    serverCertificate String
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    sniCertificates List<String>
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    tags Map<String>
    The key/value pairs to associate with the listener.
    timeouts Property Map
    tlsCiphersPolicy String
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing LbListenerV3 Resource

    Get an existing LbListenerV3 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?: LbListenerV3State, opts?: CustomResourceOptions): LbListenerV3
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            access_policy: Optional[str] = None,
            advanced_forwarding_enabled: Optional[bool] = None,
            ca_certificate: Optional[str] = None,
            default_pool_id: Optional[str] = None,
            description: Optional[str] = None,
            force_delete: Optional[bool] = None,
            forward_eip: Optional[bool] = None,
            forward_host: Optional[bool] = None,
            forward_port: Optional[bool] = None,
            forward_request_port: Optional[bool] = None,
            http2_enable: Optional[bool] = None,
            idle_timeout: Optional[float] = None,
            ip_group: Optional[str] = None,
            lb_listener_v3_id: Optional[str] = None,
            loadbalancer_id: Optional[str] = None,
            name: Optional[str] = None,
            protection_reason: Optional[str] = None,
            protection_status: Optional[str] = None,
            protocol: Optional[str] = None,
            protocol_port: Optional[float] = None,
            region: Optional[str] = None,
            request_timeout: Optional[float] = None,
            response_timeout: Optional[float] = None,
            server_certificate: Optional[str] = None,
            sni_certificates: Optional[Sequence[str]] = None,
            tags: Optional[Mapping[str, str]] = None,
            timeouts: Optional[LbListenerV3TimeoutsArgs] = None,
            tls_ciphers_policy: Optional[str] = None) -> LbListenerV3
    func GetLbListenerV3(ctx *Context, name string, id IDInput, state *LbListenerV3State, opts ...ResourceOption) (*LbListenerV3, error)
    public static LbListenerV3 Get(string name, Input<string> id, LbListenerV3State? state, CustomResourceOptions? opts = null)
    public static LbListenerV3 get(String name, Output<String> id, LbListenerV3State state, CustomResourceOptions options)
    resources:  _:    type: flexibleengine:LbListenerV3    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:
    AccessPolicy string
    Specifies the access policy for the listener. Valid options are white and black.
    AdvancedForwardingEnabled bool
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    CaCertificate string
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    DefaultPoolId string
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    Description string
    Human-readable description for the listener.
    ForceDelete bool
    ForwardEip bool
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    ForwardHost bool
    ForwardPort bool
    ForwardRequestPort bool
    Http2Enable bool
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    IdleTimeout double
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    IpGroup string
    Specifies the ip group id for the listener.
    LbListenerV3Id string
    The unique ID for the listener.
    LoadbalancerId string
    The load balancer on which to provision this listener. Changing this creates a new listener.
    Name string
    Human-readable name for the listener.
    ProtectionReason string
    ProtectionStatus string
    Protocol string
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    ProtocolPort double
    The port on which to listen for client traffic. Changing this creates a new listener.
    Region string
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    RequestTimeout double
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    ResponseTimeout double
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    ServerCertificate string
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    SniCertificates List<string>
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    Tags Dictionary<string, string>
    The key/value pairs to associate with the listener.
    Timeouts LbListenerV3Timeouts
    TlsCiphersPolicy string
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    AccessPolicy string
    Specifies the access policy for the listener. Valid options are white and black.
    AdvancedForwardingEnabled bool
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    CaCertificate string
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    DefaultPoolId string
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    Description string
    Human-readable description for the listener.
    ForceDelete bool
    ForwardEip bool
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    ForwardHost bool
    ForwardPort bool
    ForwardRequestPort bool
    Http2Enable bool
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    IdleTimeout float64
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    IpGroup string
    Specifies the ip group id for the listener.
    LbListenerV3Id string
    The unique ID for the listener.
    LoadbalancerId string
    The load balancer on which to provision this listener. Changing this creates a new listener.
    Name string
    Human-readable name for the listener.
    ProtectionReason string
    ProtectionStatus string
    Protocol string
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    ProtocolPort float64
    The port on which to listen for client traffic. Changing this creates a new listener.
    Region string
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    RequestTimeout float64
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    ResponseTimeout float64
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    ServerCertificate string
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    SniCertificates []string
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    Tags map[string]string
    The key/value pairs to associate with the listener.
    Timeouts LbListenerV3TimeoutsArgs
    TlsCiphersPolicy string
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    accessPolicy String
    Specifies the access policy for the listener. Valid options are white and black.
    advancedForwardingEnabled Boolean
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    caCertificate String
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    defaultPoolId String
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    description String
    Human-readable description for the listener.
    forceDelete Boolean
    forwardEip Boolean
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    forwardHost Boolean
    forwardPort Boolean
    forwardRequestPort Boolean
    http2Enable Boolean
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    idleTimeout Double
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    ipGroup String
    Specifies the ip group id for the listener.
    lbListenerV3Id String
    The unique ID for the listener.
    loadbalancerId String
    The load balancer on which to provision this listener. Changing this creates a new listener.
    name String
    Human-readable name for the listener.
    protectionReason String
    protectionStatus String
    protocol String
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    protocolPort Double
    The port on which to listen for client traffic. Changing this creates a new listener.
    region String
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    requestTimeout Double
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    responseTimeout Double
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    serverCertificate String
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    sniCertificates List<String>
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    tags Map<String,String>
    The key/value pairs to associate with the listener.
    timeouts LbListenerV3Timeouts
    tlsCiphersPolicy String
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    accessPolicy string
    Specifies the access policy for the listener. Valid options are white and black.
    advancedForwardingEnabled boolean
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    caCertificate string
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    defaultPoolId string
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    description string
    Human-readable description for the listener.
    forceDelete boolean
    forwardEip boolean
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    forwardHost boolean
    forwardPort boolean
    forwardRequestPort boolean
    http2Enable boolean
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    idleTimeout number
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    ipGroup string
    Specifies the ip group id for the listener.
    lbListenerV3Id string
    The unique ID for the listener.
    loadbalancerId string
    The load balancer on which to provision this listener. Changing this creates a new listener.
    name string
    Human-readable name for the listener.
    protectionReason string
    protectionStatus string
    protocol string
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    protocolPort number
    The port on which to listen for client traffic. Changing this creates a new listener.
    region string
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    requestTimeout number
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    responseTimeout number
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    serverCertificate string
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    sniCertificates string[]
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    tags {[key: string]: string}
    The key/value pairs to associate with the listener.
    timeouts LbListenerV3Timeouts
    tlsCiphersPolicy string
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    access_policy str
    Specifies the access policy for the listener. Valid options are white and black.
    advanced_forwarding_enabled bool
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    ca_certificate str
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    default_pool_id str
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    description str
    Human-readable description for the listener.
    force_delete bool
    forward_eip bool
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    forward_host bool
    forward_port bool
    forward_request_port bool
    http2_enable bool
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    idle_timeout float
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    ip_group str
    Specifies the ip group id for the listener.
    lb_listener_v3_id str
    The unique ID for the listener.
    loadbalancer_id str
    The load balancer on which to provision this listener. Changing this creates a new listener.
    name str
    Human-readable name for the listener.
    protection_reason str
    protection_status str
    protocol str
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    protocol_port float
    The port on which to listen for client traffic. Changing this creates a new listener.
    region str
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    request_timeout float
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    response_timeout float
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    server_certificate str
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    sni_certificates Sequence[str]
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    tags Mapping[str, str]
    The key/value pairs to associate with the listener.
    timeouts LbListenerV3TimeoutsArgs
    tls_ciphers_policy str
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.
    accessPolicy String
    Specifies the access policy for the listener. Valid options are white and black.
    advancedForwardingEnabled Boolean
    Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported.
    caCertificate String
    Specifies the ID of the CA certificate used by the listener. This parameter is valid when protocol is set to HTTPS.
    defaultPoolId String
    The ID of the default pool with which the listener is associated. Changing this creates a new listener.
    description String
    Human-readable description for the listener.
    forceDelete Boolean
    forwardEip Boolean
    Specifies whether transfer the load balancer EIP in the X-Forward-EIP header to backend servers. The default value is false. This parameter is valid only when the protocol is set to HTTP or HTTPS.
    forwardHost Boolean
    forwardPort Boolean
    forwardRequestPort Boolean
    http2Enable Boolean
    Specifies whether to use HTTP/2. The default value is false. This parameter is valid only when the protocol is set to HTTPS.
    idleTimeout Number
    Specifies the idle timeout for the listener. Value range: 0 to 4000.
    ipGroup String
    Specifies the ip group id for the listener.
    lbListenerV3Id String
    The unique ID for the listener.
    loadbalancerId String
    The load balancer on which to provision this listener. Changing this creates a new listener.
    name String
    Human-readable name for the listener.
    protectionReason String
    protectionStatus String
    protocol String
    The protocol can either be TCP, UDP, HTTP or HTTPS. Changing this creates a new listener.
    protocolPort Number
    The port on which to listen for client traffic. Changing this creates a new listener.
    region String
    The region in which to create the listener resource. If omitted, the provider-level region will be used. Changing this creates a new listener.
    requestTimeout Number
    Specifies the request timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    responseTimeout Number
    Specifies the response timeout for the listener. Value range: 1 to 300. This parameter is valid when protocol is set to HTTP or HTTPS.
    serverCertificate String
    Specifies the ID of the server certificate used by the listener. This parameter is mandatory when protocol is set to HTTPS.
    sniCertificates List<String>
    Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener. This parameter is valid when protocol is set to HTTPS.
    tags Map<String>
    The key/value pairs to associate with the listener.
    timeouts Property Map
    tlsCiphersPolicy String
    Specifies the TLS cipher policy for the listener. Valid options are: tls-1-0-inherit, tls-1-0, tls-1-1, tls-1-2, tls-1-2-strict, tls-1-2-fs, tls-1-0-with-1-3, and tls-1-2-fs-with-1-3. This parameter is valid when protocol is set to HTTPS.

    Supporting Types

    LbListenerV3Timeouts, LbListenerV3TimeoutsArgs

    Create string
    Delete string
    Update string
    Create string
    Delete string
    Update string
    create String
    delete String
    update String
    create string
    delete string
    update string
    create str
    delete str
    update str
    create String
    delete String
    update String

    Import

    ELB listener can be imported using the listener ID, e.g.

    $ pulumi import flexibleengine:index/lbListenerV3:LbListenerV3 listener_1 5c20fdad-7288-11eb-b817-0255ac10158b
    

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

    Package Details

    Repository
    flexibleengine flexibleenginecloud/terraform-provider-flexibleengine
    License
    Notes
    This Pulumi package is based on the flexibleengine Terraform Provider.
    flexibleengine logo
    flexibleengine 1.46.0 published on Monday, Apr 14, 2025 by flexibleenginecloud