Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Ibm Provider
  3. API Docs
  4. IsLbListener
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud
ibm-cloud/terraform-provider-ibm

ibm.IsLbListener

Explore with Pulumi AI

ibm logo
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud
ibm-cloud/terraform-provider-ibm

    Create, update, or delete a listener for a VPC load balancer. For more information, about load balancer listener, see working with listeners.

    Note

    • When provisioning the load balancer listener along with load balancer pool or pool member, Use explicit depends on the resources or perform the pulumi up with parallelism. For more information, about explicit dependencies, see create resource dependencies.

    • VPC infrastructure services are a regional specific based endpoint, by default targets to us-south. Please make sure to target right region in the provider block as shown in the provider.tf file, if VPC service is created in region other than us-south.

      provider.tf

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

    import pulumi

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
    }
}

    {}

    Sample to create a load balancer listener with https_redirect.

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

const example2IsLb = new ibm.IsLb("example2IsLb", {subnets: [ibm_is_subnet.example.id]});
const example1 = new ibm.IsLbListener("example1", {
    lb: example2IsLb.isLbId,
    port: 9086,
    protocol: "https",
    certificateInstance: "crn:v1:bluemix:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed",
});
const example2IsLbListener = new ibm.IsLbListener("example2IsLbListener", {
    lb: example2IsLb.isLbId,
    port: 9087,
    protocol: "http",
    idleConnectionTimeout: 60,
    httpsRedirect: {
        httpStatusCode: 302,
        listener: {
            id: example1.listenerId,
        },
        uri: "/example?doc=get",
    },
});

    import pulumi
import pulumi_ibm as ibm

example2_is_lb = ibm.IsLb("example2IsLb", subnets=[ibm_is_subnet["example"]["id"]])
example1 = ibm.IsLbListener("example1",
    lb=example2_is_lb.is_lb_id,
    port=9086,
    protocol="https",
    certificate_instance="crn:v1:bluemix:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed")
