1. Packages
  2. Linode Provider
  3. API Docs
  4. getNodebalancerVpcs
Linode v5.4.0 published on Friday, Oct 10, 2025 by Pulumi
pulumi/pulumi-linode

linode.getNodebalancerVpcs

Get Started
linode logo
Linode v5.4.0 published on Friday, Oct 10, 2025 by Pulumi
pulumi/pulumi-linode

    Limited Availability VPC-attached NodeBalancers may not currently be available to all users and may require the api_version provider argument must be set to v4beta.

    Provides information about Linode NodeBalancers VPC configurations that match a set of filters. For more information, see the Linode APIv4 docs.

    Example Usage

    Retrieve all VPC configurations under a NodeBalancer:

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

const vpc_configs = linode.getNodebalancerVpcs({
    nodebalancerId: 12345,
});

    import pulumi
import pulumi_linode as linode

vpc_configs = linode.get_nodebalancer_vpcs(nodebalancer_id=12345)

    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.GetNodebalancerVpcs(ctx, &linode.GetNodebalancerVpcsArgs{
			NodebalancerId: 12345,
		}, 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 vpc_configs = Linode.GetNodebalancerVpcs.Invoke(new()
    {
        NodebalancerId = 12345,
    });

});

    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.GetNodebalancerVpcsArgs;
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 vpc-configs = LinodeFunctions.getNodebalancerVpcs(GetNodebalancerVpcsArgs.builder()
            .nodebalancerId(12345)
            .build());

    }
}

    variables:
  vpc-configs:
    fn::invoke:
      function: linode:getNodebalancerVpcs
      arguments:
        nodebalancerId: 12345

    Retrieve all VPC configurations under a NodeBalancer with an IPv4 range of “10.0.0.4/30”:

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

const vpc_configs = linode.getNodebalancerVpcs({
    nodebalancerId: 12345,
    filters: [{
        name: "ipv4_range",
        values: ["10.0.0.4/30"],
    }],
});

    import pulumi
import pulumi_linode as linode

vpc_configs = linode.get_nodebalancer_vpcs(nodebalancer_id=12345,
    filters=[{
        "name": "ipv4_range",
        "values": ["10.0.0.4/30"],
    }])

    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.GetNodebalancerVpcs(ctx, &linode.GetNodebalancerVpcsArgs{
			NodebalancerId: 12345,
			Filters: []linode.GetNodebalancerVpcsFilter{
				{
					Name: "ipv4_range",
					Values: []string{
						"10.0.0.4/30",
					},
				},
			},
		}, 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 vpc_configs = Linode.GetNodebalancerVpcs.Invoke(new()
    {
        NodebalancerId = 12345,
        Filters = new[]
        {
            new Linode.Inputs.GetNodebalancerVpcsFilterInputArgs
            {
                Name = "ipv4_range",
                Values = new[]
                {
                    "10.0.0.4/30",
                },
            },
        },
    });

});

    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.GetNodebalancerVpcsArgs;
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 vpc-configs = LinodeFunctions.getNodebalancerVpcs(GetNodebalancerVpcsArgs.builder()
            .nodebalancerId(12345)
            .filters(GetNodebalancerVpcsFilterArgs.builder()
                .name("ipv4_range")
                .values("10.0.0.4/30")
                .build())
            .build());

    }
}

    variables:
  vpc-configs:
    fn::invoke:
      function: linode:getNodebalancerVpcs
      arguments:
        nodebalancerId: 12345
        filters:
          - name: ipv4_range
            values:
              - 10.0.0.4/30

    Filterable Fields

    • id

    • ipv4_range

    • nodebalancer_id

    • subnet_id

    • vpc_id

    Using getNodebalancerVpcs

    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 getNodebalancerVpcs(args: GetNodebalancerVpcsArgs, opts?: InvokeOptions): Promise<GetNodebalancerVpcsResult>
function getNodebalancerVpcsOutput(args: GetNodebalancerVpcsOutputArgs, opts?: InvokeOptions): Output<GetNodebalancerVpcsResult>
    def get_nodebalancer_vpcs(filters: Optional[Sequence[GetNodebalancerVpcsFilter]] = None,
                          nodebalancer_id: Optional[int] = None,
                          order: Optional[str] = None,
                          order_by: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetNodebalancerVpcsResult
def get_nodebalancer_vpcs_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetNodebalancerVpcsFilterArgs]]]] = None,
                          nodebalancer_id: Optional[pulumi.Input[int]] = None,
                          order: Optional[pulumi.Input[str]] = None,
                          order_by: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetNodebalancerVpcsResult]
    func GetNodebalancerVpcs(ctx *Context, args *GetNodebalancerVpcsArgs, opts ...InvokeOption) (*GetNodebalancerVpcsResult, error)
