Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. Linode Provider
  4. API Docs
  5. NodeBalancer
Viewing docs for Linode v6.7.0
published on Wednesday, Sep 30, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-linode

linode.NodeBalancer

linode logo linode logo
Viewing docs for Linode v6.7.0
published on Wednesday, Sep 30, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-linode

    Provides a Linode NodeBalancer resource. This can be used to create, modify, and delete Linodes NodeBalancers in Linode’s managed load balancer service. For more information, see Getting Started with NodeBalancers and the Linode APIv4 docs.

    Example Usage

    The following example shows how one might use this resource to configure a NodeBalancer.

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

const foobar = new linode.NodeBalancer("foobar", {
    label: "mynodebalancer",
    region: "us-east",
    clientConnThrottle: 20,
    clientUdpSessThrottle: 10,
    tags: ["foobar"],
});

    import pulumi
import pulumi_linode as linode

foobar = linode.NodeBalancer("foobar",
    label="mynodebalancer",
    region="us-east",
    client_conn_throttle=20,
    client_udp_sess_throttle=10,
    tags=["foobar"])

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := linode.NewNodeBalancer(ctx, "foobar", &linode.NodeBalancerArgs{
			Label:                 pulumi.String("mynodebalancer"),
			Region:                pulumi.String("us-east"),
			ClientConnThrottle:    pulumi.Int(20),
			ClientUdpSessThrottle: pulumi.Int(10),
			Tags: pulumi.StringArray{
				pulumi.String("foobar"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var foobar = new Linode.NodeBalancer("foobar", new()
    {
        Label = "mynodebalancer",
        Region = "us-east",
        ClientConnThrottle = 20,
        ClientUdpSessThrottle = 10,
        Tags = new[]
        {
            "foobar",
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.NodeBalancer;
import com.pulumi.linode.NodeBalancerArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        var foobar = new NodeBalancer("foobar", NodeBalancerArgs.builder()
            .label("mynodebalancer")
            .region("us-east")
            .clientConnThrottle(20)
            .clientUdpSessThrottle(10)
            .tags("foobar")
            .build());

    }
}

    resources:
  foobar:
    type: linode:NodeBalancer
    properties:
      label: mynodebalancer
      region: us-east
      clientConnThrottle: 20
      clientUdpSessThrottle: 10
      tags:
        - foobar

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

resource "linode_nodebalancer" "foobar" {
  label                    = "mynodebalancer"
  region                   = "us-east"
  client_conn_throttle     = 20
  client_udp_sess_throttle = 10
  tags                     = ["foobar"]
}

    The following example shows how one might use this resource to configure a NodeBalancer attached to a VPC.

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

// NOTE: VPC-attached NodeBalancers may not currently be available to all users.
const foobar = new linode.NodeBalancer("foobar", {
    label: "mynodebalancer",
    region: "us-mia",
    vpcs: [{
        subnetId: Number(test.id),
    }],
});

    import pulumi
import pulumi_linode as linode

# NOTE: VPC-attached NodeBalancers may not currently be available to all users.
foobar = linode.NodeBalancer("foobar",
    label="mynodebalancer",
    region="us-mia",
    vpcs=[{
        "subnet_id": int(test["id"]),
    }])

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// NOTE: VPC-attached NodeBalancers may not currently be available to all users.
		_, err := linode.NewNodeBalancer(ctx, "foobar", &linode.NodeBalancerArgs{
			Label:  pulumi.String("mynodebalancer"),
			Region: pulumi.String("us-mia"),
			Vpcs: linode.NodeBalancerVpcArray{
				&linode.NodeBalancerVpcArgs{
					SubnetId: pulumi.Any(test.Id),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    // NOTE: VPC-attached NodeBalancers may not currently be available to all users.
    var foobar = new Linode.NodeBalancer("foobar", new()
    {
        Label = "mynodebalancer",
        Region = "us-mia",
        Vpcs = new[]
        {
            new Linode.Inputs.NodeBalancerVpcArgs
            {
                SubnetId = test.Id,
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.NodeBalancer;
import com.pulumi.linode.NodeBalancerArgs;
import com.pulumi.linode.inputs.NodeBalancerVpcArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        // NOTE: VPC-attached NodeBalancers may not currently be available to all users.
        var foobar = new NodeBalancer("foobar", NodeBalancerArgs.builder()
            .label("mynodebalancer")
            .region("us-mia")
            .vpcs(NodeBalancerVpcArgs.builder()
                .subnetId(test.id())
                .build())
            .build());

    }
}

    resources:
  # NOTE: VPC-attached NodeBalancers may not currently be available to all users.
  foobar:
    type: linode:NodeBalancer
    properties:
      label: mynodebalancer
      region: us-mia
      vpcs:
        - subnetId: ${test.id}

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

# NOTE: VPC-attached NodeBalancers may not currently be available to all users.
resource "linode_nodebalancer" "foobar" {
  label  = "mynodebalancer"
  region = "us-mia"
  vpcs {
    subnet_id = test.id
  }
}

    The following example shows how to create a NodeBalancer with a pre-reserved IPv4 address.

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

const myReservedIp = new linode.NetworkingIp("my_reserved_ip", {
    region: "us-east",
    type: "ipv4",
    "public": true,
    reserved: true,
});
const foobar = new linode.NodeBalancer("foobar", {
    label: "mynodebalancer",
    region: "us-east",
    ipv4: myReservedIp.address,
});

    import pulumi
import pulumi_linode as linode

my_reserved_ip = linode.NetworkingIp("my_reserved_ip",
    region="us-east",
    type="ipv4",
    public=True,
    reserved=True)
foobar = linode.NodeBalancer("foobar",
    label="mynodebalancer",
    region="us-east",
    ipv4=my_reserved_ip.address)

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		myReservedIp, err := linode.NewNetworkingIp(ctx, "my_reserved_ip", &linode.NetworkingIpArgs{
			Region:   pulumi.String("us-east"),
			Type:     pulumi.String("ipv4"),
			Public:   pulumi.Bool(true),
			Reserved: pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		_, err = linode.NewNodeBalancer(ctx, "foobar", &linode.NodeBalancerArgs{
			Label:  pulumi.String("mynodebalancer"),
			Region: pulumi.String("us-east"),
			Ipv4:   myReservedIp.Address,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var myReservedIp = new Linode.NetworkingIp("my_reserved_ip", new()
    {
        Region = "us-east",
        Type = "ipv4",
        Public = true,
        Reserved = true,
    });

    var foobar = new Linode.NodeBalancer("foobar", new()
    {
        Label = "mynodebalancer",
        Region = "us-east",
        Ipv4 = myReservedIp.Address,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.NetworkingIp;
import com.pulumi.linode.NetworkingIpArgs;
import com.pulumi.linode.NodeBalancer;
import com.pulumi.linode.NodeBalancerArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        var myReservedIp = new NetworkingIp("myReservedIp", NetworkingIpArgs.builder()
            .region("us-east")
            .type("ipv4")
            .public_(true)
            .reserved(true)
            .build());

        var foobar = new NodeBalancer("foobar", NodeBalancerArgs.builder()
            .label("mynodebalancer")
            .region("us-east")
            .ipv4(myReservedIp.address())
            .build());

    }
}

    resources:
  myReservedIp:
    type: linode:NetworkingIp
    name: my_reserved_ip
    properties:
      region: us-east
      type: ipv4
      public: true
      reserved: true
  foobar:
    type: linode:NodeBalancer
    properties:
      label: mynodebalancer
      region: us-east
      ipv4: ${myReservedIp.address}

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

resource "linode_networkingip" "my_reserved_ip" {
  region   = "us-east"
  type     = "ipv4"
  public   = true
  reserved = true
}
resource "linode_nodebalancer" "foobar" {
  label  = "mynodebalancer"
  region = "us-east"
  ipv4   = linode_networkingip.my_reserved_ip.address
}

    The following example requests a premium NodeBalancer that communicates with IPv6 backends. Backend connectivity requires the v4beta API version and may not be available to all accounts.

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

const ipv6 = new linode.NodeBalancer("ipv6", {
    label: "ipv6-backends",
    region: "us-east",
    type: "premium",
    backendConnectivity: "ipv6",
});

    import pulumi
import pulumi_linode as linode

ipv6 = linode.NodeBalancer("ipv6",
    label="ipv6-backends",
    region="us-east",
    type="premium",
    backend_connectivity="ipv6")

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := linode.NewNodeBalancer(ctx, "ipv6", &linode.NodeBalancerArgs{
			Label:               pulumi.String("ipv6-backends"),
			Region:              pulumi.String("us-east"),
			Type:                pulumi.String("premium"),
			BackendConnectivity: pulumi.String("ipv6"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var ipv6 = new Linode.NodeBalancer("ipv6", new()
    {
        Label = "ipv6-backends",
        Region = "us-east",
        Type = "premium",
        BackendConnectivity = "ipv6",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.NodeBalancer;
import com.pulumi.linode.NodeBalancerArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        var ipv6 = new NodeBalancer("ipv6", NodeBalancerArgs.builder()
            .label("ipv6-backends")
            .region("us-east")
            .type("premium")
            .backendConnectivity("ipv6")
            .build());

    }
}

    resources:
  ipv6:
    type: linode:NodeBalancer
    properties:
      label: ipv6-backends
      region: us-east
      type: premium
      backendConnectivity: ipv6

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

resource "linode_nodebalancer" "ipv6" {
  label                = "ipv6-backends"
  region               = "us-east"
  type                 = "premium"
  backend_connectivity = "ipv6"
}

    Create NodeBalancer Resource

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

    Constructor syntax

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

@overload
def NodeBalancer(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 backend_connectivity: Optional[str] = None,
                 client_conn_throttle: Optional[int] = None,
                 client_udp_sess_throttle: Optional[int] = None,
                 firewall_id: Optional[int] = None,
                 ipv4: Optional[str] = None,
                 label: Optional[str] = None,
                 region: Optional[str] = None,
                 tags: Optional[Sequence[str]] = None,
                 type: Optional[str] = None,
                 vpcs: Optional[Sequence[NodeBalancerVpcArgs]] = None)
    func NewNodeBalancer(ctx *Context, name string, args *NodeBalancerArgs, opts ...ResourceOption) (*NodeBalancer, error)
    public NodeBalancer(string name, NodeBalancerArgs? args = null, CustomResourceOptions? opts = null)
    public NodeBalancer(String name, NodeBalancerArgs args)
public NodeBalancer(String name, NodeBalancerArgs args, CustomResourceOptions options)

    type: linode:NodeBalancer
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "linode_node_balancer" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args NodeBalancerArgs
    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 NodeBalancerArgs
    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 NodeBalancerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args NodeBalancerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args NodeBalancerArgs
    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 nodeBalancerResource = new Linode.NodeBalancer("nodeBalancerResource", new()
{
    BackendConnectivity = "string",
    ClientConnThrottle = 0,
    ClientUdpSessThrottle = 0,
    FirewallId = 0,
    Ipv4 = "string",
    Label = "string",
    Region = "string",
    Tags = new[]
    {
        "string",
    },
    Type = "string",
    Vpcs = new[]
    {
        new Linode.Inputs.NodeBalancerVpcArgs
        {
            SubnetId = 0,
            Ipv4Range = "string",
            Ipv4RangeAutoAssign = false,
            Ipv6Range = "string",
        },
    },
});

    example, err := linode.NewNodeBalancer(ctx, "nodeBalancerResource", &linode.NodeBalancerArgs{
	BackendConnectivity:   pulumi.String("string"),
	ClientConnThrottle:    pulumi.Int(0),
	ClientUdpSessThrottle: pulumi.Int(0),
	FirewallId:            pulumi.Int(0),
	Ipv4:                  pulumi.String("string"),
	Label:                 pulumi.String("string"),
	Region:                pulumi.String("string"),
	Tags: pulumi.StringArray{
		pulumi.String("string"),
	},
	Type: pulumi.String("string"),
	Vpcs: linode.NodeBalancerVpcArray{
		&linode.NodeBalancerVpcArgs{
			SubnetId:            pulumi.Int(0),
			Ipv4Range:           pulumi.String("string"),
			Ipv4RangeAutoAssign: pulumi.Bool(false),
			Ipv6Range:           pulumi.String("string"),
		},
	},
})

    resource "linode_node_balancer" "nodeBalancerResource" {
  lifecycle {
    create_before_destroy = true
  }
  backend_connectivity     = "string"
  client_conn_throttle     = 0
  client_udp_sess_throttle = 0
  firewall_id              = 0
  ipv4                     = "string"
  label                    = "string"
  region                   = "string"
  tags                     = ["string"]
  type                     = "string"
  vpcs {
    subnet_id              = 0
    ipv4_range             = "string"
    ipv4_range_auto_assign = false
    ipv6_range             = "string"
  }
}

    var nodeBalancerResource = new NodeBalancer("nodeBalancerResource", NodeBalancerArgs.builder()
    .backendConnectivity("string")
    .clientConnThrottle(0)
    .clientUdpSessThrottle(0)
    .firewallId(0)
    .ipv4("string")
    .label("string")
    .region("string")
    .tags("string")
    .type("string")
    .vpcs(NodeBalancerVpcArgs.builder()
        .subnetId(0)
        .ipv4Range("string")
        .ipv4RangeAutoAssign(false)
        .ipv6Range("string")
        .build())
    .build());

    node_balancer_resource = linode.NodeBalancer("nodeBalancerResource",
    backend_connectivity="string",
    client_conn_throttle=0,
    client_udp_sess_throttle=0,
    firewall_id=0,
    ipv4="string",
    label="string",
    region="string",
    tags=["string"],
    type="string",
    vpcs=[{
        "subnet_id": 0,
        "ipv4_range": "string",
        "ipv4_range_auto_assign": False,
        "ipv6_range": "string",
    }])

    const nodeBalancerResource = new linode.NodeBalancer("nodeBalancerResource", {
    backendConnectivity: "string",
    clientConnThrottle: 0,
    clientUdpSessThrottle: 0,
    firewallId: 0,
    ipv4: "string",
    label: "string",
    region: "string",
    tags: ["string"],
    type: "string",
    vpcs: [{
        subnetId: 0,
        ipv4Range: "string",
        ipv4RangeAutoAssign: false,
        ipv6Range: "string",
    }],
});

    type: linode:NodeBalancer
properties:
    backendConnectivity: string
    clientConnThrottle: 0
    clientUdpSessThrottle: 0
    firewallId: 0
    ipv4: string
    label: string
    region: string
    tags:
        - string
    type: string
    vpcs:
        - ipv4Range: string
          ipv4RangeAutoAssign: false
          ipv6Range: string
          subnetId: 0

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

    BackendConnectivity string
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    ClientConnThrottle int
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    ClientUdpSessThrottle int
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    FirewallId int
    ID for the firewall you'd like to use with this NodeBalancer.
    Ipv4 string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    Label string
    The label of the Linode NodeBalancer
    Region string
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    Tags List<string>
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    Type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    Vpcs List<NodeBalancerVpc>
    A list of VPCs to be assigned to this NodeBalancer.
    BackendConnectivity string
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    ClientConnThrottle int
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    ClientUdpSessThrottle int
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    FirewallId int
    ID for the firewall you'd like to use with this NodeBalancer.
    Ipv4 string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    Label string
    The label of the Linode NodeBalancer
    Region string
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    Tags []string
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    Type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    Vpcs []NodeBalancerVpcArgs
    A list of VPCs to be assigned to this NodeBalancer.
    backend_connectivity string
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    client_conn_throttle number
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    client_udp_sess_throttle number
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    firewall_id number
    ID for the firewall you'd like to use with this NodeBalancer.
    ipv4 string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    label string
    The label of the Linode NodeBalancer
    region string
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags list(string)
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    vpcs list(object)
    A list of VPCs to be assigned to this NodeBalancer.
    backendConnectivity String
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    clientConnThrottle Integer
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    clientUdpSessThrottle Integer
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    firewallId Integer
    ID for the firewall you'd like to use with this NodeBalancer.
    ipv4 String
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    label String
    The label of the Linode NodeBalancer
    region String
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags List<String>
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    type String
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    vpcs List<NodeBalancerVpc>
    A list of VPCs to be assigned to this NodeBalancer.
    backendConnectivity string
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    clientConnThrottle number
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    clientUdpSessThrottle number
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    firewallId number
    ID for the firewall you'd like to use with this NodeBalancer.
    ipv4 string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    label string
    The label of the Linode NodeBalancer
    region string
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags string[]
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    vpcs NodeBalancerVpc[]
    A list of VPCs to be assigned to this NodeBalancer.
    backend_connectivity str
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    client_conn_throttle int
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    client_udp_sess_throttle int
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    firewall_id int
    ID for the firewall you'd like to use with this NodeBalancer.
    ipv4 str
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    label str
    The label of the Linode NodeBalancer
    region str
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags Sequence[str]
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    type str
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    vpcs Sequence[NodeBalancerVpcArgs]
    A list of VPCs to be assigned to this NodeBalancer.
    backendConnectivity String
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    clientConnThrottle Number
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    clientUdpSessThrottle Number
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    firewallId Number
    ID for the firewall you'd like to use with this NodeBalancer.
    ipv4 String
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    label String
    The label of the Linode NodeBalancer
    region String
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags List<String>
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    type String
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    vpcs List<Property Map>
    A list of VPCs to be assigned to this NodeBalancer.

    Outputs

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

    BackendIpv6Prefix string
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    Created string
    When this firewall was created.
    Firewalls List<NodeBalancerFirewall>
    A list of Firewalls assigned to this NodeBalancer.
    Hostname string
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    Id string
    The provider-assigned unique ID for this managed resource.
    Ipv6 string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    LkeClusters List<NodeBalancerLkeCluster>
    The related LKE cluster for this NodeBalancer, if any.
    Transfers List<NodeBalancerTransfer>
    Information about the amount of transfer this NodeBalancer has had so far this month.
    Updated string
    When this firewall was last updated.
    BackendIpv6Prefix string
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    Created string
    When this firewall was created.
    Firewalls []NodeBalancerFirewall
    A list of Firewalls assigned to this NodeBalancer.
    Hostname string
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    Id string
    The provider-assigned unique ID for this managed resource.
    Ipv6 string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    LkeClusters []NodeBalancerLkeCluster
    The related LKE cluster for this NodeBalancer, if any.
    Transfers []NodeBalancerTransfer
    Information about the amount of transfer this NodeBalancer has had so far this month.
    Updated string
    When this firewall was last updated.
    backend_ipv6_prefix string
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    created string
    When this firewall was created.
    firewalls list(object)
    A list of Firewalls assigned to this NodeBalancer.
    hostname string
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    id string
    The provider-assigned unique ID for this managed resource.
    ipv6 string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    lke_clusters list(object)
    The related LKE cluster for this NodeBalancer, if any.
    transfers list(object)
    Information about the amount of transfer this NodeBalancer has had so far this month.
    updated string
    When this firewall was last updated.
    backendIpv6Prefix String
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    created String
    When this firewall was created.
    firewalls List<NodeBalancerFirewall>
    A list of Firewalls assigned to this NodeBalancer.
    hostname String
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    id String
    The provider-assigned unique ID for this managed resource.
    ipv6 String
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    lkeClusters List<NodeBalancerLkeCluster>
    The related LKE cluster for this NodeBalancer, if any.
    transfers List<NodeBalancerTransfer>
    Information about the amount of transfer this NodeBalancer has had so far this month.
    updated String
    When this firewall was last updated.
    backendIpv6Prefix string
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    created string
    When this firewall was created.
    firewalls NodeBalancerFirewall[]
    A list of Firewalls assigned to this NodeBalancer.
    hostname string
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    id string
    The provider-assigned unique ID for this managed resource.
    ipv6 string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    lkeClusters NodeBalancerLkeCluster[]
    The related LKE cluster for this NodeBalancer, if any.
    transfers NodeBalancerTransfer[]
    Information about the amount of transfer this NodeBalancer has had so far this month.
    updated string
    When this firewall was last updated.
    backend_ipv6_prefix str
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    created str
    When this firewall was created.
    firewalls Sequence[NodeBalancerFirewall]
    A list of Firewalls assigned to this NodeBalancer.
    hostname str
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    id str
    The provider-assigned unique ID for this managed resource.
    ipv6 str
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    lke_clusters Sequence[NodeBalancerLkeCluster]
    The related LKE cluster for this NodeBalancer, if any.
    transfers Sequence[NodeBalancerTransfer]
    Information about the amount of transfer this NodeBalancer has had so far this month.
    updated str
    When this firewall was last updated.
    backendIpv6Prefix String
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    created String
    When this firewall was created.
    firewalls List<Property Map>
    A list of Firewalls assigned to this NodeBalancer.
    hostname String
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    id String
    The provider-assigned unique ID for this managed resource.
    ipv6 String
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    lkeClusters List<Property Map>
    The related LKE cluster for this NodeBalancer, if any.
    transfers List<Property Map>
    Information about the amount of transfer this NodeBalancer has had so far this month.
    updated String
    When this firewall was last updated.

    Look up Existing NodeBalancer Resource

    Get an existing NodeBalancer 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?: NodeBalancerState, opts?: CustomResourceOptions): NodeBalancer
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        backend_connectivity: Optional[str] = None,
        backend_ipv6_prefix: Optional[str] = None,
        client_conn_throttle: Optional[int] = None,
        client_udp_sess_throttle: Optional[int] = None,
        created: Optional[str] = None,
        firewall_id: Optional[int] = None,
        firewalls: Optional[Sequence[NodeBalancerFirewallArgs]] = None,
        hostname: Optional[str] = None,
        ipv4: Optional[str] = None,
        ipv6: Optional[str] = None,
        label: Optional[str] = None,
        lke_clusters: Optional[Sequence[NodeBalancerLkeClusterArgs]] = None,
        region: Optional[str] = None,
        tags: Optional[Sequence[str]] = None,
        transfers: Optional[Sequence[NodeBalancerTransferArgs]] = None,
        type: Optional[str] = None,
        updated: Optional[str] = None,
        vpcs: Optional[Sequence[NodeBalancerVpcArgs]] = None) -> NodeBalancer
    func GetNodeBalancer(ctx *Context, name string, id IDInput, state *NodeBalancerState, opts ...ResourceOption) (*NodeBalancer, error)
    public static NodeBalancer Get(string name, Input<string> id, NodeBalancerState? state, CustomResourceOptions? opts = null)
    public static NodeBalancer get(String name, Output<String> id, NodeBalancerState state, CustomResourceOptions options)
    resources:  _:    type: linode:NodeBalancer    get:      id: ${id}
    import {
  to = linode_node_balancer.example
  id = "${id}"
}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    BackendConnectivity string
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    BackendIpv6Prefix string
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    ClientConnThrottle int
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    ClientUdpSessThrottle int
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    Created string
    When this firewall was created.
    FirewallId int
    ID for the firewall you'd like to use with this NodeBalancer.
    Firewalls List<NodeBalancerFirewall>
    A list of Firewalls assigned to this NodeBalancer.
    Hostname string
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    Ipv4 string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    Ipv6 string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    Label string
    The label of the Linode NodeBalancer
    LkeClusters List<NodeBalancerLkeCluster>
    The related LKE cluster for this NodeBalancer, if any.
    Region string
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    Tags List<string>
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    Transfers List<NodeBalancerTransfer>
    Information about the amount of transfer this NodeBalancer has had so far this month.
    Type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    Updated string
    When this firewall was last updated.
    Vpcs List<NodeBalancerVpc>
    A list of VPCs to be assigned to this NodeBalancer.
    BackendConnectivity string
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    BackendIpv6Prefix string
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    ClientConnThrottle int
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    ClientUdpSessThrottle int
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    Created string
    When this firewall was created.
    FirewallId int
    ID for the firewall you'd like to use with this NodeBalancer.
    Firewalls []NodeBalancerFirewallArgs
    A list of Firewalls assigned to this NodeBalancer.
    Hostname string
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    Ipv4 string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    Ipv6 string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    Label string
    The label of the Linode NodeBalancer
    LkeClusters []NodeBalancerLkeClusterArgs
    The related LKE cluster for this NodeBalancer, if any.
    Region string
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    Tags []string
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    Transfers []NodeBalancerTransferArgs
    Information about the amount of transfer this NodeBalancer has had so far this month.
    Type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    Updated string
    When this firewall was last updated.
    Vpcs []NodeBalancerVpcArgs
    A list of VPCs to be assigned to this NodeBalancer.
    backend_connectivity string
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    backend_ipv6_prefix string
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    client_conn_throttle number
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    client_udp_sess_throttle number
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    created string
    When this firewall was created.
    firewall_id number
    ID for the firewall you'd like to use with this NodeBalancer.
    firewalls list(object)
    A list of Firewalls assigned to this NodeBalancer.
    hostname string
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    ipv4 string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6 string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label string
    The label of the Linode NodeBalancer
    lke_clusters list(object)
    The related LKE cluster for this NodeBalancer, if any.
    region string
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags list(string)
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    transfers list(object)
    Information about the amount of transfer this NodeBalancer has had so far this month.
    type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    updated string
    When this firewall was last updated.
    vpcs list(object)
    A list of VPCs to be assigned to this NodeBalancer.
    backendConnectivity String
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    backendIpv6Prefix String
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    clientConnThrottle Integer
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    clientUdpSessThrottle Integer
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    created String
    When this firewall was created.
    firewallId Integer
    ID for the firewall you'd like to use with this NodeBalancer.
    firewalls List<NodeBalancerFirewall>
    A list of Firewalls assigned to this NodeBalancer.
    hostname String
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    ipv4 String
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6 String
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label String
    The label of the Linode NodeBalancer
    lkeClusters List<NodeBalancerLkeCluster>
    The related LKE cluster for this NodeBalancer, if any.
    region String
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags List<String>
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    transfers List<NodeBalancerTransfer>
    Information about the amount of transfer this NodeBalancer has had so far this month.
    type String
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    updated String
    When this firewall was last updated.
    vpcs List<NodeBalancerVpc>
    A list of VPCs to be assigned to this NodeBalancer.
    backendConnectivity string
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    backendIpv6Prefix string
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    clientConnThrottle number
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    clientUdpSessThrottle number
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    created string
    When this firewall was created.
    firewallId number
    ID for the firewall you'd like to use with this NodeBalancer.
    firewalls NodeBalancerFirewall[]
    A list of Firewalls assigned to this NodeBalancer.
    hostname string
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    ipv4 string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6 string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label string
    The label of the Linode NodeBalancer
    lkeClusters NodeBalancerLkeCluster[]
    The related LKE cluster for this NodeBalancer, if any.
    region string
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags string[]
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    transfers NodeBalancerTransfer[]
    Information about the amount of transfer this NodeBalancer has had so far this month.
    type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    updated string
    When this firewall was last updated.
    vpcs NodeBalancerVpc[]
    A list of VPCs to be assigned to this NodeBalancer.
    backend_connectivity str
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    backend_ipv6_prefix str
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    client_conn_throttle int
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    client_udp_sess_throttle int
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    created str
    When this firewall was created.
    firewall_id int
    ID for the firewall you'd like to use with this NodeBalancer.
    firewalls Sequence[NodeBalancerFirewallArgs]
    A list of Firewalls assigned to this NodeBalancer.
    hostname str
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    ipv4 str
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6 str
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label str
    The label of the Linode NodeBalancer
    lke_clusters Sequence[NodeBalancerLkeClusterArgs]
    The related LKE cluster for this NodeBalancer, if any.
    region str
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags Sequence[str]
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    transfers Sequence[NodeBalancerTransferArgs]
    Information about the amount of transfer this NodeBalancer has had so far this month.
    type str
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    updated str
    When this firewall was last updated.
    vpcs Sequence[NodeBalancerVpcArgs]
    A list of VPCs to be assigned to this NodeBalancer.
    backendConnectivity String
    Backend communication mode: legacy (private IPv4), ipv6, or vpc. Requires apiVersion = "v4beta" and may not be available to all users. Changing this value replaces the NodeBalancer. When omitted, the API chooses the mode; it may report undefined if no mode, nodes, or VPCs were specified. undefined is read-only and cannot be configured.
    backendIpv6Prefix String
    The /96 IPv6 source range used when this NodeBalancer connects to backends. Null if no backend IPv6 prefix is assigned.
    clientConnThrottle Number
    Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
    clientUdpSessThrottle Number
    Throttle UDP sessions per second (0-20). Set to 0 (default) to disable throttling.

    • NOTE: This argument may not be generally available.
    created String
    When this firewall was created.
    firewallId Number
    ID for the firewall you'd like to use with this NodeBalancer.
    firewalls List<Property Map>
    A list of Firewalls assigned to this NodeBalancer.
    hostname String
    This NodeBalancer's hostname, ending with .nodebalancer.linode.com
    ipv4 String
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6 String
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label String
    The label of the Linode NodeBalancer
    lkeClusters List<Property Map>
    The related LKE cluster for this NodeBalancer, if any.
    region String
    The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. See all regions here. Changing region forces the creation of a new Linode NodeBalancer..

    tags List<String>
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    transfers List<Property Map>
    Information about the amount of transfer this NodeBalancer has had so far this month.
    type String
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    updated String
    When this firewall was last updated.
    vpcs List<Property Map>
    A list of VPCs to be assigned to this NodeBalancer.

    Supporting Types

    NodeBalancerFirewall, NodeBalancerFirewallArgs

    Created string
    When this firewall was created.
    Id int
    The ID of the related LKE cluster.
    InboundPolicy string
    The default behavior for inbound traffic. (ACCEPT, DROP)
    Inbounds List<NodeBalancerFirewallInbound>
    Label string
    The label of the Linode NodeBalancer
    OutboundPolicy string
    The default behavior for outbound traffic. (ACCEPT, DROP)
    Outbounds List<NodeBalancerFirewallOutbound>
    Status string
    The status of the firewall. (enabled, disabled, deleted)
    Tags List<string>
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    Updated string
    When this firewall was last updated.
    Created string
    When this firewall was created.
    Id int
    The ID of the related LKE cluster.
    InboundPolicy string
    The default behavior for inbound traffic. (ACCEPT, DROP)
    Inbounds []NodeBalancerFirewallInbound
    Label string
    The label of the Linode NodeBalancer
    OutboundPolicy string
    The default behavior for outbound traffic. (ACCEPT, DROP)
    Outbounds []NodeBalancerFirewallOutbound
    Status string
    The status of the firewall. (enabled, disabled, deleted)
    Tags []string
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    Updated string
    When this firewall was last updated.
    created string
    When this firewall was created.
    id number
    The ID of the related LKE cluster.
    inbound_policy string
    The default behavior for inbound traffic. (ACCEPT, DROP)
    inbounds list(object)
    label string
    The label of the Linode NodeBalancer
    outbound_policy string
    The default behavior for outbound traffic. (ACCEPT, DROP)
    outbounds list(object)
    status string
    The status of the firewall. (enabled, disabled, deleted)
    tags list(string)
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    updated string
    When this firewall was last updated.
    created String
    When this firewall was created.
    id Integer
    The ID of the related LKE cluster.
    inboundPolicy String
    The default behavior for inbound traffic. (ACCEPT, DROP)
    inbounds List<NodeBalancerFirewallInbound>
    label String
    The label of the Linode NodeBalancer
    outboundPolicy String
    The default behavior for outbound traffic. (ACCEPT, DROP)
    outbounds List<NodeBalancerFirewallOutbound>
    status String
    The status of the firewall. (enabled, disabled, deleted)
    tags List<String>
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    updated String
    When this firewall was last updated.
    created string
    When this firewall was created.
    id number
    The ID of the related LKE cluster.
    inboundPolicy string
    The default behavior for inbound traffic. (ACCEPT, DROP)
    inbounds NodeBalancerFirewallInbound[]
    label string
    The label of the Linode NodeBalancer
    outboundPolicy string
    The default behavior for outbound traffic. (ACCEPT, DROP)
    outbounds NodeBalancerFirewallOutbound[]
    status string
    The status of the firewall. (enabled, disabled, deleted)
    tags string[]
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    updated string
    When this firewall was last updated.
    created str
    When this firewall was created.
    id int
    The ID of the related LKE cluster.
    inbound_policy str
    The default behavior for inbound traffic. (ACCEPT, DROP)
    inbounds Sequence[NodeBalancerFirewallInbound]
    label str
    The label of the Linode NodeBalancer
    outbound_policy str
    The default behavior for outbound traffic. (ACCEPT, DROP)
    outbounds Sequence[NodeBalancerFirewallOutbound]
    status str
    The status of the firewall. (enabled, disabled, deleted)
    tags Sequence[str]
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    updated str
    When this firewall was last updated.
    created String
    When this firewall was created.
    id Number
    The ID of the related LKE cluster.
    inboundPolicy String
    The default behavior for inbound traffic. (ACCEPT, DROP)
    inbounds List<Property Map>
    label String
    The label of the Linode NodeBalancer
    outboundPolicy String
    The default behavior for outbound traffic. (ACCEPT, DROP)
    outbounds List<Property Map>
    status String
    The status of the firewall. (enabled, disabled, deleted)
    tags List<String>
    A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
    updated String
    When this firewall was last updated.

    NodeBalancerFirewallInbound, NodeBalancerFirewallInboundArgs

    Action string
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    Description string
    Ipv4s List<string>
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    Ipv6s List<string>
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    Label string
    The label of the Linode NodeBalancer
    Ports string
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    Protocol string
    The network protocol this rule controls. (TCP, UDP, ICMP)
    Action string
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    Description string
    Ipv4s []string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    Ipv6s []string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    Label string
    The label of the Linode NodeBalancer
    Ports string
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    Protocol string
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action string
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description string
    ipv4s list(string)
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s list(string)
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label string
    The label of the Linode NodeBalancer
    ports string
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol string
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action String
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description String
    ipv4s List<String>
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s List<String>
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label String
    The label of the Linode NodeBalancer
    ports String
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol String
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action string
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description string
    ipv4s string[]
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s string[]
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label string
    The label of the Linode NodeBalancer
    ports string
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol string
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action str
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description str
    ipv4s Sequence[str]
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s Sequence[str]
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label str
    The label of the Linode NodeBalancer
    ports str
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol str
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action String
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description String
    ipv4s List<String>
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s List<String>
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label String
    The label of the Linode NodeBalancer
    ports String
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol String
    The network protocol this rule controls. (TCP, UDP, ICMP)

    NodeBalancerFirewallOutbound, NodeBalancerFirewallOutboundArgs

    Action string
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    Description string
    Ipv4s List<string>
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    Ipv6s List<string>
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    Label string
    The label of the Linode NodeBalancer
    Ports string
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    Protocol string
    The network protocol this rule controls. (TCP, UDP, ICMP)
    Action string
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    Description string
    Ipv4s []string
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    Ipv6s []string
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    Label string
    The label of the Linode NodeBalancer
    Ports string
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    Protocol string
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action string
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description string
    ipv4s list(string)
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s list(string)
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label string
    The label of the Linode NodeBalancer
    ports string
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol string
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action String
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description String
    ipv4s List<String>
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s List<String>
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label String
    The label of the Linode NodeBalancer
    ports String
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol String
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action string
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description string
    ipv4s string[]
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s string[]
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label string
    The label of the Linode NodeBalancer
    ports string
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol string
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action str
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description str
    ipv4s Sequence[str]
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s Sequence[str]
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label str
    The label of the Linode NodeBalancer
    ports str
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol str
    The network protocol this rule controls. (TCP, UDP, ICMP)
    action String
    Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inboundPolicy if this is an inbound rule, or the outboundPolicy if this is an outbound rule.
    description String
    ipv4s List<String>
    The Public IPv4 address to assign to this NodeBalancer. When provided, the address must be a reserved IPv4 address that is unassigned and owned by the account. Changing ipv4 forces the creation of a new Linode NodeBalancer.
    ipv6s List<String>
    A list of IPv6 addresses or networks. Must be in IP/mask format.
    label String
    The label of the Linode NodeBalancer
    ports String
    A string representation of ports and/or port ranges (i.e. "443" or "80-90, 91").
    protocol String
    The network protocol this rule controls. (TCP, UDP, ICMP)

    NodeBalancerLkeCluster, NodeBalancerLkeClusterArgs

    Id int
    The ID of the related LKE cluster.
    Label string
    The label of the Linode NodeBalancer
    Type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    Url string
    The URL where you can access the related LKE cluster.
    Id int
    The ID of the related LKE cluster.
    Label string
    The label of the Linode NodeBalancer
    Type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    Url string
    The URL where you can access the related LKE cluster.
    id number
    The ID of the related LKE cluster.
    label string
    The label of the Linode NodeBalancer
    type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    url string
    The URL where you can access the related LKE cluster.
    id Integer
    The ID of the related LKE cluster.
    label String
    The label of the Linode NodeBalancer
    type String
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    url String
    The URL where you can access the related LKE cluster.
    id number
    The ID of the related LKE cluster.
    label string
    The label of the Linode NodeBalancer
    type string
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    url string
    The URL where you can access the related LKE cluster.
    id int
    The ID of the related LKE cluster.
    label str
    The label of the Linode NodeBalancer
    type str
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    url str
    The URL where you can access the related LKE cluster.
    id Number
    The ID of the related LKE cluster.
    label String
    The label of the Linode NodeBalancer
    type String
    NodeBalancer plan type: common (the API default), premium, or enterprise. Availability depends on the account and region. Changing this value replaces the NodeBalancer.
    url String
    The URL where you can access the related LKE cluster.

    NodeBalancerTransfer, NodeBalancerTransferArgs

    In double
    The total transfer, in MB, used by this NodeBalancer for the current month
    Out double
    The total inbound transfer, in MB, used for this NodeBalancer for the current month
    Total double
    The total outbound transfer, in MB, used for this NodeBalancer for the current month
    In float64
    The total transfer, in MB, used by this NodeBalancer for the current month
    Out float64
    The total inbound transfer, in MB, used for this NodeBalancer for the current month
    Total float64
    The total outbound transfer, in MB, used for this NodeBalancer for the current month
    in number
    The total transfer, in MB, used by this NodeBalancer for the current month
    out number
    The total inbound transfer, in MB, used for this NodeBalancer for the current month
    total number
    The total outbound transfer, in MB, used for this NodeBalancer for the current month
    in Double
    The total transfer, in MB, used by this NodeBalancer for the current month
    out Double
    The total inbound transfer, in MB, used for this NodeBalancer for the current month
    total Double
    The total outbound transfer, in MB, used for this NodeBalancer for the current month
    in number
    The total transfer, in MB, used by this NodeBalancer for the current month
    out number
    The total inbound transfer, in MB, used for this NodeBalancer for the current month
    total number
    The total outbound transfer, in MB, used for this NodeBalancer for the current month
    in_ float
    The total transfer, in MB, used by this NodeBalancer for the current month
    out float
    The total inbound transfer, in MB, used for this NodeBalancer for the current month
    total float
    The total outbound transfer, in MB, used for this NodeBalancer for the current month
    in Number
    The total transfer, in MB, used by this NodeBalancer for the current month
    out Number
    The total inbound transfer, in MB, used for this NodeBalancer for the current month
    total Number
    The total outbound transfer, in MB, used for this NodeBalancer for the current month

    NodeBalancerVpc, NodeBalancerVpcArgs

    SubnetId int
    (Required) The ID of a subnet to assign to this NodeBalancer.
    Ipv4Range string
    (Optional) A CIDR range for the VPC's IPv4 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    Ipv4RangeAutoAssign bool
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. (Optional, Write-Only) Enables the use of a larger ipv4Range subnet for multiple NodeBalancers within the same VPC by allocating smaller /30 subnets for each NodeBalancer's backends.
    Ipv6Range string
    (Optional) A CIDR range for the VPC's IPv6 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    SubnetId int
    (Required) The ID of a subnet to assign to this NodeBalancer.
    Ipv4Range string
    (Optional) A CIDR range for the VPC's IPv4 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    Ipv4RangeAutoAssign bool
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. (Optional, Write-Only) Enables the use of a larger ipv4Range subnet for multiple NodeBalancers within the same VPC by allocating smaller /30 subnets for each NodeBalancer's backends.
    Ipv6Range string
    (Optional) A CIDR range for the VPC's IPv6 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    subnet_id number
    (Required) The ID of a subnet to assign to this NodeBalancer.
    ipv4_range string
    (Optional) A CIDR range for the VPC's IPv4 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    ipv4_range_auto_assign bool
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. (Optional, Write-Only) Enables the use of a larger ipv4Range subnet for multiple NodeBalancers within the same VPC by allocating smaller /30 subnets for each NodeBalancer's backends.
    ipv6_range string
    (Optional) A CIDR range for the VPC's IPv6 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    subnetId Integer
    (Required) The ID of a subnet to assign to this NodeBalancer.
    ipv4Range String
    (Optional) A CIDR range for the VPC's IPv4 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    ipv4RangeAutoAssign Boolean
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. (Optional, Write-Only) Enables the use of a larger ipv4Range subnet for multiple NodeBalancers within the same VPC by allocating smaller /30 subnets for each NodeBalancer's backends.
    ipv6Range String
    (Optional) A CIDR range for the VPC's IPv6 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    subnetId number
    (Required) The ID of a subnet to assign to this NodeBalancer.
    ipv4Range string
    (Optional) A CIDR range for the VPC's IPv4 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    ipv4RangeAutoAssign boolean
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. (Optional, Write-Only) Enables the use of a larger ipv4Range subnet for multiple NodeBalancers within the same VPC by allocating smaller /30 subnets for each NodeBalancer's backends.
    ipv6Range string
    (Optional) A CIDR range for the VPC's IPv6 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    subnet_id int
    (Required) The ID of a subnet to assign to this NodeBalancer.
    ipv4_range str
    (Optional) A CIDR range for the VPC's IPv4 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    ipv4_range_auto_assign bool
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. (Optional, Write-Only) Enables the use of a larger ipv4Range subnet for multiple NodeBalancers within the same VPC by allocating smaller /30 subnets for each NodeBalancer's backends.
    ipv6_range str
    (Optional) A CIDR range for the VPC's IPv6 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    subnetId Number
    (Required) The ID of a subnet to assign to this NodeBalancer.
    ipv4Range String
    (Optional) A CIDR range for the VPC's IPv4 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.
    ipv4RangeAutoAssign Boolean
    NOTE: This field is write-only and its value will not be updated in state as part of read operations. (Optional, Write-Only) Enables the use of a larger ipv4Range subnet for multiple NodeBalancers within the same VPC by allocating smaller /30 subnets for each NodeBalancer's backends.
    ipv6Range String
    (Optional) A CIDR range for the VPC's IPv6 addresses. The NodeBalancer sources IP addresses from this range when routing traffic to the backend VPC nodes.

    Import

    Linodes NodeBalancers can be imported using the Linode NodeBalancer id, e.g.

    $ pulumi import linode:index/nodeBalancer:NodeBalancer mynodebalancer 1234567

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

    Package Details

    Repository
    Linode pulumi/pulumi-linode
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the linode Terraform Provider.
    linode logo linode logo
    Viewing docs for Linode v6.7.0
    published on Wednesday, Sep 30, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-linode

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial