Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Ionoscloud Provider
  3. API Docs
  4. Networkloadbalancer
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud
ionos-cloud/terraform-provider-ionoscloud

ionoscloud.Networkloadbalancer

Explore with Pulumi AI

ionoscloud logo
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud
ionos-cloud/terraform-provider-ionoscloud

    Manages a Network Load Balancer on IonosCloud.

    Example Usage

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

const exampleDatacenter = new ionoscloud.Datacenter("exampleDatacenter", {
    location: "us/las",
    description: "Datacenter Description",
    secAuthProtection: false,
});
const example1 = new ionoscloud.Lan("example1", {
    datacenterId: exampleDatacenter.datacenterId,
    "public": false,
});
const example2 = new ionoscloud.Lan("example2", {
    datacenterId: exampleDatacenter.datacenterId,
    "public": false,
});
const exampleNetworkloadbalancer = new ionoscloud.Networkloadbalancer("exampleNetworkloadbalancer", {
    datacenterId: exampleDatacenter.datacenterId,
    listenerLan: example1.lanId,
    targetLan: example2.lanId,
    ips: ["10.12.118.224"],
    lbPrivateIps: ["10.13.72.225/24"],
    centralLogging: true,
    loggingFormat: "%{+Q}o %{-Q}ci - - [%trg] %r %ST %B \"\" \"\" %cp %ms %ft %b %s %TR %Tw %Tc %Tr %Ta %tsc %ac %fc %bc %sc %rc %sq %bq %CC %CS %hrl %hsl",
});

    import pulumi
import pulumi_ionoscloud as ionoscloud

example_datacenter = ionoscloud.Datacenter("exampleDatacenter",
    location="us/las",
    description="Datacenter Description",
    sec_auth_protection=False)
example1 = ionoscloud.Lan("example1",
    datacenter_id=example_datacenter.datacenter_id,
    public=False)
example2 = ionoscloud.Lan("example2",
    datacenter_id=example_datacenter.datacenter_id,
    public=False)
example_networkloadbalancer = ionoscloud.Networkloadbalancer("exampleNetworkloadbalancer",
    datacenter_id=example_datacenter.datacenter_id,
    listener_lan=example1.lan_id,
    target_lan=example2.lan_id,
    ips=["10.12.118.224"],
    lb_private_ips=["10.13.72.225/24"],
    central_logging=True,
    logging_format="%{+Q}o %{-Q}ci - - [%trg] %r %ST %B \"\" \"\" %cp %ms %ft %b %s %TR %Tw %Tc %Tr %Ta %tsc %ac %fc %bc %sc %rc %sq %bq %CC %CS %hrl %hsl")

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleDatacenter, err := ionoscloud.NewDatacenter(ctx, "exampleDatacenter", &ionoscloud.DatacenterArgs{
			Location:          pulumi.String("us/las"),
			Description:       pulumi.String("Datacenter Description"),
			SecAuthProtection: pulumi.Bool(false),
		})
		if err != nil {
			return err
		}
		example1, err := ionoscloud.NewLan(ctx, "example1", &ionoscloud.LanArgs{
			DatacenterId: exampleDatacenter.DatacenterId,
			Public:       pulumi.Bool(false),
		})
		if err != nil {
			return err
		}
		example2, err := ionoscloud.NewLan(ctx, "example2", &ionoscloud.LanArgs{
			DatacenterId: exampleDatacenter.DatacenterId,
			Public:       pulumi.Bool(false),
		})
		if err != nil {
			return err
		}
		_, err = ionoscloud.NewNetworkloadbalancer(ctx, "exampleNetworkloadbalancer", &ionoscloud.NetworkloadbalancerArgs{
			DatacenterId: exampleDatacenter.DatacenterId,
			ListenerLan:  example1.LanId,
			TargetLan:    example2.LanId,
			Ips: pulumi.StringArray{
				pulumi.String("10.12.118.224"),
			},
			LbPrivateIps: pulumi.StringArray{
				pulumi.String("10.13.72.225/24"),
			},
			CentralLogging: pulumi.Bool(true),
			LoggingFormat:  pulumi.String("%{+Q}o %{-Q}ci - - [%trg] %r %ST %B \"\" \"\" %cp %ms %ft %b %s %TR %Tw %Tc %Tr %Ta %tsc %ac %fc %bc %sc %rc %sq %bq %CC %CS %hrl %hsl"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var exampleDatacenter = new Ionoscloud.Datacenter("exampleDatacenter", new()
    {
        Location = "us/las",
        Description = "Datacenter Description",
        SecAuthProtection = false,
    });

    var example1 = new Ionoscloud.Lan("example1", new()
    {
        DatacenterId = exampleDatacenter.DatacenterId,
        Public = false,
    });

    var example2 = new Ionoscloud.Lan("example2", new()
    {
        DatacenterId = exampleDatacenter.DatacenterId,
        Public = false,
    });

    var exampleNetworkloadbalancer = new Ionoscloud.Networkloadbalancer("exampleNetworkloadbalancer", new()
    {
        DatacenterId = exampleDatacenter.DatacenterId,
        ListenerLan = example1.LanId,
        TargetLan = example2.LanId,
        Ips = new[]
        {
            "10.12.118.224",
        },
        LbPrivateIps = new[]
        {
            "10.13.72.225/24",
        },
        CentralLogging = true,
        LoggingFormat = "%{+Q}o %{-Q}ci - - [%trg] %r %ST %B \"\" \"\" %cp %ms %ft %b %s %TR %Tw %Tc %Tr %Ta %tsc %ac %fc %bc %sc %rc %sq %bq %CC %CS %hrl %hsl",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.Datacenter;
import com.pulumi.ionoscloud.DatacenterArgs;
import com.pulumi.ionoscloud.Lan;
import com.pulumi.ionoscloud.LanArgs;
import com.pulumi.ionoscloud.Networkloadbalancer;
import com.pulumi.ionoscloud.NetworkloadbalancerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        var exampleDatacenter = new Datacenter("exampleDatacenter", DatacenterArgs.builder()
            .location("us/las")
            .description("Datacenter Description")
            .secAuthProtection(false)
            .build());

        var example1 = new Lan("example1", LanArgs.builder()
            .datacenterId(exampleDatacenter.datacenterId())
            .public_(false)
            .build());

        var example2 = new Lan("example2", LanArgs.builder()
            .datacenterId(exampleDatacenter.datacenterId())
            .public_(false)
            .build());

        var exampleNetworkloadbalancer = new Networkloadbalancer("exampleNetworkloadbalancer", NetworkloadbalancerArgs.builder()
            .datacenterId(exampleDatacenter.datacenterId())
            .listenerLan(example1.lanId())
            .targetLan(example2.lanId())
            .ips("10.12.118.224")
            .lbPrivateIps("10.13.72.225/24")
            .centralLogging(true)
            .loggingFormat("%{+Q}o %{-Q}ci - - [%trg] %r %ST %B \"\" \"\" %cp %ms %ft %b %s %TR %Tw %Tc %Tr %Ta %tsc %ac %fc %bc %sc %rc %sq %bq %CC %CS %hrl %hsl")
            .build());

    }
}

    resources:
  exampleDatacenter:
    type: ionoscloud:Datacenter
    properties:
      location: us/las
      description: Datacenter Description
      secAuthProtection: false
  example1:
    type: ionoscloud:Lan
    properties:
      datacenterId: ${exampleDatacenter.datacenterId}
      public: false
  example2:
    type: ionoscloud:Lan
    properties:
      datacenterId: ${exampleDatacenter.datacenterId}
      public: false
  exampleNetworkloadbalancer:
    type: ionoscloud:Networkloadbalancer
    properties:
      datacenterId: ${exampleDatacenter.datacenterId}
      listenerLan: ${example1.lanId}
      targetLan: ${example2.lanId}
      ips:
        - 10.12.118.224
      lbPrivateIps:
        - 10.13.72.225/24
      centralLogging: true
      loggingFormat: '%{+Q}o %{-Q}ci - - [%trg] %r %ST %B "" "" %cp %ms %ft %b %s %TR %Tw %Tc %Tr %Ta %tsc %ac %fc %bc %sc %rc %sq %bq %CC %CS %hrl %hsl'

    Example configuring Flowlog

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

const example = new ionoscloud.Networkloadbalancer("example", {
    datacenterId: ionoscloud_datacenter.example.id,
    listenerLan: ionoscloud_lan.example1.id,
    targetLan: ionoscloud_lan.example2.id,
    ips: ["10.12.118.224"],
    lbPrivateIps: ["10.13.72.225/24"],
    flowlog: {
        action: "ALL",
        bucket: "flowlog-bucket",
        direction: "INGRESS",
        name: "flowlog",
    },
});

    import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.Networkloadbalancer("example",
    datacenter_id=ionoscloud_datacenter["example"]["id"],
    listener_lan=ionoscloud_lan["example1"]["id"],
    target_lan=ionoscloud_lan["example2"]["id"],
    ips=["10.12.118.224"],
    lb_private_ips=["10.13.72.225/24"],
    flowlog={
        "action": "ALL",
        "bucket": "flowlog-bucket",
        "direction": "INGRESS",
        "name": "flowlog",
    })

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ionoscloud.NewNetworkloadbalancer(ctx, "example", &ionoscloud.NetworkloadbalancerArgs{
			DatacenterId: pulumi.Any(ionoscloud_datacenter.Example.Id),
			ListenerLan:  pulumi.Any(ionoscloud_lan.Example1.Id),
			TargetLan:    pulumi.Any(ionoscloud_lan.Example2.Id),
			Ips: pulumi.StringArray{
				pulumi.String("10.12.118.224"),
			},
			LbPrivateIps: pulumi.StringArray{
				pulumi.String("10.13.72.225/24"),
			},
			Flowlog: &ionoscloud.NetworkloadbalancerFlowlogArgs{
				Action:    pulumi.String("ALL"),
				Bucket:    pulumi.String("flowlog-bucket"),
				Direction: pulumi.String("INGRESS"),
				Name:      pulumi.String("flowlog"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var example = new Ionoscloud.Networkloadbalancer("example", new()
    {
        DatacenterId = ionoscloud_datacenter.Example.Id,
        ListenerLan = ionoscloud_lan.Example1.Id,
        TargetLan = ionoscloud_lan.Example2.Id,
        Ips = new[]
        {
            "10.12.118.224",
        },
        LbPrivateIps = new[]
        {
            "10.13.72.225/24",
        },
        Flowlog = new Ionoscloud.Inputs.NetworkloadbalancerFlowlogArgs
        {
            Action = "ALL",
            Bucket = "flowlog-bucket",
            Direction = "INGRESS",
            Name = "flowlog",
        },
    });

});

    package generated_program;

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

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

    public static void stack(Context ctx) {
        var example = new Networkloadbalancer("example", NetworkloadbalancerArgs.builder()
            .datacenterId(ionoscloud_datacenter.example().id())
            .listenerLan(ionoscloud_lan.example1().id())
            .targetLan(ionoscloud_lan.example2().id())
            .ips("10.12.118.224")
            .lbPrivateIps("10.13.72.225/24")
            .flowlog(NetworkloadbalancerFlowlogArgs.builder()
                .action("ALL")
                .bucket("flowlog-bucket")
                .direction("INGRESS")
                .name("flowlog")
                .build())
            .build());

    }
}

    resources:
  example:
    type: ionoscloud:Networkloadbalancer
    properties:
      datacenterId: ${ionoscloud_datacenter.example.id}
      listenerLan: ${ionoscloud_lan.example1.id}
      targetLan: ${ionoscloud_lan.example2.id}
      ips:
        - 10.12.118.224
      lbPrivateIps:
        - 10.13.72.225/24
      flowlog:
        action: ALL
        bucket: flowlog-bucket
        direction: INGRESS
        name: flowlog

    This will configure flowlog for ALL(rejected and accepted) ingress traffic and will log it into an existing ionos bucket named flowlog-bucket. Any s3 compatible client can be used to create it. Adding a flowlog does not force re-creation or the nic, but changing any other field than name will. Deleting a flowlog will also force nic re-creation.

    Create Networkloadbalancer Resource

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

    Constructor syntax

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

@overload
def Networkloadbalancer(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        datacenter_id: Optional[str] = None,
                        listener_lan: Optional[float] = None,
                        target_lan: Optional[float] = None,
                        central_logging: Optional[bool] = None,
                        flowlog: Optional[NetworkloadbalancerFlowlogArgs] = None,
                        ips: Optional[Sequence[str]] = None,
                        lb_private_ips: Optional[Sequence[str]] = None,
                        logging_format: Optional[str] = None,
                        name: Optional[str] = None,
                        networkloadbalancer_id: Optional[str] = None,
                        timeouts: Optional[NetworkloadbalancerTimeoutsArgs] = None)
    func NewNetworkloadbalancer(ctx *Context, name string, args NetworkloadbalancerArgs, opts ...ResourceOption) (*Networkloadbalancer, error)
    public Networkloadbalancer(string name, NetworkloadbalancerArgs args, CustomResourceOptions? opts = null)
    public Networkloadbalancer(String name, NetworkloadbalancerArgs args)
public Networkloadbalancer(String name, NetworkloadbalancerArgs args, CustomResourceOptions options)

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

    Parameters

    name string
    The unique name of the resource.
    args NetworkloadbalancerArgs
    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 NetworkloadbalancerArgs
    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 NetworkloadbalancerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args NetworkloadbalancerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args NetworkloadbalancerArgs
    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 networkloadbalancerResource = new Ionoscloud.Networkloadbalancer("networkloadbalancerResource", new()
{
    DatacenterId = "string",
    ListenerLan = 0,
    TargetLan = 0,
    CentralLogging = false,
    Flowlog = new Ionoscloud.Inputs.NetworkloadbalancerFlowlogArgs
    {
        Action = "string",
        Bucket = "string",
        Direction = "string",
        Name = "string",
        Id = "string",
    },
    Ips = new[]
    {
        "string",
    },
    LbPrivateIps = new[]
    {
        "string",
    },
    LoggingFormat = "string",
    Name = "string",
    NetworkloadbalancerId = "string",
    Timeouts = new Ionoscloud.Inputs.NetworkloadbalancerTimeoutsArgs
    {
        Create = "string",
        Default = "string",
        Delete = "string",
        Update = "string",
    },
});

    example, err := ionoscloud.NewNetworkloadbalancer(ctx, "networkloadbalancerResource", &ionoscloud.NetworkloadbalancerArgs{
	DatacenterId:   pulumi.String("string"),
	ListenerLan:    pulumi.Float64(0),
	TargetLan:      pulumi.Float64(0),
	CentralLogging: pulumi.Bool(false),
	Flowlog: &ionoscloud.NetworkloadbalancerFlowlogArgs{
		Action:    pulumi.String("string"),
		Bucket:    pulumi.String("string"),
		Direction: pulumi.String("string"),
		Name:      pulumi.String("string"),
		Id:        pulumi.String("string"),
	},
	Ips: pulumi.StringArray{
		pulumi.String("string"),
	},
	LbPrivateIps: pulumi.StringArray{
		pulumi.String("string"),
	},
	LoggingFormat:         pulumi.String("string"),
	Name:                  pulumi.String("string"),
	NetworkloadbalancerId: pulumi.String("string"),
	Timeouts: &ionoscloud.NetworkloadbalancerTimeoutsArgs{
		Create:  pulumi.String("string"),
		Default: pulumi.String("string"),
		Delete:  pulumi.String("string"),
		Update:  pulumi.String("string"),
	},
})

    var networkloadbalancerResource = new Networkloadbalancer("networkloadbalancerResource", NetworkloadbalancerArgs.builder()
    .datacenterId("string")
    .listenerLan(0)
    .targetLan(0)
    .centralLogging(false)
    .flowlog(NetworkloadbalancerFlowlogArgs.builder()
        .action("string")
        .bucket("string")
        .direction("string")
        .name("string")
        .id("string")
        .build())
    .ips("string")
    .lbPrivateIps("string")
    .loggingFormat("string")
    .name("string")
    .networkloadbalancerId("string")
    .timeouts(NetworkloadbalancerTimeoutsArgs.builder()
        .create("string")
        .default_("string")
        .delete("string")
        .update("string")
        .build())
    .build());

    networkloadbalancer_resource = ionoscloud.Networkloadbalancer("networkloadbalancerResource",
    datacenter_id="string",
    listener_lan=0,
    target_lan=0,
    central_logging=False,
    flowlog={
        "action": "string",
        "bucket": "string",
        "direction": "string",
        "name": "string",
        "id": "string",
    },
    ips=["string"],
    lb_private_ips=["string"],
    logging_format="string",
    name="string",
    networkloadbalancer_id="string",
    timeouts={
        "create": "string",
        "default": "string",
        "delete": "string",
        "update": "string",
    })

    const networkloadbalancerResource = new ionoscloud.Networkloadbalancer("networkloadbalancerResource", {
    datacenterId: "string",
    listenerLan: 0,
    targetLan: 0,
    centralLogging: false,
    flowlog: {
        action: "string",
        bucket: "string",
        direction: "string",
        name: "string",
        id: "string",
    },
    ips: ["string"],
    lbPrivateIps: ["string"],
    loggingFormat: "string",
    name: "string",
    networkloadbalancerId: "string",
    timeouts: {
        create: "string",
        "default": "string",
        "delete": "string",
        update: "string",
    },
});

    type: ionoscloud:Networkloadbalancer
properties:
    centralLogging: false
    datacenterId: string
    flowlog:
        action: string
        bucket: string
        direction: string
        id: string
        name: string
    ips:
        - string
    lbPrivateIps:
        - string
    listenerLan: 0
    loggingFormat: string
    name: string
    networkloadbalancerId: string
    targetLan: 0
    timeouts:
        create: string
        default: string
        delete: string
        update: string

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

    DatacenterId string
    [string] A Datacenter's UUID.
    ListenerLan double
    [int] Id of the listening LAN. (inbound)
    TargetLan double
    [int] Id of the balanced private target LAN. (outbound)
    CentralLogging bool
    [bool] Turn logging on and off for this product. Default value is 'false'.
    Flowlog NetworkloadbalancerFlowlog
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    Ips List<string>
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    LbPrivateIps List<string>
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    LoggingFormat string
    Specifies the format of the logs.
    Name string
    [string] A name of that Network Load Balancer.
    NetworkloadbalancerId string
    Timeouts NetworkloadbalancerTimeouts
    DatacenterId string
    [string] A Datacenter's UUID.
    ListenerLan float64
    [int] Id of the listening LAN. (inbound)
    TargetLan float64
    [int] Id of the balanced private target LAN. (outbound)
    CentralLogging bool
    [bool] Turn logging on and off for this product. Default value is 'false'.
    Flowlog NetworkloadbalancerFlowlogArgs
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    Ips []string
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    LbPrivateIps []string
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    LoggingFormat string
    Specifies the format of the logs.
    Name string
    [string] A name of that Network Load Balancer.
    NetworkloadbalancerId string
    Timeouts NetworkloadbalancerTimeoutsArgs
    datacenterId String
    [string] A Datacenter's UUID.
    listenerLan Double
    [int] Id of the listening LAN. (inbound)
    targetLan Double
    [int] Id of the balanced private target LAN. (outbound)
    centralLogging Boolean
    [bool] Turn logging on and off for this product. Default value is 'false'.
    flowlog NetworkloadbalancerFlowlog
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    ips List<String>
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    lbPrivateIps List<String>
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    loggingFormat String
    Specifies the format of the logs.
    name String
    [string] A name of that Network Load Balancer.
    networkloadbalancerId String
    timeouts NetworkloadbalancerTimeouts
    datacenterId string
    [string] A Datacenter's UUID.
    listenerLan number
    [int] Id of the listening LAN. (inbound)
    targetLan number
    [int] Id of the balanced private target LAN. (outbound)
    centralLogging boolean
    [bool] Turn logging on and off for this product. Default value is 'false'.
    flowlog NetworkloadbalancerFlowlog
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    ips string[]
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    lbPrivateIps string[]
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    loggingFormat string
    Specifies the format of the logs.
    name string
    [string] A name of that Network Load Balancer.
    networkloadbalancerId string
    timeouts NetworkloadbalancerTimeouts
    datacenter_id str
    [string] A Datacenter's UUID.
    listener_lan float
    [int] Id of the listening LAN. (inbound)
    target_lan float
    [int] Id of the balanced private target LAN. (outbound)
    central_logging bool
    [bool] Turn logging on and off for this product. Default value is 'false'.
    flowlog NetworkloadbalancerFlowlogArgs
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    ips Sequence[str]
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    lb_private_ips Sequence[str]
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    logging_format str
    Specifies the format of the logs.
    name str
    [string] A name of that Network Load Balancer.
    networkloadbalancer_id str
    timeouts NetworkloadbalancerTimeoutsArgs
    datacenterId String
    [string] A Datacenter's UUID.
    listenerLan Number
    [int] Id of the listening LAN. (inbound)
    targetLan Number
    [int] Id of the balanced private target LAN. (outbound)
    centralLogging Boolean
    [bool] Turn logging on and off for this product. Default value is 'false'.
    flowlog Property Map
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    ips List<String>
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    lbPrivateIps List<String>
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    loggingFormat String
    Specifies the format of the logs.
    name String
    [string] A name of that Network Load Balancer.
    networkloadbalancerId String
    timeouts Property Map

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing Networkloadbalancer Resource

    Get an existing Networkloadbalancer 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?: NetworkloadbalancerState, opts?: CustomResourceOptions): Networkloadbalancer
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        central_logging: Optional[bool] = None,
        datacenter_id: Optional[str] = None,
        flowlog: Optional[NetworkloadbalancerFlowlogArgs] = None,
        ips: Optional[Sequence[str]] = None,
        lb_private_ips: Optional[Sequence[str]] = None,
        listener_lan: Optional[float] = None,
        logging_format: Optional[str] = None,
        name: Optional[str] = None,
        networkloadbalancer_id: Optional[str] = None,
        target_lan: Optional[float] = None,
        timeouts: Optional[NetworkloadbalancerTimeoutsArgs] = None) -> Networkloadbalancer
    func GetNetworkloadbalancer(ctx *Context, name string, id IDInput, state *NetworkloadbalancerState, opts ...ResourceOption) (*Networkloadbalancer, error)
    public static Networkloadbalancer Get(string name, Input<string> id, NetworkloadbalancerState? state, CustomResourceOptions? opts = null)
    public static Networkloadbalancer get(String name, Output<String> id, NetworkloadbalancerState state, CustomResourceOptions options)
    resources:  _:    type: ionoscloud:Networkloadbalancer    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    CentralLogging bool
    [bool] Turn logging on and off for this product. Default value is 'false'.
    DatacenterId string
    [string] A Datacenter's UUID.
    Flowlog NetworkloadbalancerFlowlog
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    Ips List<string>
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    LbPrivateIps List<string>
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    ListenerLan double
    [int] Id of the listening LAN. (inbound)
    LoggingFormat string
    Specifies the format of the logs.
    Name string
    [string] A name of that Network Load Balancer.
    NetworkloadbalancerId string
    TargetLan double
    [int] Id of the balanced private target LAN. (outbound)
    Timeouts NetworkloadbalancerTimeouts
    CentralLogging bool
    [bool] Turn logging on and off for this product. Default value is 'false'.
    DatacenterId string
    [string] A Datacenter's UUID.
    Flowlog NetworkloadbalancerFlowlogArgs
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    Ips []string
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    LbPrivateIps []string
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    ListenerLan float64
    [int] Id of the listening LAN. (inbound)
    LoggingFormat string
    Specifies the format of the logs.
    Name string
    [string] A name of that Network Load Balancer.
    NetworkloadbalancerId string
    TargetLan float64
    [int] Id of the balanced private target LAN. (outbound)
    Timeouts NetworkloadbalancerTimeoutsArgs
    centralLogging Boolean
    [bool] Turn logging on and off for this product. Default value is 'false'.
    datacenterId String
    [string] A Datacenter's UUID.
    flowlog NetworkloadbalancerFlowlog
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    ips List<String>
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    lbPrivateIps List<String>
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    listenerLan Double
    [int] Id of the listening LAN. (inbound)
    loggingFormat String
    Specifies the format of the logs.
    name String
    [string] A name of that Network Load Balancer.
    networkloadbalancerId String
    targetLan Double
    [int] Id of the balanced private target LAN. (outbound)
    timeouts NetworkloadbalancerTimeouts
    centralLogging boolean
    [bool] Turn logging on and off for this product. Default value is 'false'.
    datacenterId string
    [string] A Datacenter's UUID.
    flowlog NetworkloadbalancerFlowlog
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    ips string[]
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    lbPrivateIps string[]
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    listenerLan number
    [int] Id of the listening LAN. (inbound)
    loggingFormat string
    Specifies the format of the logs.
    name string
    [string] A name of that Network Load Balancer.
    networkloadbalancerId string
    targetLan number
    [int] Id of the balanced private target LAN. (outbound)
    timeouts NetworkloadbalancerTimeouts
    central_logging bool
    [bool] Turn logging on and off for this product. Default value is 'false'.
    datacenter_id str
    [string] A Datacenter's UUID.
    flowlog NetworkloadbalancerFlowlogArgs
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    ips Sequence[str]
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    lb_private_ips Sequence[str]
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    listener_lan float
    [int] Id of the listening LAN. (inbound)
    logging_format str
    Specifies the format of the logs.
    name str
    [string] A name of that Network Load Balancer.
    networkloadbalancer_id str
    target_lan float
    [int] Id of the balanced private target LAN. (outbound)
    timeouts NetworkloadbalancerTimeoutsArgs
    centralLogging Boolean
    [bool] Turn logging on and off for this product. Default value is 'false'.
    datacenterId String
    [string] A Datacenter's UUID.
    flowlog Property Map
    [list] Only 1 flow log can be configured. Only the name field can change as part of an update. Flow logs holistically capture network information such as source and destination IP addresses, source and destination ports, number of packets, amount of bytes, the start and end time of the recording, and the type of protocol – and log the extent to which your instances are being accessed.
    ips List<String>
    [list] Collection of IP addresses of the Network Load Balancer. (inbound and outbound) IP of the listenerLan must be a customer reserved IP for the public load balancer and private IP for the private load balancer.
    lbPrivateIps List<String>
    [list] Collection of private IP addresses with subnet mask of the Network Load Balancer. IPs must contain valid subnet mask. If user will not provide any IP then the system will generate one IP with /24 subnet.
    listenerLan Number
    [int] Id of the listening LAN. (inbound)
    loggingFormat String
    Specifies the format of the logs.
    name String
    [string] A name of that Network Load Balancer.
    networkloadbalancerId String
    targetLan Number
    [int] Id of the balanced private target LAN. (outbound)
    timeouts Property Map

    Supporting Types

    NetworkloadbalancerFlowlog, NetworkloadbalancerFlowlogArgs

    Action string
    [string] Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
    Bucket string
    [string] Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
    Direction string
    [string] Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
    Name string

    [string] Specifies the name of the flow log.

    ⚠️ Note:: Removing the flowlog forces re-creation of the network load balancer resource.

    Id string
    The resource's unique identifier.
    Action string
    [string] Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
    Bucket string
    [string] Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
    Direction string
    [string] Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
    Name string

    [string] Specifies the name of the flow log.

    ⚠️ Note:: Removing the flowlog forces re-creation of the network load balancer resource.

    Id string
    The resource's unique identifier.
    action String
    [string] Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
    bucket String
    [string] Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
    direction String
    [string] Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
    name String

    [string] Specifies the name of the flow log.

    ⚠️ Note:: Removing the flowlog forces re-creation of the network load balancer resource.

    id String
    The resource's unique identifier.
    action string
    [string] Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
    bucket string
    [string] Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
    direction string
    [string] Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
    name string

    [string] Specifies the name of the flow log.

    ⚠️ Note:: Removing the flowlog forces re-creation of the network load balancer resource.

    id string
    The resource's unique identifier.
    action str
    [string] Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
    bucket str
    [string] Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
    direction str
    [string] Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
    name str

    [string] Specifies the name of the flow log.

    ⚠️ Note:: Removing the flowlog forces re-creation of the network load balancer resource.

    id str
    The resource's unique identifier.
    action String
    [string] Specifies the action to be taken when the rule is matched. Possible values: ACCEPTED, REJECTED, ALL. Immutable, forces re-creation.
    bucket String
    [string] Specifies the IONOS Object Storage bucket where the flow log data will be stored. The bucket must exist. Immutable, forces re-creation.
    direction String
    [string] Specifies the traffic direction pattern. Valid values: INGRESS, EGRESS, BIDIRECTIONAL. Immutable, forces re-creation.
    name String

    [string] Specifies the name of the flow log.

    ⚠️ Note:: Removing the flowlog forces re-creation of the network load balancer resource.

    id String
    The resource's unique identifier.

    NetworkloadbalancerTimeouts, NetworkloadbalancerTimeoutsArgs

    Create string
    Default string
    Delete string
    Update string
    Create string
    Default string
    Delete string
    Update string
    create String
    default_ String
    delete String
    update String
    create string
    default string
    delete string
    update string
    create String
    default String
    delete String
    update String

    Import

    A Network Load Balancer resource can be imported using its resource id and the datacenter id e.g.

    $ pulumi import ionoscloud:index/networkloadbalancer:Networkloadbalancer my_networkloadbalancer datacenter uuid/networkloadbalancer uuid

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

    Package Details

    Repository
    ionoscloud ionos-cloud/terraform-provider-ionoscloud
    License
    Notes
    This Pulumi package is based on the ionoscloud Terraform Provider.
    ionoscloud logo
    ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud
    ionos-cloud/terraform-provider-ionoscloud