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

ibm.IsLb

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 VPC Load Balancer. For more information, about VPC load balancer, see load balancers for VPC overview.

    Note: 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) {
    }
}

    {}

    Example Usage

    An example to create an application load balancer.

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

const example = new ibm.IsLb("example", {subnets: [
    ibm_is_subnet.example.id,
    ibm_is_subnet.example1.id,
]});

    import pulumi
import pulumi_ibm as ibm

example = ibm.IsLb("example", subnets=[
    ibm_is_subnet["example"]["id"],
    ibm_is_subnet["example1"]["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 {
		_, err := ibm.NewIsLb(ctx, "example", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				ibm_is_subnet.Example.Id,
				ibm_is_subnet.Example1.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 example = new Ibm.IsLb("example", new()
    {
        Subnets = new[]
        {
            ibm_is_subnet.Example.Id,
            ibm_is_subnet.Example1.Id,
        },
    });

});

    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 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 example = new IsLb("example", IsLbArgs.builder()
            .subnets(            
                ibm_is_subnet.example().id(),
                ibm_is_subnet.example1().id())
            .build());

    }
}

    resources:
  example:
    type: ibm:IsLb
    properties:
      subnets:
        - ${ibm_is_subnet.example.id}
        - ${ibm_is_subnet.example1.id}

    An example to create a network load balancer.

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

const example = new ibm.IsLb("example", {
    subnets: [ibm_is_subnet.example.id],
    profile: "network-fixed",
});

    import pulumi
import pulumi_ibm as ibm

example = ibm.IsLb("example",
    subnets=[ibm_is_subnet["example"]["id"]],
    profile="network-fixed")

    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 {
		_, err := ibm.NewIsLb(ctx, "example", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				ibm_is_subnet.Example.Id,
			},
			Profile: pulumi.String("network-fixed"),
		})
		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 example = new Ibm.IsLb("example", new()
    {
        Subnets = new[]
        {
            ibm_is_subnet.Example.Id,
        },
        Profile = "network-fixed",
    });

});

    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 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 example = new IsLb("example", IsLbArgs.builder()
            .subnets(ibm_is_subnet.example().id())
            .profile("network-fixed")
            .build());

    }
}

    resources:
  example:
    type: ibm:IsLb
    properties:
      subnets:
        - ${ibm_is_subnet.example.id}
      profile: network-fixed

    An example to create a load balancer with private DNS.

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

const example = new ibm.IsLb("example", {
    subnets: [ibm_is_subnet.example.id],
    profile: "network-fixed",
    dns: {
        instanceCrn: "crn:v1:staging:public:dns-svcs:global:a/exxxxxxxxxxxxx-xxxxxxxxxxxxxxxxx:5xxxxxxx-xxxxx-xxxxxxxxxxxxxxx-xxxxxxxxxxxxxxx::",
        zoneId: "bxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx",
    },
});

    import pulumi
import pulumi_ibm as ibm

example = ibm.IsLb("example",
    subnets=[ibm_is_subnet["example"]["id"]],
    profile="network-fixed",
    dns={
        "instance_crn": "crn:v1:staging:public:dns-svcs:global:a/exxxxxxxxxxxxx-xxxxxxxxxxxxxxxxx:5xxxxxxx-xxxxx-xxxxxxxxxxxxxxx-xxxxxxxxxxxxxxx::",
        "zone_id": "bxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx",
    })

    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 {
		_, err := ibm.NewIsLb(ctx, "example", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				ibm_is_subnet.Example.Id,
			},
			Profile: pulumi.String("network-fixed"),
			Dns: &ibm.IsLbDnsArgs{
				InstanceCrn: pulumi.String("crn:v1:staging:public:dns-svcs:global:a/exxxxxxxxxxxxx-xxxxxxxxxxxxxxxxx:5xxxxxxx-xxxxx-xxxxxxxxxxxxxxx-xxxxxxxxxxxxxxx::"),
				ZoneId:      pulumi.String("bxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx"),
			},
		})
		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 example = new Ibm.IsLb("example", new()
    {
        Subnets = new[]
        {
            ibm_is_subnet.Example.Id,
        },
        Profile = "network-fixed",
        Dns = new Ibm.Inputs.IsLbDnsArgs
        {
            InstanceCrn = "crn:v1:staging:public:dns-svcs:global:a/exxxxxxxxxxxxx-xxxxxxxxxxxxxxxxx:5xxxxxxx-xxxxx-xxxxxxxxxxxxxxx-xxxxxxxxxxxxxxx::",
            ZoneId = "bxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx",
        },
    });

});

    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.inputs.IsLbDnsArgs;
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 example = new IsLb("example", IsLbArgs.builder()
            .subnets(ibm_is_subnet.example().id())
            .profile("network-fixed")
            .dns(IsLbDnsArgs.builder()
                .instanceCrn("crn:v1:staging:public:dns-svcs:global:a/exxxxxxxxxxxxx-xxxxxxxxxxxxxxxxx:5xxxxxxx-xxxxx-xxxxxxxxxxxxxxx-xxxxxxxxxxxxxxx::")
                .zoneId("bxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx")
                .build())
            .build());

    }
}

    resources:
  example:
    type: ibm:IsLb
    properties:
      subnets:
        - ${ibm_is_subnet.example.id}
      profile: network-fixed
      dns:
        instanceCrn: 'crn:v1:staging:public:dns-svcs:global:a/exxxxxxxxxxxxx-xxxxxxxxxxxxxxxxx:5xxxxxxx-xxxxx-xxxxxxxxxxxxxxx-xxxxxxxxxxxxxxx::'
        zoneId: bxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx

    An example to create a private path load balancer.

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

