Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. Alibaba Cloud Provider
  4. API Docs
  5. ens
  6. LoadBalancerHttpListener
Viewing docs for Alibaba Cloud v3.108.0
published on Thursday, Sep 17, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-alicloud

alicloud.ens.LoadBalancerHttpListener

alicloud logo alicloud logo
Viewing docs for Alibaba Cloud v3.108.0
published on Thursday, Sep 17, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-alicloud

    Provides a ENS Load Balancer HTTP Listener resource.

    HTTP listener for Edge Load Balancer (ELB) in Edge Node Service (ENS).

    For information about ENS Load Balancer HTTP Listener and how to use it, see CreateLoadBalancerHTTPListener.

    NOTE: Available since v1.291.0.

    Example Usage

    Basic Usage

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

const config = new pulumi.Config();
const name = config.get("name") || "terraform-example";
const network = new alicloud.ens.Network("network", {
    networkName: name,
    description: name,
    cidrBlock: "192.168.0.0/16",
    ensRegionId: "cn-chenzhou-telecom_unicom_cmcc",
});
const _switch = new alicloud.ens.Vswitch("switch", {
    description: name,
    cidrBlock: "192.168.2.0/24",
    vswitchName: name,
    ensRegionId: "cn-chenzhou-telecom_unicom_cmcc",
    networkId: network.id,
});
const _default = new alicloud.ens.LoadBalancer("default", {
    loadBalancerName: name,
    paymentType: "PayAsYouGo",
    ensRegionId: "cn-chenzhou-telecom_unicom_cmcc",
    loadBalancerSpec: "elb.s1.small",
    vswitchId: _switch.id,
    networkId: network.id,
});
const defaultLoadBalancerHttpListener = new alicloud.ens.LoadBalancerHttpListener("default", {
    loadBalancerId: _default.id,
    listenerPort: 80,
    healthCheck: "on",
    healthCheckUri: "/",
});

    import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "terraform-example"
network = alicloud.ens.Network("network",
    network_name=name,
    description=name,
    cidr_block="192.168.0.0/16",
    ens_region_id="cn-chenzhou-telecom_unicom_cmcc")
switch = alicloud.ens.Vswitch("switch",
    description=name,
    cidr_block="192.168.2.0/24",
    vswitch_name=name,
    ens_region_id="cn-chenzhou-telecom_unicom_cmcc",
    network_id=network.id)
default = alicloud.ens.LoadBalancer("default",
    load_balancer_name=name,
    payment_type="PayAsYouGo",
    ens_region_id="cn-chenzhou-telecom_unicom_cmcc",
    load_balancer_spec="elb.s1.small",
    vswitch_id=switch.id,
    network_id=network.id)
default_load_balancer_http_listener = alicloud.ens.LoadBalancerHttpListener("default",
    load_balancer_id=default.id,
    listener_port=80,
    health_check="on",
    health_check_uri="/")

    package main