example2_is_lb_listener = ibm.IsLbListener("example2IsLbListener",
    lb=example2_is_lb.is_lb_id,
    port=9087,
    protocol="http",
    idle_connection_timeout=60,
    https_redirect={
        "http_status_code": 302,
        "listener": {
            "id": example1.listener_id,
        },
        "uri": "/example?doc=get",
    })

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example2IsLb, err := ibm.NewIsLb(ctx, "example2IsLb", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				ibm_is_subnet.Example.Id,
			},
		})
		if err != nil {
			return err
		}
		example1, err := ibm.NewIsLbListener(ctx, "example1", &ibm.IsLbListenerArgs{
			Lb:                  example2IsLb.IsLbId,
			Port:                pulumi.Float64(9086),
			Protocol:            pulumi.String("https"),
			CertificateInstance: pulumi.String("crn:v1:bluemix:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed"),
		})
		if err != nil {
			return err
		}
		_, err = ibm.NewIsLbListener(ctx, "example2IsLbListener", &ibm.IsLbListenerArgs{
			Lb:                    example2IsLb.IsLbId,
			Port:                  pulumi.Float64(9087),
			Protocol:              pulumi.String("http"),
			IdleConnectionTimeout: pulumi.Float64(60),
			HttpsRedirect: &ibm.IsLbListenerHttpsRedirectArgs{
				HttpStatusCode: pulumi.Float64(302),
				Listener: &ibm.IsLbListenerHttpsRedirectListenerArgs{
					Id: example1.ListenerId,
				},
				Uri: pulumi.String("/example?doc=get"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var example2IsLb = new Ibm.IsLb("example2IsLb", new()
    {
        Subnets = new[]
        {
            ibm_is_subnet.Example.Id,
        },
    });

    var example1 = new Ibm.IsLbListener("example1", new()
    {
        Lb = example2IsLb.IsLbId,
        Port = 9086,
        Protocol = "https",
        CertificateInstance = "crn:v1:bluemix:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed",
    });

    var example2IsLbListener = new Ibm.IsLbListener("example2IsLbListener", new()
    {
        Lb = example2IsLb.IsLbId,
        Port = 9087,
        Protocol = "http",
        IdleConnectionTimeout = 60,
        HttpsRedirect = new Ibm.Inputs.IsLbListenerHttpsRedirectArgs
        {
            HttpStatusCode = 302,
            Listener = new Ibm.Inputs.IsLbListenerHttpsRedirectListenerArgs
            {
                Id = example1.ListenerId,
            },
            Uri = "/example?doc=get",
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IsLb;
import com.pulumi.ibm.IsLbArgs;
import com.pulumi.ibm.IsLbListener;
import com.pulumi.ibm.IsLbListenerArgs;
import com.pulumi.ibm.inputs.IsLbListenerHttpsRedirectArgs;
import com.pulumi.ibm.inputs.IsLbListenerHttpsRedirectListenerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        var example2IsLb = new IsLb("example2IsLb", IsLbArgs.builder()
            .subnets(ibm_is_subnet.example().id())
            .build());

        var example1 = new IsLbListener("example1", IsLbListenerArgs.builder()
            .lb(example2IsLb.isLbId())
            .port("9086")
            .protocol("https")
            .certificateInstance("crn:v1:bluemix:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed")
            .build());

        var example2IsLbListener = new IsLbListener("example2IsLbListener", IsLbListenerArgs.builder()
            .lb(example2IsLb.isLbId())
            .port("9087")
            .protocol("http")
            .idleConnectionTimeout(60)
            .httpsRedirect(IsLbListenerHttpsRedirectArgs.builder()
                .httpStatusCode(302)
                .listener(IsLbListenerHttpsRedirectListenerArgs.builder()
                    .id(example1.listenerId())
                    .build())
                .uri("/example?doc=get")
                .build())
            .build());

    }
}

    resources:
  example2IsLb:
    type: ibm:IsLb
    properties:
      subnets:
        - ${ibm_is_subnet.example.id}
  example1:
    type: ibm:IsLbListener
    properties:
      lb: ${example2IsLb.isLbId}
      port: '9086'
      protocol: https
      certificateInstance: crn:v1:bluemix:public:cloudcerts:us-south:a2d1bace7b46e4815a81e52c6ffeba5cf:af925157-b125-4db2-b642-adacb8b9c7f5:certificate:c81627a1bf6f766379cc4b98fd2a44ed
  example2IsLbListener:
    type: ibm:IsLbListener
    properties:
      lb: ${example2IsLb.isLbId}
      port: '9087'
      protocol: http
      idleConnectionTimeout: 60
      httpsRedirect:
        httpStatusCode: 302
        listener:
          id: ${example1.listenerId}
        uri: /example?doc=get

    Sample to create a load balancer listener for a route mode enabled private network load balancer.

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

const exampleIsVpc = new ibm.IsVpc("exampleIsVpc", {});
const exampleIsSubnet = new ibm.IsSubnet("exampleIsSubnet", {
    vpc: exampleIsVpc.isVpcId,
    zone: "us-south-2",
    ipv4CidrBlock: "10.240.68.0/24",
});
const exampleIsLb = new ibm.IsLb("exampleIsLb", {
    subnets: [exampleIsSubnet.isSubnetId],
    profile: "network-fixed",
    type: "private",
    routeMode: true,
});
const exampleIsLbListener = new ibm.IsLbListener("exampleIsLbListener", {
    lb: exampleIsLb.isLbId,
    protocol: "tcp",
    defaultPool: ibm_is_lb_pool.example.id,
});

    import pulumi
import pulumi_ibm as ibm

example_is_vpc = ibm.IsVpc("exampleIsVpc")
example_is_subnet = ibm.IsSubnet("exampleIsSubnet",
    vpc=example_is_vpc.is_vpc_id,
    zone="us-south-2",
    ipv4_cidr_block="10.240.68.0/24")
example_is_lb = ibm.IsLb("exampleIsLb",
    subnets=[example_is_subnet.is_subnet_id],
    profile="network-fixed",
    type="private",
    route_mode=True)
example_is_lb_listener = ibm.IsLbListener("exampleIsLbListener",
    lb=example_is_lb.is_lb_id,
    protocol="tcp",
    default_pool=ibm_is_lb_pool["example"]["id"])

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleIsVpc, err := ibm.NewIsVpc(ctx, "exampleIsVpc", nil)
		if err != nil {
			return err
		}
		exampleIsSubnet, err := ibm.NewIsSubnet(ctx, "exampleIsSubnet", &ibm.IsSubnetArgs{
			Vpc:           exampleIsVpc.IsVpcId,
			Zone:          pulumi.String("us-south-2"),
			Ipv4CidrBlock: pulumi.String("10.240.68.0/24"),
		})
		if err != nil {
			return err
		}
		exampleIsLb, err := ibm.NewIsLb(ctx, "exampleIsLb", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				exampleIsSubnet.IsSubnetId,
			},
			Profile:   pulumi.String("network-fixed"),
			Type:      pulumi.String("private"),
			RouteMode: pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		_, err = ibm.NewIsLbListener(ctx, "exampleIsLbListener", &ibm.IsLbListenerArgs{
			Lb:          exampleIsLb.IsLbId,
			Protocol:    pulumi.String("tcp"),
			DefaultPool: pulumi.Any(ibm_is_lb_pool.Example.Id),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var exampleIsVpc = new Ibm.IsVpc("exampleIsVpc");

    var exampleIsSubnet = new Ibm.IsSubnet("exampleIsSubnet", new()
    {
        Vpc = exampleIsVpc.IsVpcId,
        Zone = "us-south-2",
        Ipv4CidrBlock = "10.240.68.0/24",
    });

    var exampleIsLb = new Ibm.IsLb("exampleIsLb", new()
    {
        Subnets = new[]
        {
            exampleIsSubnet.IsSubnetId,
        },
        Profile = "network-fixed",
        Type = "private",
        RouteMode = true,
    });

    var exampleIsLbListener = new Ibm.IsLbListener("exampleIsLbListener", new()
    {
        Lb = exampleIsLb.IsLbId,
        Protocol = "tcp",
        DefaultPool = ibm_is_lb_pool.Example.Id,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IsVpc;
import com.pulumi.ibm.IsSubnet;
import com.pulumi.ibm.IsSubnetArgs;
import com.pulumi.ibm.IsLb;
import com.pulumi.ibm.IsLbArgs;
import com.pulumi.ibm.IsLbListener;
import com.pulumi.ibm.IsLbListenerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        var exampleIsVpc = new IsVpc("exampleIsVpc");

        var exampleIsSubnet = new IsSubnet("exampleIsSubnet", IsSubnetArgs.builder()
            .vpc(exampleIsVpc.isVpcId())
            .zone("us-south-2")
            .ipv4CidrBlock("10.240.68.0/24")
            .build());

        var exampleIsLb = new IsLb("exampleIsLb", IsLbArgs.builder()
            .subnets(exampleIsSubnet.isSubnetId())
            .profile("network-fixed")
            .type("private")
            .routeMode("true")
            .build());

        var exampleIsLbListener = new IsLbListener("exampleIsLbListener", IsLbListenerArgs.builder()
            .lb(exampleIsLb.isLbId())
            .protocol("tcp")
            .defaultPool(ibm_is_lb_pool.example().id())
            .build());

    }
}

    resources:
  exampleIsVpc:
    type: ibm:IsVpc
  exampleIsSubnet:
    type: ibm:IsSubnet
    properties:
      vpc: ${exampleIsVpc.isVpcId}
      zone: us-south-2
      ipv4CidrBlock: 10.240.68.0/24
  exampleIsLb:
    type: ibm:IsLb
    properties:
      subnets:
        - ${exampleIsSubnet.isSubnetId}
      profile: network-fixed
      type: private
      routeMode: 'true'
  exampleIsLbListener:
    type: ibm:IsLbListener
    properties:
      lb: ${exampleIsLb.isLbId}
      protocol: tcp
      defaultPool: ${ibm_is_lb_pool.example.id}

    Sample to create a public load balancer listener with range of ports.

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

const exampleIsVpc = new ibm.IsVpc("exampleIsVpc", {});
const exampleIsSubnet = new ibm.IsSubnet("exampleIsSubnet", {
    vpc: exampleIsVpc.isVpcId,
    zone: "us-south-2",
    ipv4CidrBlock: "10.240.68.0/24",
});
const exampleIsLb = new ibm.IsLb("exampleIsLb", {
    subnets: [exampleIsSubnet.isSubnetId],
    profile: "network-fixed",
    type: "public",
});
const example1 = new ibm.IsLbListener("example1", {
    lb: exampleIsLb.isLbId,
    protocol: "tcp",
    portMin: 100,
    portMax: 200,
});
const example2 = new ibm.IsLbListener("example2", {
    lb: exampleIsLb.isLbId,
    protocol: "tcp",
    portMin: 300,
    portMax: 400,
});

    import pulumi
import pulumi_ibm as ibm

example_is_vpc = ibm.IsVpc("exampleIsVpc")
example_is_subnet = ibm.IsSubnet("exampleIsSubnet",
    vpc=example_is_vpc.is_vpc_id,
    zone="us-south-2",
    ipv4_cidr_block="10.240.68.0/24")
example_is_lb = ibm.IsLb("exampleIsLb",
    subnets=[example_is_subnet.is_subnet_id],
    profile="network-fixed",
    type="public")
example1 = ibm.IsLbListener("example1",
    lb=example_is_lb.is_lb_id,
    protocol="tcp",
    port_min=100,
    port_max=200)
example2 = ibm.IsLbListener("example2",
    lb=example_is_lb.is_lb_id,
    protocol="tcp",
    port_min=300,
    port_max=400)

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleIsVpc, err := ibm.NewIsVpc(ctx, "exampleIsVpc", nil)
		if err != nil {
			return err
		}
		exampleIsSubnet, err := ibm.NewIsSubnet(ctx, "exampleIsSubnet", &ibm.IsSubnetArgs{
			Vpc:           exampleIsVpc.IsVpcId,
			Zone:          pulumi.String("us-south-2"),
			Ipv4CidrBlock: pulumi.String("10.240.68.0/24"),
		})
		if err != nil {
			return err
		}
		exampleIsLb, err := ibm.NewIsLb(ctx, "exampleIsLb", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				exampleIsSubnet.IsSubnetId,
			},
			Profile: pulumi.String("network-fixed"),
			Type:    pulumi.String("public"),
		})
		if err != nil {
			return err
		}
		_, err = ibm.NewIsLbListener(ctx, "example1", &ibm.IsLbListenerArgs{
			Lb:       exampleIsLb.IsLbId,
			Protocol: pulumi.String("tcp"),
			PortMin:  pulumi.Float64(100),
			PortMax:  pulumi.Float64(200),
		})
		if err != nil {
			return err
		}
		_, err = ibm.NewIsLbListener(ctx, "example2", &ibm.IsLbListenerArgs{
			Lb:       exampleIsLb.IsLbId,
			Protocol: pulumi.String("tcp"),
			PortMin:  pulumi.Float64(300),
			PortMax:  pulumi.Float64(400),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var exampleIsVpc = new Ibm.IsVpc("exampleIsVpc");

    var exampleIsSubnet = new Ibm.IsSubnet("exampleIsSubnet", new()
    {
        Vpc = exampleIsVpc.IsVpcId,
        Zone = "us-south-2",
        Ipv4CidrBlock = "10.240.68.0/24",
    });

    var exampleIsLb = new Ibm.IsLb("exampleIsLb", new()
    {
        Subnets = new[]
        {
            exampleIsSubnet.IsSubnetId,
        },
        Profile = "network-fixed",
        Type = "public",
    });

    var example1 = new Ibm.IsLbListener("example1", new()
    {
        Lb = exampleIsLb.IsLbId,
        Protocol = "tcp",
        PortMin = 100,
        PortMax = 200,
    });

    var example2 = new Ibm.IsLbListener("example2", new()
    {
        Lb = exampleIsLb.IsLbId,
        Protocol = "tcp",
        PortMin = 300,
        PortMax = 400,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IsVpc;
import com.pulumi.ibm.IsSubnet;
import com.pulumi.ibm.IsSubnetArgs;
import com.pulumi.ibm.IsLb;
import com.pulumi.ibm.IsLbArgs;
import com.pulumi.ibm.IsLbListener;
import com.pulumi.ibm.IsLbListenerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        var exampleIsVpc = new IsVpc("exampleIsVpc");

        var exampleIsSubnet = new IsSubnet("exampleIsSubnet", IsSubnetArgs.builder()
            .vpc(exampleIsVpc.isVpcId())
            .zone("us-south-2")
            .ipv4CidrBlock("10.240.68.0/24")
            .build());

        var exampleIsLb = new IsLb("exampleIsLb", IsLbArgs.builder()
            .subnets(exampleIsSubnet.isSubnetId())
            .profile("network-fixed")
            .type("public")
            .build());

        var example1 = new IsLbListener("example1", IsLbListenerArgs.builder()
            .lb(exampleIsLb.isLbId())
            .protocol("tcp")
            .portMin(100)
            .portMax(200)
            .build());

        var example2 = new IsLbListener("example2", IsLbListenerArgs.builder()
            .lb(exampleIsLb.isLbId())
            .protocol("tcp")
            .portMin(300)
            .portMax(400)
            .build());

    }
}

    resources:
  exampleIsVpc:
    type: ibm:IsVpc
  exampleIsSubnet:
    type: ibm:IsSubnet
    properties:
      vpc: ${exampleIsVpc.isVpcId}
      zone: us-south-2
      ipv4CidrBlock: 10.240.68.0/24
  exampleIsLb:
    type: ibm:IsLb
    properties:
      subnets:
        - ${exampleIsSubnet.isSubnetId}
      profile: network-fixed
      type: public
  example1:
    type: ibm:IsLbListener
    properties:
      lb: ${exampleIsLb.isLbId}
      protocol: tcp
      portMin: 100
      portMax: 200
  example2:
    type: ibm:IsLbListener
    properties:
      lb: ${exampleIsLb.isLbId}
      protocol: tcp
      portMin: 300
      portMax: 400

    Example to create a listener with

    Create IsLbListener Resource

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

    Constructor syntax

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

@overload
def IsLbListener(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 lb: Optional[str] = None,
                 protocol: Optional[str] = None,
                 idle_connection_timeout: Optional[float] = None,
                 is_lb_listener_id: Optional[str] = None,
                 https_redirect: Optional[IsLbListenerHttpsRedirectArgs] = None,
                 https_redirect_listener: Optional[str] = None,
                 https_redirect_status_code: Optional[float] = None,
                 https_redirect_uri: Optional[str] = None,
                 accept_proxy_protocol: Optional[bool] = None,
                 default_pool: Optional[str] = None,
                 connection_limit: Optional[float] = None,
                 port: Optional[float] = None,
                 port_max: Optional[float] = None,
                 port_min: Optional[float] = None,
                 certificate_instance: Optional[str] = None,
                 timeouts: Optional[IsLbListenerTimeoutsArgs] = None)
    func NewIsLbListener(ctx *Context, name string, args IsLbListenerArgs, opts ...ResourceOption) (*IsLbListener, error)
    public IsLbListener(string name, IsLbListenerArgs args, CustomResourceOptions? opts = null)
    public IsLbListener(String name, IsLbListenerArgs args)
public IsLbListener(String name, IsLbListenerArgs args, CustomResourceOptions options)

    type: ibm:IsLbListener
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 IsLbListenerArgs
    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 IsLbListenerArgs
    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 IsLbListenerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IsLbListenerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IsLbListenerArgs
    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 isLbListenerResource = new Ibm.IsLbListener("isLbListenerResource", new()
{
    Lb = "string",
    Protocol = "string",
    IdleConnectionTimeout = 0,
    IsLbListenerId = "string",
    HttpsRedirect = new Ibm.Inputs.IsLbListenerHttpsRedirectArgs
    {
        HttpStatusCode = 0,
        Listener = new Ibm.Inputs.IsLbListenerHttpsRedirectListenerArgs
        {
            Id = "string",
            Deleteds = new[]
            {
                new Ibm.Inputs.IsLbListenerHttpsRedirectListenerDeletedArgs
                {
                    MoreInfo = "string",
                },
            },
            Href = "string",
        },
        Uri = "string",
    },
    AcceptProxyProtocol = false,
    DefaultPool = "string",
    ConnectionLimit = 0,
    Port = 0,
    PortMax = 0,
    PortMin = 0,
    CertificateInstance = "string",
    Timeouts = new Ibm.Inputs.IsLbListenerTimeoutsArgs
    {
        Create = "string",
        Delete = "string",
        Update = "string",
    },
});

    example, err := ibm.NewIsLbListener(ctx, "isLbListenerResource", &ibm.IsLbListenerArgs{
	Lb:                    pulumi.String("string"),
	Protocol:              pulumi.String("string"),
	IdleConnectionTimeout: pulumi.Float64(0),
	IsLbListenerId:        pulumi.String("string"),
	HttpsRedirect: &ibm.IsLbListenerHttpsRedirectArgs{
		HttpStatusCode: pulumi.Float64(0),
		Listener: &ibm.IsLbListenerHttpsRedirectListenerArgs{
			Id: pulumi.String("string"),
			Deleteds: ibm.IsLbListenerHttpsRedirectListenerDeletedArray{
				&ibm.IsLbListenerHttpsRedirectListenerDeletedArgs{
					MoreInfo: pulumi.String("string"),
				},
			},
			Href: pulumi.String("string"),
		},
		Uri: pulumi.String("string"),
	},
	AcceptProxyProtocol: pulumi.Bool(false),
	DefaultPool:         pulumi.String("string"),
	ConnectionLimit:     pulumi.Float64(0),
	Port:                pulumi.Float64(0),
	PortMax:             pulumi.Float64(0),
	PortMin:             pulumi.Float64(0),
	CertificateInstance: pulumi.String("string"),
	Timeouts: &ibm.IsLbListenerTimeoutsArgs{
		Create: pulumi.String("string"),
		Delete: pulumi.String("string"),
		Update: pulumi.String("string"),
	},
})

    var isLbListenerResource = new IsLbListener("isLbListenerResource", IsLbListenerArgs.builder()
    .lb("string")
    .protocol("string")
    .idleConnectionTimeout(0)
    .isLbListenerId("string")
    .httpsRedirect(IsLbListenerHttpsRedirectArgs.builder()
        .httpStatusCode(0)
        .listener(IsLbListenerHttpsRedirectListenerArgs.builder()
            .id("string")
            .deleteds(IsLbListenerHttpsRedirectListenerDeletedArgs.builder()
                .moreInfo("string")
                .build())
            .href("string")
            .build())
        .uri("string")
        .build())
    .acceptProxyProtocol(false)
    .defaultPool("string")
    .connectionLimit(0)
    .port(0)
    .portMax(0)
    .portMin(0)
    .certificateInstance("string")
    .timeouts(IsLbListenerTimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .update("string")
        .build())
    .build());

    is_lb_listener_resource = ibm.IsLbListener("isLbListenerResource",
    lb="string",
    protocol="string",
    idle_connection_timeout=0,
    is_lb_listener_id="string",
    https_redirect={
        "http_status_code": 0,
        "listener": {
            "id": "string",
            "deleteds": [{
                "more_info": "string",
            }],
            "href": "string",
        },
        "uri": "string",
    },
    accept_proxy_protocol=False,
    default_pool="string",
    connection_limit=0,
    port=0,
    port_max=0,
    port_min=0,
    certificate_instance="string",
    timeouts={
        "create": "string",
        "delete": "string",
        "update": "string",
    })

    const isLbListenerResource = new ibm.IsLbListener("isLbListenerResource", {
    lb: "string",
    protocol: "string",
    idleConnectionTimeout: 0,
    isLbListenerId: "string",
    httpsRedirect: {
        httpStatusCode: 0,
        listener: {
            id: "string",
            deleteds: [{
                moreInfo: "string",
            }],
            href: "string",
        },
        uri: "string",
    },
    acceptProxyProtocol: false,
    defaultPool: "string",
    connectionLimit: 0,
    port: 0,
    portMax: 0,
    portMin: 0,
    certificateInstance: "string",
    timeouts: {
        create: "string",
        "delete": "string",
        update: "string",
    },
});

    type: ibm:IsLbListener
properties:
    acceptProxyProtocol: false
    certificateInstance: string
    connectionLimit: 0
    defaultPool: string
    httpsRedirect:
        httpStatusCode: 0
        listener:
            deleteds:
                - moreInfo: string
            href: string
            id: string
        uri: string
    idleConnectionTimeout: 0
    isLbListenerId: string
    lb: string
    port: 0
    portMax: 0
    portMin: 0
    protocol: string
    timeouts:
        create: string
        delete: string
        update: string

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

    Lb string
    The load balancer unique identifier.
    Protocol string
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    AcceptProxyProtocol bool
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    CertificateInstance string

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    ConnectionLimit double
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    DefaultPool string

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    HttpsRedirect IsLbListenerHttpsRedirect

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    HttpsRedirectListener string
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    HttpsRedirectStatusCode double
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    HttpsRedirectUri string

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    IdleConnectionTimeout double
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    IsLbListenerId string
    (String) The unique identifier for this load balancer listener.
    Port double

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    PortMax double

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    PortMin double

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    Timeouts IsLbListenerTimeouts
    Lb string
    The load balancer unique identifier.
    Protocol string
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    AcceptProxyProtocol bool
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    CertificateInstance string

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    ConnectionLimit float64
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    DefaultPool string

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    HttpsRedirect IsLbListenerHttpsRedirectArgs

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    HttpsRedirectListener string
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    HttpsRedirectStatusCode float64
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    HttpsRedirectUri string

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    IdleConnectionTimeout float64
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    IsLbListenerId string
    (String) The unique identifier for this load balancer listener.
    Port float64

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    PortMax float64

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    PortMin float64

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    Timeouts IsLbListenerTimeoutsArgs
    lb String
    The load balancer unique identifier.
    protocol String
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    acceptProxyProtocol Boolean
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    certificateInstance String

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    connectionLimit Double
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    defaultPool String

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    httpsRedirect IsLbListenerHttpsRedirect

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    httpsRedirectListener String
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    httpsRedirectStatusCode Double
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    httpsRedirectUri String

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    idleConnectionTimeout Double
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    isLbListenerId String
    (String) The unique identifier for this load balancer listener.
    port Double

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    portMax Double

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    portMin Double

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    timeouts IsLbListenerTimeouts
    lb string
    The load balancer unique identifier.
    protocol string
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    acceptProxyProtocol boolean
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    certificateInstance string

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    connectionLimit number
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    defaultPool string

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    httpsRedirect IsLbListenerHttpsRedirect

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    httpsRedirectListener string
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    httpsRedirectStatusCode number
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    httpsRedirectUri string

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    idleConnectionTimeout number
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    isLbListenerId string
    (String) The unique identifier for this load balancer listener.
    port number

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    portMax number

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    portMin number

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    timeouts IsLbListenerTimeouts
    lb str
    The load balancer unique identifier.
    protocol str
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    accept_proxy_protocol bool
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    certificate_instance str

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    connection_limit float
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    default_pool str

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    https_redirect IsLbListenerHttpsRedirectArgs

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    https_redirect_listener str
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    https_redirect_status_code float
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    https_redirect_uri str

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    idle_connection_timeout float
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    is_lb_listener_id str
    (String) The unique identifier for this load balancer listener.
    port float

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    port_max float

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    port_min float

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    timeouts IsLbListenerTimeoutsArgs
    lb String
    The load balancer unique identifier.
    protocol String
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    acceptProxyProtocol Boolean
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    certificateInstance String

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    connectionLimit Number
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    defaultPool String

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    httpsRedirect Property Map

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    httpsRedirectListener String
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    httpsRedirectStatusCode Number
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    httpsRedirectUri String

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    idleConnectionTimeout Number
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    isLbListenerId String
    (String) The unique identifier for this load balancer listener.
    port Number

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    portMax Number

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    portMin Number

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    timeouts Property Map

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerId string
    RelatedCrn string
    The crn of the LB resource
    Status string
    (String) The status of load balancer listener.
    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerId string
    RelatedCrn string
    The crn of the LB resource
    Status string
    (String) The status of load balancer listener.
    id String
    The provider-assigned unique ID for this managed resource.
    listenerId String
    relatedCrn String
    The crn of the LB resource
    status String
    (String) The status of load balancer listener.
    id string
    The provider-assigned unique ID for this managed resource.
    listenerId string
    relatedCrn string
    The crn of the LB resource
    status string
    (String) The status of load balancer listener.
    id str
    The provider-assigned unique ID for this managed resource.
    listener_id str
    related_crn str
    The crn of the LB resource
    status str
    (String) The status of load balancer listener.
    id String
    The provider-assigned unique ID for this managed resource.
    listenerId String
    relatedCrn String
    The crn of the LB resource
    status String
    (String) The status of load balancer listener.

    Look up Existing IsLbListener Resource

    Get an existing IsLbListener 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?: IsLbListenerState, opts?: CustomResourceOptions): IsLbListener
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        accept_proxy_protocol: Optional[bool] = None,
        certificate_instance: Optional[str] = None,
        connection_limit: Optional[float] = None,
        default_pool: Optional[str] = None,
        https_redirect: Optional[IsLbListenerHttpsRedirectArgs] = None,
        https_redirect_listener: Optional[str] = None,
        https_redirect_status_code: Optional[float] = None,
        https_redirect_uri: Optional[str] = None,
        idle_connection_timeout: Optional[float] = None,
        is_lb_listener_id: Optional[str] = None,
        lb: Optional[str] = None,
        listener_id: Optional[str] = None,
        port: Optional[float] = None,
        port_max: Optional[float] = None,
        port_min: Optional[float] = None,
        protocol: Optional[str] = None,
        related_crn: Optional[str] = None,
        status: Optional[str] = None,
        timeouts: Optional[IsLbListenerTimeoutsArgs] = None) -> IsLbListener
    func GetIsLbListener(ctx *Context, name string, id IDInput, state *IsLbListenerState, opts ...ResourceOption) (*IsLbListener, error)
    public static IsLbListener Get(string name, Input<string> id, IsLbListenerState? state, CustomResourceOptions? opts = null)
    public static IsLbListener get(String name, Output<String> id, IsLbListenerState state, CustomResourceOptions options)
    resources:  _:    type: ibm:IsLbListener    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:
    AcceptProxyProtocol bool
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    CertificateInstance string

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    ConnectionLimit double
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    DefaultPool string

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    HttpsRedirect IsLbListenerHttpsRedirect

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    HttpsRedirectListener string
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    HttpsRedirectStatusCode double
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    HttpsRedirectUri string

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    IdleConnectionTimeout double
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    IsLbListenerId string
    (String) The unique identifier for this load balancer listener.
    Lb string
    The load balancer unique identifier.
    ListenerId string
    Port double

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    PortMax double

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    PortMin double

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    Protocol string
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    RelatedCrn string
    The crn of the LB resource
    Status string
    (String) The status of load balancer listener.
    Timeouts IsLbListenerTimeouts
    AcceptProxyProtocol bool
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    CertificateInstance string

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    ConnectionLimit float64
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    DefaultPool string

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    HttpsRedirect IsLbListenerHttpsRedirectArgs

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    HttpsRedirectListener string
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    HttpsRedirectStatusCode float64
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    HttpsRedirectUri string

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    IdleConnectionTimeout float64
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    IsLbListenerId string
    (String) The unique identifier for this load balancer listener.
    Lb string
    The load balancer unique identifier.
    ListenerId string
    Port float64

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    PortMax float64

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    PortMin float64

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    Protocol string
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    RelatedCrn string
    The crn of the LB resource
    Status string
    (String) The status of load balancer listener.
    Timeouts IsLbListenerTimeoutsArgs
    acceptProxyProtocol Boolean
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    certificateInstance String

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    connectionLimit Double
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    defaultPool String

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    httpsRedirect IsLbListenerHttpsRedirect

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    httpsRedirectListener String
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    httpsRedirectStatusCode Double
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    httpsRedirectUri String

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    idleConnectionTimeout Double
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    isLbListenerId String
    (String) The unique identifier for this load balancer listener.
    lb String
    The load balancer unique identifier.
    listenerId String
    port Double

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    portMax Double

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    portMin Double

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    protocol String
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    relatedCrn String
    The crn of the LB resource
    status String
    (String) The status of load balancer listener.
    timeouts IsLbListenerTimeouts
    acceptProxyProtocol boolean
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    certificateInstance string

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    connectionLimit number
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    defaultPool string

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    httpsRedirect IsLbListenerHttpsRedirect

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    httpsRedirectListener string
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    httpsRedirectStatusCode number
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    httpsRedirectUri string

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    idleConnectionTimeout number
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    isLbListenerId string
    (String) The unique identifier for this load balancer listener.
    lb string
    The load balancer unique identifier.
    listenerId string
    port number

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    portMax number

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    portMin number

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    protocol string
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    relatedCrn string
    The crn of the LB resource
    status string
    (String) The status of load balancer listener.
    timeouts IsLbListenerTimeouts
    accept_proxy_protocol bool
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    certificate_instance str

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    connection_limit float
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    default_pool str

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    https_redirect IsLbListenerHttpsRedirectArgs

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    https_redirect_listener str
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    https_redirect_status_code float
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    https_redirect_uri str

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    idle_connection_timeout float
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    is_lb_listener_id str
    (String) The unique identifier for this load balancer listener.
    lb str
    The load balancer unique identifier.
    listener_id str
    port float

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    port_max float

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    port_min float

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    protocol str
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    related_crn str
    The crn of the LB resource
    status str
    (String) The status of load balancer listener.
    timeouts IsLbListenerTimeoutsArgs
    acceptProxyProtocol Boolean
    If set to true, listener forwards proxy protocol information that are supported by load balancers in the application family. Default value is false.
    certificateInstance String

    The CRN of the certificate instance, it is applicable(mandatory) only to https protocol.

    !> Removal Notification Certificate Manager support is removed, please use Secrets Manager.

    connectionLimit Number
    The connection limit of the listener. Valid range is 1 to 15000. Network load balancer do not support connection_limit argument.
    defaultPool String

    The load balancer pool unique identifier.

    The specified pool must • Belong to this load balancer • Have the same protocol as this listener, or have a compatible protocol. At present, the compatible protocols are http and https. • Not already be the default_pool for another listener

    httpsRedirect Property Map

    If present, the target listener that requests are redirected to. Removing https_redirect would update the load balancer listener and disable the https_redirect

    Nested schema for https_redirect:

    httpsRedirectListener String
    ID of the listener that will be set as http redirect target.

    Deprecated: Deprecated

    httpsRedirectStatusCode Number
    The HTTP status code to be returned in the redirect response, one of [301, 302, 303, 307, 308].

    Deprecated: Deprecated

    httpsRedirectUri String

    Target URI where traffic will be redirected.

    ~Note https_redirect_listener, https_redirect_status_code and https_redirect_uri are deprecated and will be removed in future. Please use https_redirect instead

    Deprecated: Deprecated

    idleConnectionTimeout Number
    The idle connection timeout of the listener in seconds. Supported for load balancers in the application family. Default value is 50, allowed value is between 50 - 7200.
    isLbListenerId String
    (String) The unique identifier for this load balancer listener.
    lb String
    The load balancer unique identifier.
    listenerId String
    port Number

    The listener port number. Valid range 1 to 65535.

    NOTE Private network load balancers with route_mode enabled don't support port, they support only one port range from port_min (1) - port_max (65535). Only accepted value of port for route_mode enabled private network load balancer is 1. Any other value will show change or update-in-place and returns an error.

    NOTE Either use port or (port_min-port_max) for public network load balancers

    portMax Number

    The inclusive upper bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 65535 is supported for port_max.

    portMin Number

    The inclusive lower bound of the range of ports used by this listener.

    NOTE Only load balancers in the network family support more than one port per listener. When route mode is enabled, only a value of 1 is supported for port_min.

    protocol String
    The listener protocol. Enumeration type are http, tcp, https and udp. Network load balancer supports only tcp and udp protocol.
    relatedCrn String
    The crn of the LB resource
    status String
    (String) The status of load balancer listener.
    timeouts Property Map

    Supporting Types

    IsLbListenerHttpsRedirect, IsLbListenerHttpsRedirectArgs

    HttpStatusCode double
    The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
    Listener IsLbListenerHttpsRedirectListener
    Nested schema for listener:
    Uri string
    The redirect relative target URI. Removing uri would update the load balancer listener and remove the uri from https_redirect
    HttpStatusCode float64
    The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
    Listener IsLbListenerHttpsRedirectListener
    Nested schema for listener:
    Uri string
    The redirect relative target URI. Removing uri would update the load balancer listener and remove the uri from https_redirect
    httpStatusCode Double
    The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
    listener IsLbListenerHttpsRedirectListener
    Nested schema for listener:
    uri String
    The redirect relative target URI. Removing uri would update the load balancer listener and remove the uri from https_redirect
    httpStatusCode number
    The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
    listener IsLbListenerHttpsRedirectListener
    Nested schema for listener:
    uri string
    The redirect relative target URI. Removing uri would update the load balancer listener and remove the uri from https_redirect
    http_status_code float
    The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
    listener IsLbListenerHttpsRedirectListener
    Nested schema for listener:
    uri str
    The redirect relative target URI. Removing uri would update the load balancer listener and remove the uri from https_redirect
    httpStatusCode Number
    The HTTP status code for this redirect. Allowable values are: 301, 302, 303, 307, 308.
    listener Property Map
    Nested schema for listener:
    uri String
    The redirect relative target URI. Removing uri would update the load balancer listener and remove the uri from https_redirect

    IsLbListenerHttpsRedirectListener, IsLbListenerHttpsRedirectListenerArgs

    Id string
    The unique identifier for this load balancer listener.
    Deleteds List<IsLbListenerHttpsRedirectListenerDeleted>
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    Href string
    (String) The listener's canonical URL.
    Id string
    The unique identifier for this load balancer listener.
    Deleteds []IsLbListenerHttpsRedirectListenerDeleted
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    Href string
    (String) The listener's canonical URL.
    id String
    The unique identifier for this load balancer listener.
    deleteds List<IsLbListenerHttpsRedirectListenerDeleted>
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    href String
    (String) The listener's canonical URL.
    id string
    The unique identifier for this load balancer listener.
    deleteds IsLbListenerHttpsRedirectListenerDeleted[]
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    href string
    (String) The listener's canonical URL.
    id str
    The unique identifier for this load balancer listener.
    deleteds Sequence[IsLbListenerHttpsRedirectListenerDeleted]
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    href str
    (String) The listener's canonical URL.
    id String
    The unique identifier for this load balancer listener.
    deleteds List<Property Map>
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    href String
    (String) The listener's canonical URL.

    IsLbListenerHttpsRedirectListenerDeleted, IsLbListenerHttpsRedirectListenerDeletedArgs

    MoreInfo string
    (String) Link to documentation about deleted resources.
    MoreInfo string
    (String) Link to documentation about deleted resources.
    moreInfo String
    (String) Link to documentation about deleted resources.
    moreInfo string
    (String) Link to documentation about deleted resources.
    more_info str
    (String) Link to documentation about deleted resources.
    moreInfo String
    (String) Link to documentation about deleted resources.

    IsLbListenerTimeouts, IsLbListenerTimeoutsArgs

    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

    The ibm_is_lb_listener resource can be imported by using the load balancer ID and listener ID.

    Syntax

    $ pulumi import ibm:index/isLbListener:IsLbListener example <loadbalancer_ID>/<listener_ID>

    Example

    $ pulumi import ibm:index/isLbListener:IsLbListener example d7bec597-4726-451f-8a63-e61212c32c/cea6651a-bc0a-4438-9f8a-44444f3ebb

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

    Package Details

    Repository
    ibm ibm-cloud/terraform-provider-ibm
    License
    Notes
    This Pulumi package is based on the ibm Terraform Provider.
    ibm logo
    ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud
    ibm-cloud/terraform-provider-ibm