const example = new ibm.IsLb("example", {
    subnets: [ibm_is_subnet.example.id],
    profile: "network-private-path",
    type: "private_path",
});

    import pulumi
import pulumi_ibm as ibm

example = ibm.IsLb("example",
    subnets=[ibm_is_subnet["example"]["id"]],
    profile="network-private-path",
    type="private_path")

    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 {
		_, err := ibm.NewIsLb(ctx, "example", &ibm.IsLbArgs{
			Subnets: pulumi.StringArray{
				ibm_is_subnet.Example.Id,
			},
			Profile: pulumi.String("network-private-path"),
			Type:    pulumi.String("private_path"),
		})
		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 example = new Ibm.IsLb("example", new()
    {
        Subnets = new[]
        {
            ibm_is_subnet.Example.Id,
        },
        Profile = "network-private-path",
        Type = "private_path",
    });

});

    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 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 example = new IsLb("example", IsLbArgs.builder()
            .subnets(ibm_is_subnet.example().id())
            .profile("network-private-path")
            .type("private_path")
            .build());

    }
}

    resources:
  example:
    type: ibm:IsLb
    properties:
      subnets:
        - ${ibm_is_subnet.example.id}
      profile: network-private-path
      type: private_path

    Create IsLb Resource

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

    Constructor syntax

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

@overload
def IsLb(resource_name: str,
         opts: Optional[ResourceOptions] = None,
         subnets: Optional[Sequence[str]] = None,
         logging: Optional[bool] = None,
         is_lb_id: Optional[str] = None,
         access_tags: Optional[Sequence[str]] = None,
         name: Optional[str] = None,
         profile: Optional[str] = None,
         resource_group: Optional[str] = None,
         route_mode: Optional[bool] = None,
         security_groups: Optional[Sequence[str]] = None,
         dns: Optional[IsLbDnsArgs] = None,
         tags: Optional[Sequence[str]] = None,
         timeouts: Optional[IsLbTimeoutsArgs] = None,
         type: Optional[str] = None)
    func NewIsLb(ctx *Context, name string, args IsLbArgs, opts ...ResourceOption) (*IsLb, error)
    public IsLb(string name, IsLbArgs args, CustomResourceOptions? opts = null)
    public IsLb(String name, IsLbArgs args)
public IsLb(String name, IsLbArgs args, CustomResourceOptions options)

    type: ibm:IsLb
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 IsLbArgs
    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 IsLbArgs
    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 IsLbArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IsLbArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IsLbArgs
    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 isLbResource = new Ibm.IsLb("isLbResource", new()
{
    Subnets = new[]
    {
        "string",
    },
    Logging = false,
    IsLbId = "string",
    AccessTags = new[]
    {
        "string",
    },
    Name = "string",
    Profile = "string",
    ResourceGroup = "string",
    RouteMode = false,
    SecurityGroups = new[]
    {
        "string",
    },
    Dns = new Ibm.Inputs.IsLbDnsArgs
    {
        InstanceCrn = "string",
        ZoneId = "string",
    },
    Tags = new[]
    {
        "string",
    },
    Timeouts = new Ibm.Inputs.IsLbTimeoutsArgs
    {
        Create = "string",
        Delete = "string",
        Update = "string",
    },
    Type = "string",
});

    example, err := ibm.NewIsLb(ctx, "isLbResource", &ibm.IsLbArgs{
	Subnets: pulumi.StringArray{
		pulumi.String("string"),
	},
	Logging: pulumi.Bool(false),
	IsLbId:  pulumi.String("string"),
	AccessTags: pulumi.StringArray{
		pulumi.String("string"),
	},
	Name:          pulumi.String("string"),
	Profile:       pulumi.String("string"),
	ResourceGroup: pulumi.String("string"),
	RouteMode:     pulumi.Bool(false),
	SecurityGroups: pulumi.StringArray{
		pulumi.String("string"),
	},
	Dns: &ibm.IsLbDnsArgs{
		InstanceCrn: pulumi.String("string"),
		ZoneId:      pulumi.String("string"),
	},
	Tags: pulumi.StringArray{
		pulumi.String("string"),
	},
	Timeouts: &ibm.IsLbTimeoutsArgs{
		Create: pulumi.String("string"),
		Delete: pulumi.String("string"),
		Update: pulumi.String("string"),
	},
	Type: pulumi.String("string"),
})

    var isLbResource = new IsLb("isLbResource", IsLbArgs.builder()
    .subnets("string")
    .logging(false)
    .isLbId("string")
    .accessTags("string")
    .name("string")
    .profile("string")
    .resourceGroup("string")
    .routeMode(false)
    .securityGroups("string")
    .dns(IsLbDnsArgs.builder()
        .instanceCrn("string")
        .zoneId("string")
        .build())
    .tags("string")
    .timeouts(IsLbTimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .update("string")
        .build())
    .type("string")
    .build());

    is_lb_resource = ibm.IsLb("isLbResource",
    subnets=["string"],
    logging=False,
    is_lb_id="string",
    access_tags=["string"],
    name="string",
    profile="string",
    resource_group="string",
    route_mode=False,
    security_groups=["string"],
    dns={
        "instance_crn": "string",
        "zone_id": "string",
    },
    tags=["string"],
    timeouts={
        "create": "string",
        "delete": "string",
        "update": "string",
    },
    type="string")

    const isLbResource = new ibm.IsLb("isLbResource", {
    subnets: ["string"],
    logging: false,
    isLbId: "string",
    accessTags: ["string"],
    name: "string",
    profile: "string",
    resourceGroup: "string",
    routeMode: false,
    securityGroups: ["string"],
    dns: {
        instanceCrn: "string",
        zoneId: "string",
    },
    tags: ["string"],
    timeouts: {
        create: "string",
        "delete": "string",
        update: "string",
    },
    type: "string",
});

    type: ibm:IsLb