import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ens"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		name := "terraform-example"
		if param := cfg.Get("name"); param != "" {
			name = param
		}
		network, err := ens.NewNetwork(ctx, "network", &ens.NetworkArgs{
			NetworkName: pulumi.String(name),
			Description: pulumi.String(name),
			CidrBlock:   pulumi.String("192.168.0.0/16"),
			EnsRegionId: pulumi.String("cn-chenzhou-telecom_unicom_cmcc"),
		})
		if err != nil {
			return err
		}
		_switch, err := ens.NewVswitch(ctx, "switch", &ens.VswitchArgs{
			Description: pulumi.String(name),
			CidrBlock:   pulumi.String("192.168.2.0/24"),
			VswitchName: pulumi.String(name),
			EnsRegionId: pulumi.String("cn-chenzhou-telecom_unicom_cmcc"),
			NetworkId:   network.ID().ToIDOutput().ToStringOutput(),
		})
		if err != nil {
			return err
		}
		_default, err := ens.NewLoadBalancer(ctx, "default", &ens.LoadBalancerArgs{
			LoadBalancerName: pulumi.String(name),
			PaymentType:      pulumi.String("PayAsYouGo"),
			EnsRegionId:      pulumi.String("cn-chenzhou-telecom_unicom_cmcc"),
			LoadBalancerSpec: pulumi.String("elb.s1.small"),
			VswitchId:        _switch.ID().ToIDOutput().ToStringOutput(),
			NetworkId:        network.ID().ToIDOutput().ToStringOutput(),
		})
		if err != nil {
			return err
		}
		_, err = ens.NewLoadBalancerHttpListener(ctx, "default", &ens.LoadBalancerHttpListenerArgs{
			LoadBalancerId: _default.ID().ToIDOutput().ToStringOutput(),
			ListenerPort:   pulumi.Int(80),
			HealthCheck:    pulumi.String("on"),
			HealthCheckUri: pulumi.String("/"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var config = new Config();
    var name = config.Get("name") ?? "terraform-example";
    var network = new AliCloud.Ens.Network("network", new()
    {
        NetworkName = name,
        Description = name,
        CidrBlock = "192.168.0.0/16",
        EnsRegionId = "cn-chenzhou-telecom_unicom_cmcc",
    });

    var @switch = new AliCloud.Ens.Vswitch("switch", new()
    {
        Description = name,
        CidrBlock = "192.168.2.0/24",
        VswitchName = name,
        EnsRegionId = "cn-chenzhou-telecom_unicom_cmcc",
        NetworkId = network.Id,
    });

    var @default = new AliCloud.Ens.LoadBalancer("default", new()
    {
        LoadBalancerName = name,
        PaymentType = "PayAsYouGo",
        EnsRegionId = "cn-chenzhou-telecom_unicom_cmcc",
        LoadBalancerSpec = "elb.s1.small",
        VswitchId = @switch.Id,
        NetworkId = network.Id,
    });

    var defaultLoadBalancerHttpListener = new AliCloud.Ens.LoadBalancerHttpListener("default", new()
    {
        LoadBalancerId = @default.Id,
        ListenerPort = 80,
        HealthCheck = "on",
        HealthCheckUri = "/",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ens.Network;
import com.pulumi.alicloud.ens.NetworkArgs;
import com.pulumi.alicloud.ens.Vswitch;
import com.pulumi.alicloud.ens.VswitchArgs;
import com.pulumi.alicloud.ens.LoadBalancer;
import com.pulumi.alicloud.ens.LoadBalancerArgs;
import com.pulumi.alicloud.ens.LoadBalancerHttpListener;
import com.pulumi.alicloud.ens.LoadBalancerHttpListenerArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("terraform-example");
        var network = new Network("network", NetworkArgs.builder()
            .networkName(name)
            .description(name)
            .cidrBlock("192.168.0.0/16")
            .ensRegionId("cn-chenzhou-telecom_unicom_cmcc")
            .build());

        var switch_ = new Vswitch("switch", VswitchArgs.builder()
            .description(name)
            .cidrBlock("192.168.2.0/24")
            .vswitchName(name)
            .ensRegionId("cn-chenzhou-telecom_unicom_cmcc")
            .networkId(network.id())
            .build());

        var default_ = new LoadBalancer("default", LoadBalancerArgs.builder()
            .loadBalancerName(name)
            .paymentType("PayAsYouGo")
            .ensRegionId("cn-chenzhou-telecom_unicom_cmcc")
            .loadBalancerSpec("elb.s1.small")
            .vswitchId(switch_.id())
            .networkId(network.id())
            .build());

        var defaultLoadBalancerHttpListener = new LoadBalancerHttpListener("defaultLoadBalancerHttpListener", LoadBalancerHttpListenerArgs.builder()
            .loadBalancerId(default_.id())
            .listenerPort(80)
            .healthCheck("on")
            .healthCheckUri("/")
            .build());

    }
}

    configuration:
  name:
    type: string
    default: terraform-example
resources:
  network:
    type: alicloud:ens:Network
    properties:
      networkName: ${name}
      description: ${name}
      cidrBlock: 192.168.0.0/16
      ensRegionId: cn-chenzhou-telecom_unicom_cmcc
  switch:
    type: alicloud:ens:Vswitch
    properties:
      description: ${name}
      cidrBlock: 192.168.2.0/24
      vswitchName: ${name}
      ensRegionId: cn-chenzhou-telecom_unicom_cmcc
      networkId: ${network.id}
  default:
    type: alicloud:ens:LoadBalancer
    properties:
      loadBalancerName: ${name}
      paymentType: PayAsYouGo
      ensRegionId: cn-chenzhou-telecom_unicom_cmcc
      loadBalancerSpec: elb.s1.small
      vswitchId: ${switch.id}
      networkId: ${network.id}
  defaultLoadBalancerHttpListener:
    type: alicloud:ens:LoadBalancerHttpListener
    name: default
    properties:
      loadBalancerId: ${default.id}
      listenerPort: 80
      healthCheck: on
      healthCheckUri: /

    pulumi {
  required_providers {
    alicloud = {
      source = "pulumi/alicloud"
    }
  }
}

resource "alicloud_ens_network" "network" {
  network_name  = var.name
  description   = var.name
  cidr_block    = "192.168.0.0/16"
  ens_region_id = "cn-chenzhou-telecom_unicom_cmcc"
}
resource "alicloud_ens_vswitch" "switch" {
  description   = var.name
  cidr_block    = "192.168.2.0/24"
  vswitch_name  = var.name
  ens_region_id = "cn-chenzhou-telecom_unicom_cmcc"
  network_id    = alicloud_ens_network.network.id
}
resource "alicloud_ens_loadbalancer" "default" {
  load_balancer_name = var.name
  payment_type       = "PayAsYouGo"
  ens_region_id      = "cn-chenzhou-telecom_unicom_cmcc"
  load_balancer_spec = "elb.s1.small"
  vswitch_id         = alicloud_ens_vswitch.switch.id
  network_id         = alicloud_ens_network.network.id
}
resource "alicloud_ens_loadbalancerhttplistener" "default" {
  load_balancer_id = alicloud_ens_loadbalancer.default.id
  listener_port    = 80
  health_check     = "on"
  health_check_uri = "/"
}
variable "name" {
  type    = string
  default = "terraform-example"
}

    📚 Need more examples? VIEW MORE EXAMPLES

    Create LoadBalancerHttpListener Resource

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

    Constructor syntax

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

@overload
def LoadBalancerHttpListener(resource_name: str,
                             opts: Optional[ResourceOptions] = None,
                             listener_port: Optional[int] = None,
                             load_balancer_id: Optional[str] = None,
                             health_check_domain: Optional[str] = None,
                             healthy_threshold: Optional[int] = None,
                             health_check_connect_port: Optional[int] = None,
                             backend_server_port: Optional[int] = None,
                             health_check_http_code: Optional[str] = None,
                             health_check_interval: Optional[int] = None,
                             health_check_method: Optional[str] = None,
                             health_check_timeout: Optional[int] = None,
                             health_check_uri: Optional[str] = None,
                             health_check: Optional[str] = None,
                             idle_timeout: Optional[int] = None,
                             listener_forward: Optional[str] = None,
                             forward_port: Optional[int] = None,
                             description: Optional[str] = None,
                             request_timeout: Optional[int] = None,
                             scheduler: Optional[str] = None,
                             status: Optional[str] = None,
                             unhealthy_threshold: Optional[int] = None,
                             x_forwarded_for: Optional[str] = None)
    func NewLoadBalancerHttpListener(ctx *Context, name string, args LoadBalancerHttpListenerArgs, opts ...ResourceOption) (*LoadBalancerHttpListener, error)
    public LoadBalancerHttpListener(string name, LoadBalancerHttpListenerArgs args, CustomResourceOptions? opts = null)
    public LoadBalancerHttpListener(String name, LoadBalancerHttpListenerArgs args)
public LoadBalancerHttpListener(String name, LoadBalancerHttpListenerArgs args, CustomResourceOptions options)

    type: alicloud:ens:LoadBalancerHttpListener
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "alicloud_ens_load_balancer_http_listener" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args LoadBalancerHttpListenerArgs
    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 LoadBalancerHttpListenerArgs
    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 LoadBalancerHttpListenerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LoadBalancerHttpListenerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LoadBalancerHttpListenerArgs
    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 loadBalancerHttpListenerResource = new AliCloud.Ens.LoadBalancerHttpListener("loadBalancerHttpListenerResource", new()
{
    ListenerPort = 0,
    LoadBalancerId = "string",
    HealthCheckDomain = "string",
    HealthyThreshold = 0,
    HealthCheckConnectPort = 0,
    BackendServerPort = 0,
    HealthCheckHttpCode = "string",
    HealthCheckInterval = 0,
    HealthCheckMethod = "string",
    HealthCheckTimeout = 0,
    HealthCheckUri = "string",
    HealthCheck = "string",
    IdleTimeout = 0,
    ListenerForward = "string",
    ForwardPort = 0,
    Description = "string",
    RequestTimeout = 0,
    Scheduler = "string",
    Status = "string",
    UnhealthyThreshold = 0,
    XForwardedFor = "string",
});

    example, err := ens.NewLoadBalancerHttpListener(ctx, "loadBalancerHttpListenerResource", &ens.LoadBalancerHttpListenerArgs{
	ListenerPort:           pulumi.Int(0),
	LoadBalancerId:         pulumi.String("string"),
	HealthCheckDomain:      pulumi.String("string"),
	HealthyThreshold:       pulumi.Int(0),
	HealthCheckConnectPort: pulumi.Int(0),
	BackendServerPort:      pulumi.Int(0),
	HealthCheckHttpCode:    pulumi.String("string"),
	HealthCheckInterval:    pulumi.Int(0),
	HealthCheckMethod:      pulumi.String("string"),
	HealthCheckTimeout:     pulumi.Int(0),
	HealthCheckUri:         pulumi.String("string"),
	HealthCheck:            pulumi.String("string"),
	IdleTimeout:            pulumi.Int(0),
	ListenerForward:        pulumi.String("string"),
	ForwardPort:            pulumi.Int(0),
	Description:            pulumi.String("string"),
	RequestTimeout:         pulumi.Int(0),
	Scheduler:              pulumi.String("string"),
	Status:                 pulumi.String("string"),
	UnhealthyThreshold:     pulumi.Int(0),
	XForwardedFor:          pulumi.String("string"),
})

    resource "alicloud_ens_load_balancer_http_listener" "loadBalancerHttpListenerResource" {
  lifecycle {
    create_before_destroy = true
  }
  listener_port             = 0
  load_balancer_id          = "string"
  health_check_domain       = "string"
  healthy_threshold         = 0
  health_check_connect_port = 0
  backend_server_port       = 0
  health_check_http_code    = "string"
  health_check_interval     = 0
  health_check_method       = "string"
  health_check_timeout      = 0
  health_check_uri          = "string"
  health_check              = "string"
  idle_timeout              = 0
  listener_forward          = "string"
  forward_port              = 0
  description               = "string"
  request_timeout           = 0
  scheduler                 = "string"
  status                    = "string"
  unhealthy_threshold       = 0
  x_forwarded_for           = "string"
}

    var loadBalancerHttpListenerResource = new LoadBalancerHttpListener("loadBalancerHttpListenerResource", LoadBalancerHttpListenerArgs.builder()
    .listenerPort(0)
    .loadBalancerId("string")
    .healthCheckDomain("string")
    .healthyThreshold(0)
    .healthCheckConnectPort(0)
    .backendServerPort(0)
    .healthCheckHttpCode("string")
    .healthCheckInterval(0)
    .healthCheckMethod("string")
    .healthCheckTimeout(0)
    .healthCheckUri("string")
    .healthCheck("string")
    .idleTimeout(0)
    .listenerForward("string")
    .forwardPort(0)
    .description("string")
    .requestTimeout(0)
    .scheduler("string")
    .status("string")
    .unhealthyThreshold(0)
    .xForwardedFor("string")
    .build());

    load_balancer_http_listener_resource = alicloud.ens.LoadBalancerHttpListener("loadBalancerHttpListenerResource",
    listener_port=0,
    load_balancer_id="string",
    health_check_domain="string",
    healthy_threshold=0,
    health_check_connect_port=0,
    backend_server_port=0,
    health_check_http_code="string",
    health_check_interval=0,
    health_check_method="string",
    health_check_timeout=0,
    health_check_uri="string",
    health_check="string",
    idle_timeout=0,
    listener_forward="string",
    forward_port=0,
    description="string",
    request_timeout=0,
    scheduler="string",
    status="string",
    unhealthy_threshold=0,
    x_forwarded_for="string")

    const loadBalancerHttpListenerResource = new alicloud.ens.LoadBalancerHttpListener("loadBalancerHttpListenerResource", {
    listenerPort: 0,
    loadBalancerId: "string",
    healthCheckDomain: "string",
    healthyThreshold: 0,
    healthCheckConnectPort: 0,
    backendServerPort: 0,
    healthCheckHttpCode: "string",
    healthCheckInterval: 0,
    healthCheckMethod: "string",
    healthCheckTimeout: 0,
    healthCheckUri: "string",
    healthCheck: "string",
    idleTimeout: 0,
    listenerForward: "string",
    forwardPort: 0,
    description: "string",
    requestTimeout: 0,
    scheduler: "string",
    status: "string",
    unhealthyThreshold: 0,
    xForwardedFor: "string",
});

    type: alicloud:ens:LoadBalancerHttpListener
properties:
    backendServerPort: 0
    description: string
    forwardPort: 0
    healthCheck: string
    healthCheckConnectPort: 0
    healthCheckDomain: string
    healthCheckHttpCode: string
    healthCheckInterval: 0
    healthCheckMethod: string
    healthCheckTimeout: 0
    healthCheckUri: string
    healthyThreshold: 0
    idleTimeout: 0
    listenerForward: string
    listenerPort: 0
    loadBalancerId: string
    requestTimeout: 0
    scheduler: string
    status: string
    unhealthyThreshold: 0
    xForwardedFor: string

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

    ListenerPort int
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    LoadBalancerId string
    The ID of the load balancer instance.
    BackendServerPort int
    The port used by the backend server. Valid values: 1 to 65535.
    Description string
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    ForwardPort int
    The port to which HTTP requests are forwarded for HTTPS.
    HealthCheck string
    Specifies whether to enable health checks. Valid values: on, off (default).
    HealthCheckConnectPort int
    The port used for health checks. Valid values: 1 to 65535.
    HealthCheckDomain string
    The domain name used for health checks.
    HealthCheckHttpCode string
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    HealthCheckInterval int
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    HealthCheckMethod string
    The HTTP method used for health checks. Valid values: head (default), get.
    HealthCheckTimeout int
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    HealthCheckUri string
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    HealthyThreshold int
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    IdleTimeout int
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    ListenerForward string
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    RequestTimeout int
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    Scheduler string
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    Status string
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    UnhealthyThreshold int
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    XForwardedFor string
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    ListenerPort int
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    LoadBalancerId string
    The ID of the load balancer instance.
    BackendServerPort int
    The port used by the backend server. Valid values: 1 to 65535.
    Description string
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    ForwardPort int
    The port to which HTTP requests are forwarded for HTTPS.
    HealthCheck string
    Specifies whether to enable health checks. Valid values: on, off (default).
    HealthCheckConnectPort int
    The port used for health checks. Valid values: 1 to 65535.
    HealthCheckDomain string
    The domain name used for health checks.
    HealthCheckHttpCode string
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    HealthCheckInterval int
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    HealthCheckMethod string
    The HTTP method used for health checks. Valid values: head (default), get.
    HealthCheckTimeout int
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    HealthCheckUri string
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    HealthyThreshold int
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    IdleTimeout int
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    ListenerForward string
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    RequestTimeout int
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    Scheduler string
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    Status string
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    UnhealthyThreshold int
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    XForwardedFor string
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    listener_port number
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    load_balancer_id string
    The ID of the load balancer instance.
    backend_server_port number
    The port used by the backend server. Valid values: 1 to 65535.
    description string
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forward_port number
    The port to which HTTP requests are forwarded for HTTPS.
    health_check string
    Specifies whether to enable health checks. Valid values: on, off (default).
    health_check_connect_port number
    The port used for health checks. Valid values: 1 to 65535.
    health_check_domain string
    The domain name used for health checks.
    health_check_http_code string
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    health_check_interval number
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    health_check_method string
    The HTTP method used for health checks. Valid values: head (default), get.
    health_check_timeout number
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    health_check_uri string
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthy_threshold number
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idle_timeout number
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listener_forward string
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    request_timeout number
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler string
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status string
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthy_threshold number
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    x_forwarded_for string
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    listenerPort Integer
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    loadBalancerId String
    The ID of the load balancer instance.
    backendServerPort Integer
    The port used by the backend server. Valid values: 1 to 65535.
    description String
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forwardPort Integer
    The port to which HTTP requests are forwarded for HTTPS.
    healthCheck String
    Specifies whether to enable health checks. Valid values: on, off (default).
    healthCheckConnectPort Integer
    The port used for health checks. Valid values: 1 to 65535.
    healthCheckDomain String
    The domain name used for health checks.
    healthCheckHttpCode String
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    healthCheckInterval Integer
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    healthCheckMethod String
    The HTTP method used for health checks. Valid values: head (default), get.
    healthCheckTimeout Integer
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    healthCheckUri String
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthyThreshold Integer
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idleTimeout Integer
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listenerForward String
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    requestTimeout Integer
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler String
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status String
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthyThreshold Integer
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    xForwardedFor String
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    listenerPort number
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    loadBalancerId string
    The ID of the load balancer instance.
    backendServerPort number
    The port used by the backend server. Valid values: 1 to 65535.
    description string
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forwardPort number
    The port to which HTTP requests are forwarded for HTTPS.
    healthCheck string
    Specifies whether to enable health checks. Valid values: on, off (default).
    healthCheckConnectPort number
    The port used for health checks. Valid values: 1 to 65535.
    healthCheckDomain string
    The domain name used for health checks.
    healthCheckHttpCode string
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    healthCheckInterval number
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    healthCheckMethod string
    The HTTP method used for health checks. Valid values: head (default), get.
    healthCheckTimeout number
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    healthCheckUri string
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthyThreshold number
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idleTimeout number
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listenerForward string
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    requestTimeout number
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler string
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status string
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthyThreshold number
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    xForwardedFor string
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    listener_port int
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    load_balancer_id str
    The ID of the load balancer instance.
    backend_server_port int
    The port used by the backend server. Valid values: 1 to 65535.
    description str
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forward_port int
    The port to which HTTP requests are forwarded for HTTPS.
    health_check str
    Specifies whether to enable health checks. Valid values: on, off (default).
    health_check_connect_port int
    The port used for health checks. Valid values: 1 to 65535.
    health_check_domain str
    The domain name used for health checks.
    health_check_http_code str
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    health_check_interval int
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    health_check_method str
    The HTTP method used for health checks. Valid values: head (default), get.
    health_check_timeout int
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    health_check_uri str
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthy_threshold int
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idle_timeout int
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listener_forward str
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    request_timeout int
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler str
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status str
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthy_threshold int
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    x_forwarded_for str
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    listenerPort Number
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    loadBalancerId String
    The ID of the load balancer instance.
    backendServerPort Number
    The port used by the backend server. Valid values: 1 to 65535.
    description String
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forwardPort Number
    The port to which HTTP requests are forwarded for HTTPS.
    healthCheck String
    Specifies whether to enable health checks. Valid values: on, off (default).
    healthCheckConnectPort Number
    The port used for health checks. Valid values: 1 to 65535.
    healthCheckDomain String
    The domain name used for health checks.
    healthCheckHttpCode String
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    healthCheckInterval Number
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    healthCheckMethod String
    The HTTP method used for health checks. Valid values: head (default), get.
    healthCheckTimeout Number
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    healthCheckUri String
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthyThreshold Number
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idleTimeout Number
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listenerForward String
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    requestTimeout Number
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler String
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status String
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthyThreshold Number
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    xForwardedFor String
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).

    Outputs

    All input properties are implicitly available as output properties. Additionally, the LoadBalancerHttpListener 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 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 LoadBalancerHttpListener Resource

    Get an existing LoadBalancerHttpListener 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?: LoadBalancerHttpListenerState, opts?: CustomResourceOptions): LoadBalancerHttpListener
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        backend_server_port: Optional[int] = None,
        description: Optional[str] = None,
        forward_port: Optional[int] = None,
        health_check: Optional[str] = None,
        health_check_connect_port: Optional[int] = None,
        health_check_domain: Optional[str] = None,
        health_check_http_code: Optional[str] = None,
        health_check_interval: Optional[int] = None,
        health_check_method: Optional[str] = None,
        health_check_timeout: Optional[int] = None,
        health_check_uri: Optional[str] = None,
        healthy_threshold: Optional[int] = None,
        idle_timeout: Optional[int] = None,
        listener_forward: Optional[str] = None,
        listener_port: Optional[int] = None,
        load_balancer_id: Optional[str] = None,
        request_timeout: Optional[int] = None,
        scheduler: Optional[str] = None,
        status: Optional[str] = None,
        unhealthy_threshold: Optional[int] = None,
        x_forwarded_for: Optional[str] = None) -> LoadBalancerHttpListener
    func GetLoadBalancerHttpListener(ctx *Context, name string, id IDInput, state *LoadBalancerHttpListenerState, opts ...ResourceOption) (*LoadBalancerHttpListener, error)
    public static LoadBalancerHttpListener Get(string name, Input<string> id, LoadBalancerHttpListenerState? state, CustomResourceOptions? opts = null)
    public static LoadBalancerHttpListener get(String name, Output<String> id, LoadBalancerHttpListenerState state, CustomResourceOptions options)
    resources:  _:    type: alicloud:ens:LoadBalancerHttpListener    get:      id: ${id}
    import {
  to = alicloud_ens_load_balancer_http_listener.example
  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:
    BackendServerPort int
    The port used by the backend server. Valid values: 1 to 65535.
    Description string
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    ForwardPort int
    The port to which HTTP requests are forwarded for HTTPS.
    HealthCheck string
    Specifies whether to enable health checks. Valid values: on, off (default).
    HealthCheckConnectPort int
    The port used for health checks. Valid values: 1 to 65535.
    HealthCheckDomain string
    The domain name used for health checks.
    HealthCheckHttpCode string
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    HealthCheckInterval int
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    HealthCheckMethod string
    The HTTP method used for health checks. Valid values: head (default), get.
    HealthCheckTimeout int
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    HealthCheckUri string
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    HealthyThreshold int
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    IdleTimeout int
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    ListenerForward string
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    ListenerPort int
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    LoadBalancerId string
    The ID of the load balancer instance.
    RequestTimeout int
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    Scheduler string
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    Status string
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    UnhealthyThreshold int
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    XForwardedFor string
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    BackendServerPort int
    The port used by the backend server. Valid values: 1 to 65535.
    Description string
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    ForwardPort int
    The port to which HTTP requests are forwarded for HTTPS.
    HealthCheck string
    Specifies whether to enable health checks. Valid values: on, off (default).
    HealthCheckConnectPort int
    The port used for health checks. Valid values: 1 to 65535.
    HealthCheckDomain string
    The domain name used for health checks.
    HealthCheckHttpCode string
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    HealthCheckInterval int
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    HealthCheckMethod string
    The HTTP method used for health checks. Valid values: head (default), get.
    HealthCheckTimeout int
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    HealthCheckUri string
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    HealthyThreshold int
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    IdleTimeout int
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    ListenerForward string
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    ListenerPort int
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    LoadBalancerId string
    The ID of the load balancer instance.
    RequestTimeout int
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    Scheduler string
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    Status string
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    UnhealthyThreshold int
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    XForwardedFor string
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    backend_server_port number
    The port used by the backend server. Valid values: 1 to 65535.
    description string
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forward_port number
    The port to which HTTP requests are forwarded for HTTPS.
    health_check string
    Specifies whether to enable health checks. Valid values: on, off (default).
    health_check_connect_port number
    The port used for health checks. Valid values: 1 to 65535.
    health_check_domain string
    The domain name used for health checks.
    health_check_http_code string
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    health_check_interval number
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    health_check_method string
    The HTTP method used for health checks. Valid values: head (default), get.
    health_check_timeout number
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    health_check_uri string
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthy_threshold number
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idle_timeout number
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listener_forward string
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    listener_port number
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    load_balancer_id string
    The ID of the load balancer instance.
    request_timeout number
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler string
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status string
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthy_threshold number
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    x_forwarded_for string
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    backendServerPort Integer
    The port used by the backend server. Valid values: 1 to 65535.
    description String
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forwardPort Integer
    The port to which HTTP requests are forwarded for HTTPS.
    healthCheck String
    Specifies whether to enable health checks. Valid values: on, off (default).
    healthCheckConnectPort Integer
    The port used for health checks. Valid values: 1 to 65535.
    healthCheckDomain String
    The domain name used for health checks.
    healthCheckHttpCode String
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    healthCheckInterval Integer
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    healthCheckMethod String
    The HTTP method used for health checks. Valid values: head (default), get.
    healthCheckTimeout Integer
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    healthCheckUri String
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthyThreshold Integer
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idleTimeout Integer
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listenerForward String
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    listenerPort Integer
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    loadBalancerId String
    The ID of the load balancer instance.
    requestTimeout Integer
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler String
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status String
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthyThreshold Integer
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    xForwardedFor String
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    backendServerPort number
    The port used by the backend server. Valid values: 1 to 65535.
    description string
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forwardPort number
    The port to which HTTP requests are forwarded for HTTPS.
    healthCheck string
    Specifies whether to enable health checks. Valid values: on, off (default).
    healthCheckConnectPort number
    The port used for health checks. Valid values: 1 to 65535.
    healthCheckDomain string
    The domain name used for health checks.
    healthCheckHttpCode string
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    healthCheckInterval number
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    healthCheckMethod string
    The HTTP method used for health checks. Valid values: head (default), get.
    healthCheckTimeout number
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    healthCheckUri string
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthyThreshold number
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idleTimeout number
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listenerForward string
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    listenerPort number
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    loadBalancerId string
    The ID of the load balancer instance.
    requestTimeout number
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler string
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status string
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthyThreshold number
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    xForwardedFor string
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    backend_server_port int
    The port used by the backend server. Valid values: 1 to 65535.
    description str
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forward_port int
    The port to which HTTP requests are forwarded for HTTPS.
    health_check str
    Specifies whether to enable health checks. Valid values: on, off (default).
    health_check_connect_port int
    The port used for health checks. Valid values: 1 to 65535.
    health_check_domain str
    The domain name used for health checks.
    health_check_http_code str
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    health_check_interval int
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    health_check_method str
    The HTTP method used for health checks. Valid values: head (default), get.
    health_check_timeout int
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    health_check_uri str
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthy_threshold int
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idle_timeout int
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listener_forward str
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    listener_port int
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    load_balancer_id str
    The ID of the load balancer instance.
    request_timeout int
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler str
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status str
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthy_threshold int
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    x_forwarded_for str
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).
    backendServerPort Number
    The port used by the backend server. Valid values: 1 to 65535.
    description String
    The name of the listener. The name must be 1 to 80 characters in length and cannot start with http:// or https://.
    forwardPort Number
    The port to which HTTP requests are forwarded for HTTPS.
    healthCheck String
    Specifies whether to enable health checks. Valid values: on, off (default).
    healthCheckConnectPort Number
    The port used for health checks. Valid values: 1 to 65535.
    healthCheckDomain String
    The domain name used for health checks.
    healthCheckHttpCode String
    The HTTP status code that indicates a successful health check. Valid values: http2xx (default), http3xx, http4xx, http5xx.
    healthCheckInterval Number
    The interval between two consecutive health checks in seconds. Valid values: 1 to 50. Default: 2.
    healthCheckMethod String
    The HTTP method used for health checks. Valid values: head (default), get.
    healthCheckTimeout Number
    The timeout period of a health check response in seconds. Valid values: 1 to 300. Default: 5.
    healthCheckUri String
    The URI used for health checks. Must start with / and be 1 to 80 characters in length.
    healthyThreshold Number
    The number of consecutive successful health checks required before the backend server is considered healthy. Valid values: 2 to 10. Default: 3.
    idleTimeout Number
    The timeout period of an idle connection in seconds. Valid values: 1 to 60. Default: 15.
    listenerForward String
    Specifies whether to enable HTTP-to-HTTPS forwarding. Valid values: on, off (default).
    listenerPort Number
    The port on which the listener forwards requests. Valid values: 1 to 65535.
    loadBalancerId String
    The ID of the load balancer instance.
    requestTimeout Number
    The request timeout period in seconds. A 504 error is returned if the backend server does not respond within this period. Valid values: 1 to 180. Default: 60.
    scheduler String
    The scheduling algorithm. Valid values: wrr (Weighted Round Robin, default), wlc (Weighted Least Connections), rr (Round Robin), sch (Source IP Hash), qch (QUIC Connection ID Hash), iqch (iQUIC CID Hash).
    status String
    The status of the listener. Set it to running to start the listener or stopped to stop it. If not specified, the listener is created in the stopped state.
    unhealthyThreshold Number
    The number of consecutive failed health checks required before the backend server is considered unhealthy. Valid values: 2 to 10. Default: 3.
    xForwardedFor String
    Specifies whether to use the X-Forwarded-For header to retrieve the real IP address of the client. Valid values: on, off (default).

    Import

    ENS Load Balancer HTTP Listener can be imported using the id, e.g.

    $ pulumi import alicloud:ens/loadBalancerHttpListener:LoadBalancerHttpListener example <load_balancer_id>:<listener_port>

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

    Package Details

    Repository
    Alibaba Cloud pulumi/pulumi-alicloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the alicloud Terraform Provider.
    alicloud logo alicloud logo
    Viewing docs for Alibaba Cloud v3.108.0
    published on Thursday, Sep 17, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-alicloud

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial