Viewing docs for Linode v5.9.0
published on Friday, Mar 13, 2026 by Pulumi
published on Friday, Mar 13, 2026 by Pulumi
Viewing docs for Linode v5.9.0
published on Friday, Mar 13, 2026 by Pulumi
published on Friday, Mar 13, 2026 by Pulumi
Provides details about a Linode NodeBalancer. For more information, see the Linode APIv4 docs.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
const my_nodebalancer = linode.getNodeBalancer({
id: 123,
});
import pulumi
import pulumi_linode as linode
my_nodebalancer = linode.get_node_balancer(id=123)
package main
import (
"github.com/pulumi/pulumi-linode/sdk/v5/go/linode"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := linode.LookupNodeBalancer(ctx, &linode.LookupNodeBalancerArgs{
Id: 123,
}, nil)
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 my_nodebalancer = Linode.GetNodeBalancer.Invoke(new()
{
Id = 123,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.LinodeFunctions;
import com.pulumi.linode.inputs.GetNodeBalancerArgs;
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) {
final var my-nodebalancer = LinodeFunctions.getNodeBalancer(GetNodeBalancerArgs.builder()
.id(123)
.build());
}
}
variables:
my-nodebalancer:
fn::invoke:
function: linode:getNodeBalancer
arguments:
id: 123
Using getNodeBalancer
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getNodeBalancer(args: GetNodeBalancerArgs, opts?: InvokeOptions): Promise<GetNodeBalancerResult>
function getNodeBalancerOutput(args: GetNodeBalancerOutputArgs, opts?: InvokeOptions): Output<GetNodeBalancerResult>def get_node_balancer(id: Optional[int] = None,
opts: Optional[InvokeOptions] = None) -> GetNodeBalancerResult
def get_node_balancer_output(id: Optional[pulumi.Input[int]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetNodeBalancerResult]func LookupNodeBalancer(ctx *Context, args *LookupNodeBalancerArgs, opts ...InvokeOption) (*LookupNodeBalancerResult, error)
func LookupNodeBalancerOutput(ctx *Context, args *LookupNodeBalancerOutputArgs, opts ...InvokeOption) LookupNodeBalancerResultOutput> Note: This function is named LookupNodeBalancer in the Go SDK.
public static class GetNodeBalancer
{
public static Task<GetNodeBalancerResult> InvokeAsync(GetNodeBalancerArgs args, InvokeOptions? opts = null)
public static Output<GetNodeBalancerResult> Invoke(GetNodeBalancerInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetNodeBalancerResult> getNodeBalancer(GetNodeBalancerArgs args, InvokeOptions options)
public static Output<GetNodeBalancerResult> getNodeBalancer(GetNodeBalancerArgs args, InvokeOptions options)
fn::invoke:
function: linode:index/getNodeBalancer:getNodeBalancer
arguments:
# arguments dictionaryThe following arguments are supported:
- Id int
- The NodeBalancer's ID.
- Id int
- The NodeBalancer's ID.
- id Integer
- The NodeBalancer's ID.
- id number
- The NodeBalancer's ID.
- id int
- The NodeBalancer's ID.
- id Number
- The NodeBalancer's ID.
getNodeBalancer Result
The following output properties are available:
- Client
Conn intThrottle - Throttle connections per second (0-20).
- Client
Udp intSess Throttle - Throttle UDP sessions per second (0-20).
- Created string
- When this firewall was created.
- Firewalls
List<Get
Node Balancer Firewall> - Hostname string
- This NodeBalancer's hostname, ending with .ip.linodeusercontent.com
- Id int
- The Firewall's ID.
- Ipv4 string
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- Ipv6 string
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- Label string
- Used to identify this rule. For display purposes only.
- Region string
- The Region where this Linode NodeBalancer is located. NodeBalancers only support backends in the same Region.
- List<string>
- The tags applied to the firewall. Tags are case-insensitive and are for organizational purposes only.
- Transfers
List<Get
Node Balancer Transfer> - Updated string
- When this firewall was last updated.
- Vpcs
List<Get
Node Balancer Vpc>
- Client
Conn intThrottle - Throttle connections per second (0-20).
- Client
Udp intSess Throttle - Throttle UDP sessions per second (0-20).
- Created string
- When this firewall was created.
- Firewalls
[]Get
Node Balancer Firewall - Hostname string
- This NodeBalancer's hostname, ending with .ip.linodeusercontent.com
- Id int
- The Firewall's ID.
- Ipv4 string
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- Ipv6 string
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- Label string
- Used to identify this rule. For display purposes only.
- Region string
- The Region where this Linode NodeBalancer is located. NodeBalancers only support backends in the same Region.
- []string
- The tags applied to the firewall. Tags are case-insensitive and are for organizational purposes only.
- Transfers
[]Get
Node Balancer Transfer - Updated string
- When this firewall was last updated.
- Vpcs
[]Get
Node Balancer Vpc
- client
Conn IntegerThrottle - Throttle connections per second (0-20).
- client
Udp IntegerSess Throttle - Throttle UDP sessions per second (0-20).
- created String
- When this firewall was created.
- firewalls
List<Get
Node Balancer Firewall> - hostname String
- This NodeBalancer's hostname, ending with .ip.linodeusercontent.com
- id Integer
- The Firewall's ID.
- ipv4 String
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6 String
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label String
- Used to identify this rule. For display purposes only.
- region String
- The Region where this Linode NodeBalancer is located. NodeBalancers only support backends in the same Region.
- List<String>
- The tags applied to the firewall. Tags are case-insensitive and are for organizational purposes only.
- transfers
List<Get
Node Balancer Transfer> - updated String
- When this firewall was last updated.
- vpcs
List<Get
Node Balancer Vpc>
- client
Conn numberThrottle - Throttle connections per second (0-20).
- client
Udp numberSess Throttle - Throttle UDP sessions per second (0-20).
- created string
- When this firewall was created.
- firewalls
Get
Node Balancer Firewall[] - hostname string
- This NodeBalancer's hostname, ending with .ip.linodeusercontent.com
- id number
- The Firewall's ID.
- ipv4 string
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6 string
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label string
- Used to identify this rule. For display purposes only.
- region string
- The Region where this Linode NodeBalancer is located. NodeBalancers only support backends in the same Region.
- string[]
- The tags applied to the firewall. Tags are case-insensitive and are for organizational purposes only.
- transfers
Get
Node Balancer Transfer[] - updated string
- When this firewall was last updated.
- vpcs
Get
Node Balancer Vpc[]
- client_
conn_ intthrottle - Throttle connections per second (0-20).
- client_
udp_ intsess_ throttle - Throttle UDP sessions per second (0-20).
- created str
- When this firewall was created.
- firewalls
Sequence[Get
Node Balancer Firewall] - hostname str
- This NodeBalancer's hostname, ending with .ip.linodeusercontent.com
- id int
- The Firewall's ID.
- ipv4 str
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6 str
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label str
- Used to identify this rule. For display purposes only.
- region str
- The Region where this Linode NodeBalancer is located. NodeBalancers only support backends in the same Region.
- Sequence[str]
- The tags applied to the firewall. Tags are case-insensitive and are for organizational purposes only.
- transfers
Sequence[Get
Node Balancer Transfer] - updated str
- When this firewall was last updated.
- vpcs
Sequence[Get
Node Balancer Vpc]
- client
Conn NumberThrottle - Throttle connections per second (0-20).
- client
Udp NumberSess Throttle - Throttle UDP sessions per second (0-20).
- created String
- When this firewall was created.
- firewalls List<Property Map>
- hostname String
- This NodeBalancer's hostname, ending with .ip.linodeusercontent.com
- id Number
- The Firewall's ID.
- ipv4 String
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6 String
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label String
- Used to identify this rule. For display purposes only.
- region String
- The Region where this Linode NodeBalancer is located. NodeBalancers only support backends in the same Region.
- List<String>
- The tags applied to the firewall. Tags are case-insensitive and are for organizational purposes only.
- transfers List<Property Map>
- updated String
- When this firewall was last updated.
- vpcs List<Property Map>
Supporting Types
GetNodeBalancerFirewall
- Created string
- When this firewall was created.
- Id int
- The NodeBalancer's ID.
- Inbound
Policy string - The default behavior for inbound traffic. (
ACCEPT,DROP) - Inbounds
List<Get
Node Balancer Firewall Inbound> - A set of firewall rules that specify what inbound network traffic is allowed.
- Label string
- Used to identify this rule. For display purposes only.
- Outbound
Policy string - The default behavior for outbound traffic. (
ACCEPT,DROP) - Outbounds
List<Get
Node Balancer Firewall Outbound> - A set of firewall rules that specify what outbound network traffic is allowed.
- Status string
- The status of the firewall. (
enabled,disabled,deleted) - List<string>
- The tags applied to the firewall. 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 NodeBalancer's ID.
- Inbound
Policy string - The default behavior for inbound traffic. (
ACCEPT,DROP) - Inbounds
[]Get
Node Balancer Firewall Inbound - A set of firewall rules that specify what inbound network traffic is allowed.
- Label string
- Used to identify this rule. For display purposes only.
- Outbound
Policy string - The default behavior for outbound traffic. (
ACCEPT,DROP) - Outbounds
[]Get
Node Balancer Firewall Outbound - A set of firewall rules that specify what outbound network traffic is allowed.
- Status string
- The status of the firewall. (
enabled,disabled,deleted) - []string
- The tags applied to the firewall. 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 NodeBalancer's ID.
- inbound
Policy String - The default behavior for inbound traffic. (
ACCEPT,DROP) - inbounds
List<Get
Node Balancer Firewall Inbound> - A set of firewall rules that specify what inbound network traffic is allowed.
- label String
- Used to identify this rule. For display purposes only.
- outbound
Policy String - The default behavior for outbound traffic. (
ACCEPT,DROP) - outbounds
List<Get
Node Balancer Firewall Outbound> - A set of firewall rules that specify what outbound network traffic is allowed.
- status String
- The status of the firewall. (
enabled,disabled,deleted) - List<String>
- The tags applied to the firewall. 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 NodeBalancer's ID.
- inbound
Policy string - The default behavior for inbound traffic. (
ACCEPT,DROP) - inbounds
Get
Node Balancer Firewall Inbound[] - A set of firewall rules that specify what inbound network traffic is allowed.
- label string
- Used to identify this rule. For display purposes only.
- outbound
Policy string - The default behavior for outbound traffic. (
ACCEPT,DROP) - outbounds
Get
Node Balancer Firewall Outbound[] - A set of firewall rules that specify what outbound network traffic is allowed.
- status string
- The status of the firewall. (
enabled,disabled,deleted) - string[]
- The tags applied to the firewall. 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 NodeBalancer's ID.
- inbound_
policy str - The default behavior for inbound traffic. (
ACCEPT,DROP) - inbounds
Sequence[Get
Node Balancer Firewall Inbound] - A set of firewall rules that specify what inbound network traffic is allowed.
- label str
- Used to identify this rule. For display purposes only.
- outbound_
policy str - The default behavior for outbound traffic. (
ACCEPT,DROP) - outbounds
Sequence[Get
Node Balancer Firewall Outbound] - A set of firewall rules that specify what outbound network traffic is allowed.
- status str
- The status of the firewall. (
enabled,disabled,deleted) - Sequence[str]
- The tags applied to the firewall. 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 NodeBalancer's ID.
- inbound
Policy String - The default behavior for inbound traffic. (
ACCEPT,DROP) - inbounds List<Property Map>
- A set of firewall rules that specify what inbound network traffic is allowed.
- label String
- Used to identify this rule. For display purposes only.
- outbound
Policy String - The default behavior for outbound traffic. (
ACCEPT,DROP) - outbounds List<Property Map>
- A set of firewall rules that specify what outbound network traffic is allowed.
- status String
- The status of the firewall. (
enabled,disabled,deleted) - List<String>
- The tags applied to the firewall. Tags are case-insensitive and are for organizational purposes only.
- updated String
- When this firewall was last updated.
GetNodeBalancerFirewallInbound
- Action string
- Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- Ipv4s List<string>
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- Ipv6s List<string>
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- Label string
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- Ipv4s []string
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- Ipv6s []string
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- Label string
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- ipv4s List<String>
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6s List<String>
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label String
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- ipv4s string[]
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6s string[]
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label string
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- ipv4s Sequence[str]
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6s Sequence[str]
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label str
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- ipv4s List<String>
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6s List<String>
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label String
- Used to identify this rule. For display purposes only.
- 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)
GetNodeBalancerFirewallOutbound
- Action string
- Controls whether traffic is accepted or dropped by this rule. Overrides the Firewall’s inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- Ipv4s List<string>
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- Ipv6s List<string>
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- Label string
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- Ipv4s []string
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- Ipv6s []string
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- Label string
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- ipv4s List<String>
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6s List<String>
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label String
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- ipv4s string[]
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6s string[]
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label string
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- ipv4s Sequence[str]
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6s Sequence[str]
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label str
- Used to identify this rule. For display purposes only.
- 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 inbound_policy if this is an inbound rule, or the outbound_policy if this is an outbound rule.
- ipv4s List<String>
- A list of IPv4 addresses or networks. Must be in IP/mask format.
- ipv6s List<String>
- A list of IPv6 addresses or networks. Must be in IP/mask format.
- label String
- Used to identify this rule. For display purposes only.
- 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)
GetNodeBalancerTransfer
GetNodeBalancerVpc
- ipv4_
range str - 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.
- subnet_
id int - The ID of a subnet to assign to this NodeBalancer.
Package Details
- Repository
- Linode pulumi/pulumi-linode
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
linodeTerraform Provider.
Viewing docs for Linode v5.9.0
published on Friday, Mar 13, 2026 by Pulumi
published on Friday, Mar 13, 2026 by Pulumi