func GetNodebalancerVpcsOutput(ctx *Context, args *GetNodebalancerVpcsOutputArgs, opts ...InvokeOption) GetNodebalancerVpcsResultOutput

    > Note: This function is named GetNodebalancerVpcs in the Go SDK.

    public static class GetNodebalancerVpcs 
{
    public static Task<GetNodebalancerVpcsResult> InvokeAsync(GetNodebalancerVpcsArgs args, InvokeOptions? opts = null)
    public static Output<GetNodebalancerVpcsResult> Invoke(GetNodebalancerVpcsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetNodebalancerVpcsResult> getNodebalancerVpcs(GetNodebalancerVpcsArgs args, InvokeOptions options)
public static Output<GetNodebalancerVpcsResult> getNodebalancerVpcs(GetNodebalancerVpcsArgs args, InvokeOptions options)

    fn::invoke:
  function: linode:index/getNodebalancerVpcs:getNodebalancerVpcs
  arguments:
    # arguments dictionary

    The following arguments are supported:

    NodebalancerId int
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    Filters List<GetNodebalancerVpcsFilter>
    Order string
    The order in which results should be returned. (asc, desc; default asc)
    OrderBy string
    The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
    NodebalancerId int
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    Filters []GetNodebalancerVpcsFilter
    Order string
    The order in which results should be returned. (asc, desc; default asc)
    OrderBy string
    The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
    nodebalancerId Integer
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    filters List<GetNodebalancerVpcsFilter>
    order String
    The order in which results should be returned. (asc, desc; default asc)
    orderBy String
    The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
    nodebalancerId number
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    filters GetNodebalancerVpcsFilter[]
    order string
    The order in which results should be returned. (asc, desc; default asc)
    orderBy string
    The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
    nodebalancer_id int
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    filters Sequence[GetNodebalancerVpcsFilter]
    order str
    The order in which results should be returned. (asc, desc; default asc)
    order_by str
    The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
    nodebalancerId Number
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    filters List<Property Map>
    order String
    The order in which results should be returned. (asc, desc; default asc)
    orderBy String
    The attribute to order the results by. See the Filterable Fields section for a list of valid fields.

    getNodebalancerVpcs Result

    The following output properties are available:

    Id string
    The ID of the VPC configuration.
    NodebalancerId int
    The ID of the parent NodeBalancer for this VPC configuration.
    VpcConfigs List<GetNodebalancerVpcsVpcConfig>
    Filters List<GetNodebalancerVpcsFilter>
    Order string
    OrderBy string
    Id string
    The ID of the VPC configuration.
    NodebalancerId int
    The ID of the parent NodeBalancer for this VPC configuration.
    VpcConfigs []GetNodebalancerVpcsVpcConfig
    Filters []GetNodebalancerVpcsFilter
    Order string
    OrderBy string
    id String
    The ID of the VPC configuration.
    nodebalancerId Integer
    The ID of the parent NodeBalancer for this VPC configuration.
    vpcConfigs List<GetNodebalancerVpcsVpcConfig>
    filters List<GetNodebalancerVpcsFilter>
    order String
    orderBy String
    id string
    The ID of the VPC configuration.
    nodebalancerId number
    The ID of the parent NodeBalancer for this VPC configuration.
    vpcConfigs GetNodebalancerVpcsVpcConfig[]
    filters GetNodebalancerVpcsFilter[]
    order string
    orderBy string
    id str
    The ID of the VPC configuration.
    nodebalancer_id int
    The ID of the parent NodeBalancer for this VPC configuration.
    vpc_configs Sequence[GetNodebalancerVpcsVpcConfig]
    filters Sequence[GetNodebalancerVpcsFilter]
    order str
    order_by str
    id String
    The ID of the VPC configuration.
    nodebalancerId Number
    The ID of the parent NodeBalancer for this VPC configuration.
    vpcConfigs List<Property Map>
    filters List<Property Map>
    order String
    orderBy String

    Supporting Types

    GetNodebalancerVpcsFilter

    Name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    Values List<string>
    A list of values for the filter to allow. These values should all be in string form.
    MatchBy string
    The method to match the field by. (exact, regex, substring; default exact)
    Name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    Values []string
    A list of values for the filter to allow. These values should all be in string form.
    MatchBy string
    The method to match the field by. (exact, regex, substring; default exact)
    name String
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values List<String>
    A list of values for the filter to allow. These values should all be in string form.
    matchBy String
    The method to match the field by. (exact, regex, substring; default exact)
    name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values string[]
    A list of values for the filter to allow. These values should all be in string form.
    matchBy string
    The method to match the field by. (exact, regex, substring; default exact)
    name str
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values Sequence[str]
    A list of values for the filter to allow. These values should all be in string form.
    match_by str
    The method to match the field by. (exact, regex, substring; default exact)
    name String
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values List<String>
    A list of values for the filter to allow. These values should all be in string form.
    matchBy String
    The method to match the field by. (exact, regex, substring; default exact)

    GetNodebalancerVpcsVpcConfig

    Id int
    The ID of the VPC configuration.
    Ipv4Range string
    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.
    NodebalancerId int
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    SubnetId int
    The ID of this configuration's VPC subnet.
    VpcId int
    The ID of this configuration's VPC.
    Id int
    The ID of the VPC configuration.
    Ipv4Range string
    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.
    NodebalancerId int
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    SubnetId int
    The ID of this configuration's VPC subnet.
    VpcId int
    The ID of this configuration's VPC.
    id Integer
    The ID of the VPC configuration.
    ipv4Range String
    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.
    nodebalancerId Integer
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    subnetId Integer
    The ID of this configuration's VPC subnet.
    vpcId Integer
    The ID of this configuration's VPC.
    id number
    The ID of the VPC configuration.
    ipv4Range string
    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.
    nodebalancerId number
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    subnetId number
    The ID of this configuration's VPC subnet.
    vpcId number
    The ID of this configuration's VPC.
    id int
    The ID of the VPC configuration.
    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.
    nodebalancer_id int
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    subnet_id int
    The ID of this configuration's VPC subnet.
    vpc_id int
    The ID of this configuration's VPC.
    id Number
    The ID of the VPC configuration.
    ipv4Range String
    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.
    nodebalancerId Number
    The ID of the NodeBalancer to list VPC configurations for.

    • filter - (Optional) A set of filters used to select VPC configurations that meet certain requirements.
    subnetId Number
    The ID of this configuration's VPC subnet.
    vpcId Number
    The ID of this configuration's VPC.

    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 v5.4.0 published on Friday, Oct 10, 2025 by Pulumi
    pulumi/pulumi-linode
      Meet Neo: Your AI Platform Teammate