properties:
    accessTags:
        - string
    dns:
        instanceCrn: string
        zoneId: string
    isLbId: string
    logging: false
    name: string
    profile: string
    resourceGroup: string
    routeMode: false
    securityGroups:
        - string
    subnets:
        - string
    tags:
        - string
    timeouts:
        create: string
        delete: string
        update: string
    type: string

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

    Subnets List<string>

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    AccessTags List<string>

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    Dns IsLbDns

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    IsLbId string
    (String) The unique identifier of the load balancer.
    Logging bool
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    Name string
    The name of the VPC load balancer.
    Profile string
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    ResourceGroup string
    The resource group where the load balancer to be created.
    RouteMode bool

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    SecurityGroups List<string>
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    Tags List<string>
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    Timeouts IsLbTimeouts
    Type string
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    Subnets []string

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    AccessTags []string

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    Dns IsLbDnsArgs

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    IsLbId string
    (String) The unique identifier of the load balancer.
    Logging bool
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    Name string
    The name of the VPC load balancer.
    Profile string
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    ResourceGroup string
    The resource group where the load balancer to be created.
    RouteMode bool

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    SecurityGroups []string
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    Tags []string
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    Timeouts IsLbTimeoutsArgs
    Type string
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    subnets List<String>

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    accessTags List<String>

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    dns IsLbDns

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    isLbId String
    (String) The unique identifier of the load balancer.
    logging Boolean
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    name String
    The name of the VPC load balancer.
    profile String
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    resourceGroup String
    The resource group where the load balancer to be created.
    routeMode Boolean

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    securityGroups List<String>
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    tags List<String>
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    timeouts IsLbTimeouts
    type String
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    subnets string[]

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    accessTags string[]

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    dns IsLbDns

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    isLbId string
    (String) The unique identifier of the load balancer.
    logging boolean
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    name string
    The name of the VPC load balancer.
    profile string
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    resourceGroup string
    The resource group where the load balancer to be created.
    routeMode boolean

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    securityGroups string[]
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    tags string[]
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    timeouts IsLbTimeouts
    type string
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    subnets Sequence[str]

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    access_tags Sequence[str]

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    dns IsLbDnsArgs

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    is_lb_id str
    (String) The unique identifier of the load balancer.
    logging bool
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    name str
    The name of the VPC load balancer.
    profile str
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    resource_group str
    The resource group where the load balancer to be created.
    route_mode bool

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    security_groups Sequence[str]
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    tags Sequence[str]
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    timeouts IsLbTimeoutsArgs
    type str
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    subnets List<String>

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    accessTags List<String>

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    dns Property Map

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    isLbId String
    (String) The unique identifier of the load balancer.
    logging Boolean
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    name String
    The name of the VPC load balancer.
    profile String
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    resourceGroup String
    The resource group where the load balancer to be created.
    routeMode Boolean

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    securityGroups List<String>
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    tags List<String>
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    timeouts Property Map
    type String
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.

    Outputs

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

    AccessMode string
    (String) The access mode for this load balancer. One of private, public, private_path.
    AttachedLoadBalancerPoolMembers List<IsLbAttachedLoadBalancerPoolMember>
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    Availability string
    (String) The availability of this load balancer
    Crn string
    (String) The CRN for this load balancer.
    FailsafePolicyActions List<string>
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    Hostname string
    (String) The fully qualified domain name assigned to this load balancer.
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceGroupsSupported bool
    (Boolean) Indicates whether this load balancer supports instance groups.
    OperatingStatus string
    (String) The operating status of this load balancer.
    PrivateIp List<IsLbPrivateIp>
    (List) The Reserved IP address reference assigned to this load balancer.
    PrivateIps List<string>
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    PublicIps List<string>
    (String) The public IP addresses assigned to this load balancer.
    ResourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    ResourceGroupName string
    The resource group name in which resource is provisioned
    ResourceName string
    The name of the resource
    SecurityGroupSupported bool
    Security Group Supported for this Load Balancer
    SourceIpSessionPersistenceSupported bool
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    Status string
    (String) The status of the load balancer.
    UdpSupported bool
    (Bool) Indicates whether this load balancer supports UDP.
    Version string
    AccessMode string
    (String) The access mode for this load balancer. One of private, public, private_path.
    AttachedLoadBalancerPoolMembers []IsLbAttachedLoadBalancerPoolMember
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    Availability string
    (String) The availability of this load balancer
    Crn string
    (String) The CRN for this load balancer.
    FailsafePolicyActions []string
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    Hostname string
    (String) The fully qualified domain name assigned to this load balancer.
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceGroupsSupported bool
    (Boolean) Indicates whether this load balancer supports instance groups.
    OperatingStatus string
    (String) The operating status of this load balancer.
    PrivateIp []IsLbPrivateIp
    (List) The Reserved IP address reference assigned to this load balancer.
    PrivateIps []string
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    PublicIps []string
    (String) The public IP addresses assigned to this load balancer.
    ResourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    ResourceGroupName string
    The resource group name in which resource is provisioned
    ResourceName string
    The name of the resource
    SecurityGroupSupported bool
    Security Group Supported for this Load Balancer
    SourceIpSessionPersistenceSupported bool
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    Status string
    (String) The status of the load balancer.
    UdpSupported bool
    (Bool) Indicates whether this load balancer supports UDP.
    Version string
    accessMode String
    (String) The access mode for this load balancer. One of private, public, private_path.
    attachedLoadBalancerPoolMembers List<IsLbAttachedLoadBalancerPoolMember>
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    availability String
    (String) The availability of this load balancer
    crn String
    (String) The CRN for this load balancer.
    failsafePolicyActions List<String>
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    hostname String
    (String) The fully qualified domain name assigned to this load balancer.
    id String
    The provider-assigned unique ID for this managed resource.
    instanceGroupsSupported Boolean
    (Boolean) Indicates whether this load balancer supports instance groups.
    operatingStatus String
    (String) The operating status of this load balancer.
    privateIp List<IsLbPrivateIp>
    (List) The Reserved IP address reference assigned to this load balancer.
    privateIps List<String>
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    publicIps List<String>
    (String) The public IP addresses assigned to this load balancer.
    resourceControllerUrl String
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceGroupName String
    The resource group name in which resource is provisioned
    resourceName String
    The name of the resource
    securityGroupSupported Boolean
    Security Group Supported for this Load Balancer
    sourceIpSessionPersistenceSupported Boolean
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    status String
    (String) The status of the load balancer.
    udpSupported Boolean
    (Bool) Indicates whether this load balancer supports UDP.
    version String
    accessMode string
    (String) The access mode for this load balancer. One of private, public, private_path.
    attachedLoadBalancerPoolMembers IsLbAttachedLoadBalancerPoolMember[]
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    availability string
    (String) The availability of this load balancer
    crn string
    (String) The CRN for this load balancer.
    failsafePolicyActions string[]
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    hostname string
    (String) The fully qualified domain name assigned to this load balancer.
    id string
    The provider-assigned unique ID for this managed resource.
    instanceGroupsSupported boolean
    (Boolean) Indicates whether this load balancer supports instance groups.
    operatingStatus string
    (String) The operating status of this load balancer.
    privateIp IsLbPrivateIp[]
    (List) The Reserved IP address reference assigned to this load balancer.
    privateIps string[]
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    publicIps string[]
    (String) The public IP addresses assigned to this load balancer.
    resourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceGroupName string
    The resource group name in which resource is provisioned
    resourceName string
    The name of the resource
    securityGroupSupported boolean
    Security Group Supported for this Load Balancer
    sourceIpSessionPersistenceSupported boolean
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    status string
    (String) The status of the load balancer.
    udpSupported boolean
    (Bool) Indicates whether this load balancer supports UDP.
    version string
    access_mode str
    (String) The access mode for this load balancer. One of private, public, private_path.
    attached_load_balancer_pool_members Sequence[IsLbAttachedLoadBalancerPoolMember]
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    availability str
    (String) The availability of this load balancer
    crn str
    (String) The CRN for this load balancer.
    failsafe_policy_actions Sequence[str]
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    hostname str
    (String) The fully qualified domain name assigned to this load balancer.
    id str
    The provider-assigned unique ID for this managed resource.
    instance_groups_supported bool
    (Boolean) Indicates whether this load balancer supports instance groups.
    operating_status str
    (String) The operating status of this load balancer.
    private_ip Sequence[IsLbPrivateIp]
    (List) The Reserved IP address reference assigned to this load balancer.
    private_ips Sequence[str]
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    public_ips Sequence[str]
    (String) The public IP addresses assigned to this load balancer.
    resource_controller_url str
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resource_group_name str
    The resource group name in which resource is provisioned
    resource_name str
    The name of the resource
    security_group_supported bool
    Security Group Supported for this Load Balancer
    source_ip_session_persistence_supported bool
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    status str
    (String) The status of the load balancer.
    udp_supported bool
    (Bool) Indicates whether this load balancer supports UDP.
    version str
    accessMode String
    (String) The access mode for this load balancer. One of private, public, private_path.
    attachedLoadBalancerPoolMembers List<Property Map>
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    availability String
    (String) The availability of this load balancer
    crn String
    (String) The CRN for this load balancer.
    failsafePolicyActions List<String>
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    hostname String
    (String) The fully qualified domain name assigned to this load balancer.
    id String
    The provider-assigned unique ID for this managed resource.
    instanceGroupsSupported Boolean
    (Boolean) Indicates whether this load balancer supports instance groups.
    operatingStatus String
    (String) The operating status of this load balancer.
    privateIp List<Property Map>
    (List) The Reserved IP address reference assigned to this load balancer.
    privateIps List<String>
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    publicIps List<String>
    (String) The public IP addresses assigned to this load balancer.
    resourceControllerUrl String
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceGroupName String
    The resource group name in which resource is provisioned
    resourceName String
    The name of the resource
    securityGroupSupported Boolean
    Security Group Supported for this Load Balancer
    sourceIpSessionPersistenceSupported Boolean
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    status String
    (String) The status of the load balancer.
    udpSupported Boolean
    (Bool) Indicates whether this load balancer supports UDP.
    version String

    Look up Existing IsLb Resource

    Get an existing IsLb 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?: IsLbState, opts?: CustomResourceOptions): IsLb
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        access_mode: Optional[str] = None,
        access_tags: Optional[Sequence[str]] = None,
        attached_load_balancer_pool_members: Optional[Sequence[IsLbAttachedLoadBalancerPoolMemberArgs]] = None,
        availability: Optional[str] = None,
        crn: Optional[str] = None,
        dns: Optional[IsLbDnsArgs] = None,
        failsafe_policy_actions: Optional[Sequence[str]] = None,
        hostname: Optional[str] = None,
        instance_groups_supported: Optional[bool] = None,
        is_lb_id: Optional[str] = None,
        logging: Optional[bool] = None,
        name: Optional[str] = None,
        operating_status: Optional[str] = None,
        private_ip: Optional[Sequence[IsLbPrivateIpArgs]] = None,
        private_ips: Optional[Sequence[str]] = None,
        profile: Optional[str] = None,
        public_ips: Optional[Sequence[str]] = None,
        resource_controller_url: Optional[str] = None,
        resource_group: Optional[str] = None,
        resource_group_name: Optional[str] = None,
        resource_name: Optional[str] = None,
        route_mode: Optional[bool] = None,
        security_group_supported: Optional[bool] = None,
        security_groups: Optional[Sequence[str]] = None,
        source_ip_session_persistence_supported: Optional[bool] = None,
        status: Optional[str] = None,
        subnets: Optional[Sequence[str]] = None,
        tags: Optional[Sequence[str]] = None,
        timeouts: Optional[IsLbTimeoutsArgs] = None,
        type: Optional[str] = None,
        udp_supported: Optional[bool] = None,
        version: Optional[str] = None) -> IsLb
    func GetIsLb(ctx *Context, name string, id IDInput, state *IsLbState, opts ...ResourceOption) (*IsLb, error)
    public static IsLb Get(string name, Input<string> id, IsLbState? state, CustomResourceOptions? opts = null)
    public static IsLb get(String name, Output<String> id, IsLbState state, CustomResourceOptions options)
    resources:  _:    type: ibm:IsLb    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:
    AccessMode string
    (String) The access mode for this load balancer. One of private, public, private_path.
    AccessTags List<string>

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    AttachedLoadBalancerPoolMembers List<IsLbAttachedLoadBalancerPoolMember>
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    Availability string
    (String) The availability of this load balancer
    Crn string
    (String) The CRN for this load balancer.
    Dns IsLbDns

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    FailsafePolicyActions List<string>
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    Hostname string
    (String) The fully qualified domain name assigned to this load balancer.
    InstanceGroupsSupported bool
    (Boolean) Indicates whether this load balancer supports instance groups.
    IsLbId string
    (String) The unique identifier of the load balancer.
    Logging bool
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    Name string
    The name of the VPC load balancer.
    OperatingStatus string
    (String) The operating status of this load balancer.
    PrivateIp List<IsLbPrivateIp>
    (List) The Reserved IP address reference assigned to this load balancer.
    PrivateIps List<string>
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    Profile string
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    PublicIps List<string>
    (String) The public IP addresses assigned to this load balancer.
    ResourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    ResourceGroup string
    The resource group where the load balancer to be created.
    ResourceGroupName string
    The resource group name in which resource is provisioned
    ResourceName string
    The name of the resource
    RouteMode bool

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    SecurityGroupSupported bool
    Security Group Supported for this Load Balancer
    SecurityGroups List<string>
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    SourceIpSessionPersistenceSupported bool
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    Status string
    (String) The status of the load balancer.
    Subnets List<string>

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    Tags List<string>
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    Timeouts IsLbTimeouts
    Type string
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    UdpSupported bool
    (Bool) Indicates whether this load balancer supports UDP.
    Version string
    AccessMode string
    (String) The access mode for this load balancer. One of private, public, private_path.
    AccessTags []string

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    AttachedLoadBalancerPoolMembers []IsLbAttachedLoadBalancerPoolMemberArgs
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    Availability string
    (String) The availability of this load balancer
    Crn string
    (String) The CRN for this load balancer.
    Dns IsLbDnsArgs

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    FailsafePolicyActions []string
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    Hostname string
    (String) The fully qualified domain name assigned to this load balancer.
    InstanceGroupsSupported bool
    (Boolean) Indicates whether this load balancer supports instance groups.
    IsLbId string
    (String) The unique identifier of the load balancer.
    Logging bool
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    Name string
    The name of the VPC load balancer.
    OperatingStatus string
    (String) The operating status of this load balancer.
    PrivateIp []IsLbPrivateIpArgs
    (List) The Reserved IP address reference assigned to this load balancer.
    PrivateIps []string
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    Profile string
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    PublicIps []string
    (String) The public IP addresses assigned to this load balancer.
    ResourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    ResourceGroup string
    The resource group where the load balancer to be created.
    ResourceGroupName string
    The resource group name in which resource is provisioned
    ResourceName string
    The name of the resource
    RouteMode bool

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    SecurityGroupSupported bool
    Security Group Supported for this Load Balancer
    SecurityGroups []string
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    SourceIpSessionPersistenceSupported bool
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    Status string
    (String) The status of the load balancer.
    Subnets []string

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    Tags []string
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    Timeouts IsLbTimeoutsArgs
    Type string
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    UdpSupported bool
    (Bool) Indicates whether this load balancer supports UDP.
    Version string
    accessMode String
    (String) The access mode for this load balancer. One of private, public, private_path.
    accessTags List<String>

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    attachedLoadBalancerPoolMembers List<IsLbAttachedLoadBalancerPoolMember>
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    availability String
    (String) The availability of this load balancer
    crn String
    (String) The CRN for this load balancer.
    dns IsLbDns

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    failsafePolicyActions List<String>
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    hostname String
    (String) The fully qualified domain name assigned to this load balancer.
    instanceGroupsSupported Boolean
    (Boolean) Indicates whether this load balancer supports instance groups.
    isLbId String
    (String) The unique identifier of the load balancer.
    logging Boolean
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    name String
    The name of the VPC load balancer.
    operatingStatus String
    (String) The operating status of this load balancer.
    privateIp List<IsLbPrivateIp>
    (List) The Reserved IP address reference assigned to this load balancer.
    privateIps List<String>
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    profile String
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    publicIps List<String>
    (String) The public IP addresses assigned to this load balancer.
    resourceControllerUrl String
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceGroup String
    The resource group where the load balancer to be created.
    resourceGroupName String
    The resource group name in which resource is provisioned
    resourceName String
    The name of the resource
    routeMode Boolean

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    securityGroupSupported Boolean
    Security Group Supported for this Load Balancer
    securityGroups List<String>
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    sourceIpSessionPersistenceSupported Boolean
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    status String
    (String) The status of the load balancer.
    subnets List<String>

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    tags List<String>
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    timeouts IsLbTimeouts
    type String
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    udpSupported Boolean
    (Bool) Indicates whether this load balancer supports UDP.
    version String
    accessMode string
    (String) The access mode for this load balancer. One of private, public, private_path.
    accessTags string[]

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    attachedLoadBalancerPoolMembers IsLbAttachedLoadBalancerPoolMember[]
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    availability string
    (String) The availability of this load balancer
    crn string
    (String) The CRN for this load balancer.
    dns IsLbDns

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    failsafePolicyActions string[]
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    hostname string
    (String) The fully qualified domain name assigned to this load balancer.
    instanceGroupsSupported boolean
    (Boolean) Indicates whether this load balancer supports instance groups.
    isLbId string
    (String) The unique identifier of the load balancer.
    logging boolean
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    name string
    The name of the VPC load balancer.
    operatingStatus string
    (String) The operating status of this load balancer.
    privateIp IsLbPrivateIp[]
    (List) The Reserved IP address reference assigned to this load balancer.
    privateIps string[]
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    profile string
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    publicIps string[]
    (String) The public IP addresses assigned to this load balancer.
    resourceControllerUrl string
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceGroup string
    The resource group where the load balancer to be created.
    resourceGroupName string
    The resource group name in which resource is provisioned
    resourceName string
    The name of the resource
    routeMode boolean

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    securityGroupSupported boolean
    Security Group Supported for this Load Balancer
    securityGroups string[]
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    sourceIpSessionPersistenceSupported boolean
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    status string
    (String) The status of the load balancer.
    subnets string[]

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    tags string[]
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    timeouts IsLbTimeouts
    type string
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    udpSupported boolean
    (Bool) Indicates whether this load balancer supports UDP.
    version string
    access_mode str
    (String) The access mode for this load balancer. One of private, public, private_path.
    access_tags Sequence[str]

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    attached_load_balancer_pool_members Sequence[IsLbAttachedLoadBalancerPoolMemberArgs]
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    availability str
    (String) The availability of this load balancer
    crn str
    (String) The CRN for this load balancer.
    dns IsLbDnsArgs

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    failsafe_policy_actions Sequence[str]
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    hostname str
    (String) The fully qualified domain name assigned to this load balancer.
    instance_groups_supported bool
    (Boolean) Indicates whether this load balancer supports instance groups.
    is_lb_id str
    (String) The unique identifier of the load balancer.
    logging bool
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    name str
    The name of the VPC load balancer.
    operating_status str
    (String) The operating status of this load balancer.
    private_ip Sequence[IsLbPrivateIpArgs]
    (List) The Reserved IP address reference assigned to this load balancer.
    private_ips Sequence[str]
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    profile str
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    public_ips Sequence[str]
    (String) The public IP addresses assigned to this load balancer.
    resource_controller_url str
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resource_group str
    The resource group where the load balancer to be created.
    resource_group_name str
    The resource group name in which resource is provisioned
    resource_name str
    The name of the resource
    route_mode bool

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    security_group_supported bool
    Security Group Supported for this Load Balancer
    security_groups Sequence[str]
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    source_ip_session_persistence_supported bool
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    status str
    (String) The status of the load balancer.
    subnets Sequence[str]

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    tags Sequence[str]
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    timeouts IsLbTimeoutsArgs
    type str
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    udp_supported bool
    (Bool) Indicates whether this load balancer supports UDP.
    version str
    accessMode String
    (String) The access mode for this load balancer. One of private, public, private_path.
    accessTags List<String>

    A list of access management tags to attach to the load balancer.

    Note: • You can attach only those access tags that already exists. • For more information, about creating access tags, see working with tags. • You must have the access listed in the Granting users access to tag resources for access_tags • access_tags must be in the format key:value.

    attachedLoadBalancerPoolMembers List<Property Map>
    (List) The load balancer pool members attached to this load balancer. Nested scheme for members:
    availability String
    (String) The availability of this load balancer
    crn String
    (String) The CRN for this load balancer.
    dns Property Map

    The DNS configuration for this load balancer.

    Nested scheme for dns:

    failsafePolicyActions List<String>
    The supported failsafe_policy.action values for this load balancer's pools. Allowable list items are: fail, forward.
    hostname String
    (String) The fully qualified domain name assigned to this load balancer.
    instanceGroupsSupported Boolean
    (Boolean) Indicates whether this load balancer supports instance groups.
    isLbId String
    (String) The unique identifier of the load balancer.
    logging Boolean
    Enable or disable datapath logging for the load balancer. This is applicable only for application load balancer. Supported values are true or false. Default value is false.
    name String
    The name of the VPC load balancer.
    operatingStatus String
    (String) The operating status of this load balancer.
    privateIp List<Property Map>
    (List) The Reserved IP address reference assigned to this load balancer.
    privateIps List<String>
    (String) The private IP addresses (Reserved IP address reference) assigned to this load balancer.
    profile String
    For a Network Load Balancer, this attribute is required for network and private path load balancers. Should be set to network-private-path for private path load balancers and network-fixed for a network load balancer. For Application Load Balancer, profile is not a required attribute.
    publicIps List<String>
    (String) The public IP addresses assigned to this load balancer.
    resourceControllerUrl String
    The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
    resourceGroup String
    The resource group where the load balancer to be created.
    resourceGroupName String
    The resource group name in which resource is provisioned
    resourceName String
    The name of the resource
    routeMode Boolean

    Indicates whether route mode is enabled for this load balancer.

    NOTE: Currently, route_mode enabled is supported only by private network load balancers.

    securityGroupSupported Boolean
    Security Group Supported for this Load Balancer
    securityGroups List<String>
    A list of security groups to use for this load balancer. This option is supported for both application and network load balancers.
    sourceIpSessionPersistenceSupported Boolean
    (Boolean) Indicates whether this load balancer supports source IP session persistence.
    status String
    (String) The status of the load balancer.
    subnets List<String>

    List of the subnets IDs to connect to the load balancer.

    NOTE: The subnets must be in the same VPC. The load balancer's availability will depend on the availability of the zones the specified subnets reside in. The load balancer must be in the application family for updating subnets. Load balancers in the network family allow only one subnet to be specified.

    tags List<String>
    A list of tags that you want to add to your load balancer. Tags can help you find the load balancer more easily later.
    timeouts Property Map
    type String
    The type of the load balancer. Default value is public. Supported values are public, private and private_path.
    udpSupported Boolean
    (Bool) Indicates whether this load balancer supports UDP.
    version String

    Supporting Types

    IsLbAttachedLoadBalancerPoolMember, IsLbAttachedLoadBalancerPoolMemberArgs

    Deleteds List<IsLbAttachedLoadBalancerPoolMemberDeleted>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested scheme for deleted:
    Href string
    (String) The URL for this reserved ip
    Id string
    (String) The unique identifier of the load balancer.
    Deleteds []IsLbAttachedLoadBalancerPoolMemberDeleted
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested scheme for deleted:
    Href string
    (String) The URL for this reserved ip
    Id string
    (String) The unique identifier of the load balancer.
    deleteds List<IsLbAttachedLoadBalancerPoolMemberDeleted>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested scheme for deleted:
    href String
    (String) The URL for this reserved ip
    id String
    (String) The unique identifier of the load balancer.
    deleteds IsLbAttachedLoadBalancerPoolMemberDeleted[]
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested scheme for deleted:
    href string
    (String) The URL for this reserved ip
    id string
    (String) The unique identifier of the load balancer.
    deleteds Sequence[IsLbAttachedLoadBalancerPoolMemberDeleted]
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested scheme for deleted:
    href str
    (String) The URL for this reserved ip
    id str
    (String) The unique identifier of the load balancer.
    deleteds List<Property Map>
    (List) If present, this property indicates the referenced resource has been deleted and providessome supplementary information. Nested scheme for deleted:
    href String
    (String) The URL for this reserved ip
    id String
    (String) The unique identifier of the load balancer.

    IsLbAttachedLoadBalancerPoolMemberDeleted, IsLbAttachedLoadBalancerPoolMemberDeletedArgs

    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.

    IsLbDns, IsLbDnsArgs

    InstanceCrn string
    The CRN of the DNS instance associated with the DNS zone
    ZoneId string
    The unique identifier of the DNS zone.
    InstanceCrn string
    The CRN of the DNS instance associated with the DNS zone
    ZoneId string
    The unique identifier of the DNS zone.
    instanceCrn String
    The CRN of the DNS instance associated with the DNS zone
    zoneId String
    The unique identifier of the DNS zone.
    instanceCrn string
    The CRN of the DNS instance associated with the DNS zone
    zoneId string
    The unique identifier of the DNS zone.
    instance_crn str
    The CRN of the DNS instance associated with the DNS zone
    zone_id str
    The unique identifier of the DNS zone.
    instanceCrn String
    The CRN of the DNS instance associated with the DNS zone
    zoneId String
    The unique identifier of the DNS zone.

    IsLbPrivateIp, IsLbPrivateIpArgs

    Address string
    (String) IPv4 The IP address. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    Href string
    (String) The URL for this reserved ip
    Name string
    The name of the VPC load balancer.
    ReservedIp string
    (String) The unique identifier for this reserved IP.
    ResourceType string
    Address string
    (String) IPv4 The IP address. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    Href string
    (String) The URL for this reserved ip
    Name string
    The name of the VPC load balancer.
    ReservedIp string
    (String) The unique identifier for this reserved IP.
    ResourceType string
    address String
    (String) IPv4 The IP address. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    href String
    (String) The URL for this reserved ip
    name String
    The name of the VPC load balancer.
    reservedIp String
    (String) The unique identifier for this reserved IP.
    resourceType String
    address string
    (String) IPv4 The IP address. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    href string
    (String) The URL for this reserved ip
    name string
    The name of the VPC load balancer.
    reservedIp string
    (String) The unique identifier for this reserved IP.
    resourceType string
    address str
    (String) IPv4 The IP address. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    href str
    (String) The URL for this reserved ip
    name str
    The name of the VPC load balancer.
    reserved_ip str
    (String) The unique identifier for this reserved IP.
    resource_type str
    address String
    (String) IPv4 The IP address. This property may add support for IPv6 addresses in the future. When processing a value in this property, verify that the address is in an expected format. If it is not, log an error. Optionally halt processing and surface the error, or bypass the resource on which the unexpected IP address format was encountered.
    href String
    (String) The URL for this reserved ip
    name String
    The name of the VPC load balancer.
    reservedIp String
    (String) The unique identifier for this reserved IP.
    resourceType String

    IsLbTimeouts, IsLbTimeoutsArgs

    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 resource can be imported by using the load balancer ID.

    Syntax

    $ pulumi import ibm:index/isLb:IsLb example <lb_ID>

    Example

    $ terraform import ibm_is_lb.example d7bec597-4726-451f-8a63-e62e6f133332c

    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