1. Packages
  2. stackit
  3. API Docs
  4. Loadbalancer
Viewing docs for stackit v0.0.4
published on Friday, Feb 20, 2026 by stackitcloud
Schema (JSON)
stackitcloud/pulumi-stackit

stackit.Loadbalancer

stackit logo
Viewing docs for stackit v0.0.4
published on Friday, Feb 20, 2026 by stackitcloud
Schema (JSON)
stackitcloud/pulumi-stackit

    Example Usage

    # Create a network
resource "stackit_network" "example_network" {
  project_id       = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name             = "example-network"
  ipv4_nameservers = ["8.8.8.8"]
  ipv4_prefix      = "192.168.0.0/25"
  labels = {
    "key" = "value"
  }
  routed = true
}

# Create a network interface
resource "stackit_network_interface" "nic" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  network_id = stackit_network.example_network.network_id
}

# Create a public IP for the load balancer
resource "stackit_public_ip" "public-ip" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  lifecycle {
    ignore_changes = [network_interface_id]
  }
}

# Create a key pair for accessing the server instance
resource "stackit_key_pair" "keypair" {
  name       = "example-key-pair"
  public_key = chomp(file("path/to/id_rsa.pub"))
}

# Create a server instance
resource "stackit_server" "boot-from-image" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name       = "example-server"
  boot_volume = {
    size        = 64
    source_type = "image"
    source_id   = "59838a89-51b1-4892-b57f-b3caf598ee2f" // Ubuntu 24.04
  }
  availability_zone = "xxxx-x"
  machine_type      = "g2i.1"
  keypair_name      = stackit_key_pair.keypair.name
  network_interfaces = [
    stackit_network_interface.nic.network_interface_id
  ]
}

# Create a load balancer
resource "stackit_loadbalancer" "example" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name       = "example-load-balancer"
  plan_id    = "p10"
  target_pools = [
    {
      name        = "example-target-pool"
      target_port = 80
      targets = [
        {
          display_name = stackit_server.boot-from-image.name
          ip           = stackit_network_interface.nic.ipv4
        }
      ]
      active_health_check = {
        healthy_threshold   = 10
        interval            = "3s"
        interval_jitter     = "3s"
        timeout             = "3s"
        unhealthy_threshold = 10
      }
    }
  ]
  listeners = [
    {
      display_name = "example-listener"
      port         = 80
      protocol     = "PROTOCOL_TCP"
      target_pool  = "example-target-pool"
      tcp = {
        idle_timeout = "90s"
      }
    }
  ]
  networks = [
    {
      network_id = stackit_network.example_network.network_id
      role       = "ROLE_LISTENERS_AND_TARGETS"
    }
  ]
  external_address = stackit_public_ip.public-ip.ip
  options = {
    private_network_only = false
  }
}

# This example demonstrates an advanced setup where the Load Balancer is in one
# network and the target server is in another. This requires manual
# security group configuration using the `disable_security_group_assignment`
# and `security_group_id` attributes.

# We create two separate networks: one for the load balancer and one for the target.
resource "stackit_network" "lb_network" {
  project_id       = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name             = "lb-network-example"
  ipv4_prefix      = "192.168.10.0/25"
  ipv4_nameservers = ["8.8.8.8"]
}

resource "stackit_network" "target_network" {
  project_id       = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name             = "target-network-example"
  ipv4_prefix      = "192.168.10.0/25"
  ipv4_nameservers = ["8.8.8.8"]
}

resource "stackit_public_ip" "example" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

resource "stackit_loadbalancer" "example" {
  project_id       = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name             = "example-advanced-lb"
  external_address = stackit_public_ip.example.ip

  # Key setting for manual mode: disables automatic security group handling.
  disable_security_group_assignment = true

  networks = [{
    network_id = stackit_network.lb_network.network_id
    role       = "ROLE_LISTENERS_AND_TARGETS"
  }]

  listeners = [{
    port        = 80
    protocol    = "PROTOCOL_TCP"
    target_pool = "cross-network-pool"
  }]

  target_pools = [{
    name        = "cross-network-pool"
    target_port = 80
    targets = [{
      display_name = stackit_server.example.name
      ip           = stackit_network_interface.nic.ipv4
    }]
  }]
}

# Create a new security group to be assigned to the target server.
resource "stackit_security_group" "target_sg" {
  project_id  = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name        = "target-sg-for-lb-access"
  description = "Allows ingress traffic from the example load balancer."
}

# Create a rule to allow traffic FROM the load balancer.
# This rule uses the computed `security_group_id` of the load balancer.
resource "stackit_security_group_rule" "allow_lb_ingress" {
  project_id        = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  security_group_id = stackit_security_group.target_sg.security_group_id
  direction         = "ingress"
  protocol = {
    name = "tcp"
  }

  # This is the crucial link: it allows traffic from the LB's security group.
  remote_security_group_id = stackit_loadbalancer.example.security_group_id

  port_range = {
    min = 80
    max = 80
  }
}

resource "stackit_server" "example" {
  project_id        = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name              = "example-remote-target"
  machine_type      = "g2i.2"
  availability_zone = "eu01-1"

  boot_volume = {
    source_type = "image"
    source_id   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    size        = 10
  }

  network_interfaces = [
    stackit_network_interface.nic.network_interface_id
  ]
}

resource "stackit_network_interface" "nic" {
  project_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  network_id         = stackit_network.target_network.network_id
  security_group_ids = [stackit_security_group.target_sg.security_group_id]
}
# End of advanced example

# Only use the import statement, if you want to import an existing loadbalancer
import {
  to = stackit_loadbalancer.import-example
  id = "${var.project_id},${var.region},${var.loadbalancer_name}"
}

    Create Loadbalancer Resource

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

    Constructor syntax

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

@overload
def Loadbalancer(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 listeners: Optional[Sequence[LoadbalancerListenerArgs]] = None,
                 networks: Optional[Sequence[LoadbalancerNetworkArgs]] = None,
                 project_id: Optional[str] = None,
                 target_pools: Optional[Sequence[LoadbalancerTargetPoolArgs]] = None,
                 disable_security_group_assignment: Optional[bool] = None,
                 external_address: Optional[str] = None,
                 name: Optional[str] = None,
                 options: Optional[LoadbalancerOptionsArgs] = None,
                 plan_id: Optional[str] = None,
                 region: Optional[str] = None)
    func NewLoadbalancer(ctx *Context, name string, args LoadbalancerArgs, opts ...ResourceOption) (*Loadbalancer, error)
    public Loadbalancer(string name, LoadbalancerArgs args, CustomResourceOptions? opts = null)
    public Loadbalancer(String name, LoadbalancerArgs args)
public Loadbalancer(String name, LoadbalancerArgs args, CustomResourceOptions options)

    type: stackit:Loadbalancer
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 LoadbalancerArgs
    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 LoadbalancerArgs
    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 LoadbalancerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LoadbalancerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LoadbalancerArgs
    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 loadbalancerResource = new Stackit.Loadbalancer("loadbalancerResource", new()
{
    Listeners = new[]
    {
        new Stackit.Inputs.LoadbalancerListenerArgs
        {
            Port = 0,
            Protocol = "string",
            TargetPool = "string",
            DisplayName = "string",
            ServerNameIndicators = new[]
            {
                new Stackit.Inputs.LoadbalancerListenerServerNameIndicatorArgs
                {
                    Name = "string",
                },
            },
            Tcp = new Stackit.Inputs.LoadbalancerListenerTcpArgs
            {
                IdleTimeout = "string",
            },
            Udp = new Stackit.Inputs.LoadbalancerListenerUdpArgs
            {
                IdleTimeout = "string",
            },
        },
    },
    Networks = new[]
    {
        new Stackit.Inputs.LoadbalancerNetworkArgs
        {
            NetworkId = "string",
            Role = "string",
        },
    },
    ProjectId = "string",
    TargetPools = new[]
    {
        new Stackit.Inputs.LoadbalancerTargetPoolArgs
        {
            Name = "string",
            TargetPort = 0,
            Targets = new[]
            {
                new Stackit.Inputs.LoadbalancerTargetPoolTargetArgs
                {
                    DisplayName = "string",
                    Ip = "string",
                },
            },
            ActiveHealthCheck = new Stackit.Inputs.LoadbalancerTargetPoolActiveHealthCheckArgs
            {
                HealthyThreshold = 0,
                Interval = "string",
                IntervalJitter = "string",
                Timeout = "string",
                UnhealthyThreshold = 0,
            },
            SessionPersistence = new Stackit.Inputs.LoadbalancerTargetPoolSessionPersistenceArgs
            {
                UseSourceIpAddress = false,
            },
        },
    },
    DisableSecurityGroupAssignment = false,
    ExternalAddress = "string",
    Name = "string",
    Options = new Stackit.Inputs.LoadbalancerOptionsArgs
    {
        Acls = new[]
        {
            "string",
        },
        Observability = new Stackit.Inputs.LoadbalancerOptionsObservabilityArgs
        {
            Logs = new Stackit.Inputs.LoadbalancerOptionsObservabilityLogsArgs
            {
                CredentialsRef = "string",
                PushUrl = "string",
            },
            Metrics = new Stackit.Inputs.LoadbalancerOptionsObservabilityMetricsArgs
            {
                CredentialsRef = "string",
                PushUrl = "string",
            },
        },
        PrivateNetworkOnly = false,
    },
    PlanId = "string",
    Region = "string",
});

    example, err := stackit.NewLoadbalancer(ctx, "loadbalancerResource", &stackit.LoadbalancerArgs{
	Listeners: stackit.LoadbalancerListenerArray{
		&stackit.LoadbalancerListenerArgs{
			Port:        pulumi.Int(0),
			Protocol:    pulumi.String("string"),
			TargetPool:  pulumi.String("string"),
			DisplayName: pulumi.String("string"),
			ServerNameIndicators: stackit.LoadbalancerListenerServerNameIndicatorArray{
				&stackit.LoadbalancerListenerServerNameIndicatorArgs{
					Name: pulumi.String("string"),
				},
			},
			Tcp: &stackit.LoadbalancerListenerTcpArgs{
				IdleTimeout: pulumi.String("string"),
			},
			Udp: &stackit.LoadbalancerListenerUdpArgs{
				IdleTimeout: pulumi.String("string"),
			},
		},
	},
	Networks: stackit.LoadbalancerNetworkArray{
		&stackit.LoadbalancerNetworkArgs{
			NetworkId: pulumi.String("string"),
			Role:      pulumi.String("string"),
		},
	},
	ProjectId: pulumi.String("string"),
	TargetPools: stackit.LoadbalancerTargetPoolArray{
		&stackit.LoadbalancerTargetPoolArgs{
			Name:       pulumi.String("string"),
			TargetPort: pulumi.Int(0),
			Targets: stackit.LoadbalancerTargetPoolTargetArray{
				&stackit.LoadbalancerTargetPoolTargetArgs{
					DisplayName: pulumi.String("string"),
					Ip:          pulumi.String("string"),
				},
			},
			ActiveHealthCheck: &stackit.LoadbalancerTargetPoolActiveHealthCheckArgs{
				HealthyThreshold:   pulumi.Int(0),
				Interval:           pulumi.String("string"),
				IntervalJitter:     pulumi.String("string"),
				Timeout:            pulumi.String("string"),
				UnhealthyThreshold: pulumi.Int(0),
			},
			SessionPersistence: &stackit.LoadbalancerTargetPoolSessionPersistenceArgs{
				UseSourceIpAddress: pulumi.Bool(false),
			},
		},
	},
	DisableSecurityGroupAssignment: pulumi.Bool(false),
	ExternalAddress:                pulumi.String("string"),
	Name:                           pulumi.String("string"),
	Options: &stackit.LoadbalancerOptionsArgs{
		Acls: pulumi.StringArray{
			pulumi.String("string"),
		},
		Observability: &stackit.LoadbalancerOptionsObservabilityArgs{
			Logs: &stackit.LoadbalancerOptionsObservabilityLogsArgs{
				CredentialsRef: pulumi.String("string"),
				PushUrl:        pulumi.String("string"),
			},
			Metrics: &stackit.LoadbalancerOptionsObservabilityMetricsArgs{
				CredentialsRef: pulumi.String("string"),
				PushUrl:        pulumi.String("string"),
			},
		},
		PrivateNetworkOnly: pulumi.Bool(false),
	},
	PlanId: pulumi.String("string"),
	Region: pulumi.String("string"),
})

    var loadbalancerResource = new Loadbalancer("loadbalancerResource", LoadbalancerArgs.builder()
    .listeners(LoadbalancerListenerArgs.builder()
        .port(0)
        .protocol("string")
        .targetPool("string")
        .displayName("string")
        .serverNameIndicators(LoadbalancerListenerServerNameIndicatorArgs.builder()
            .name("string")
            .build())
        .tcp(LoadbalancerListenerTcpArgs.builder()
            .idleTimeout("string")
            .build())
        .udp(LoadbalancerListenerUdpArgs.builder()
            .idleTimeout("string")
            .build())
        .build())
    .networks(LoadbalancerNetworkArgs.builder()
        .networkId("string")
        .role("string")
        .build())
    .projectId("string")
    .targetPools(LoadbalancerTargetPoolArgs.builder()
        .name("string")
        .targetPort(0)
        .targets(LoadbalancerTargetPoolTargetArgs.builder()
            .displayName("string")
            .ip("string")
            .build())
        .activeHealthCheck(LoadbalancerTargetPoolActiveHealthCheckArgs.builder()
            .healthyThreshold(0)
            .interval("string")
            .intervalJitter("string")
            .timeout("string")
            .unhealthyThreshold(0)
            .build())
        .sessionPersistence(LoadbalancerTargetPoolSessionPersistenceArgs.builder()
            .useSourceIpAddress(false)
            .build())
        .build())
    .disableSecurityGroupAssignment(false)
    .externalAddress("string")
    .name("string")
    .options(LoadbalancerOptionsArgs.builder()
        .acls("string")
        .observability(LoadbalancerOptionsObservabilityArgs.builder()
            .logs(LoadbalancerOptionsObservabilityLogsArgs.builder()
                .credentialsRef("string")
                .pushUrl("string")
                .build())
            .metrics(LoadbalancerOptionsObservabilityMetricsArgs.builder()
                .credentialsRef("string")
                .pushUrl("string")
                .build())
            .build())
        .privateNetworkOnly(false)
        .build())
    .planId("string")
    .region("string")
    .build());

    loadbalancer_resource = stackit.Loadbalancer("loadbalancerResource",
    listeners=[{
        "port": 0,
        "protocol": "string",
        "target_pool": "string",
        "display_name": "string",
        "server_name_indicators": [{
            "name": "string",
        }],
        "tcp": {
            "idle_timeout": "string",
        },
        "udp": {
            "idle_timeout": "string",
        },
    }],
    networks=[{
        "network_id": "string",
        "role": "string",
    }],
    project_id="string",
    target_pools=[{
        "name": "string",
        "target_port": 0,
        "targets": [{
            "display_name": "string",
            "ip": "string",
        }],
        "active_health_check": {
            "healthy_threshold": 0,
            "interval": "string",
            "interval_jitter": "string",
            "timeout": "string",
            "unhealthy_threshold": 0,
        },
        "session_persistence": {
            "use_source_ip_address": False,
        },
    }],
    disable_security_group_assignment=False,
    external_address="string",
    name="string",
    options={
        "acls": ["string"],
        "observability": {
            "logs": {
                "credentials_ref": "string",
                "push_url": "string",
            },
            "metrics": {
                "credentials_ref": "string",
                "push_url": "string",
            },
        },
        "private_network_only": False,
    },
    plan_id="string",
    region="string")

    const loadbalancerResource = new stackit.Loadbalancer("loadbalancerResource", {
    listeners: [{
        port: 0,
        protocol: "string",
        targetPool: "string",
        displayName: "string",
        serverNameIndicators: [{
            name: "string",
        }],
        tcp: {
            idleTimeout: "string",
        },
        udp: {
            idleTimeout: "string",
        },
    }],
    networks: [{
        networkId: "string",
        role: "string",
    }],
    projectId: "string",
    targetPools: [{
        name: "string",
        targetPort: 0,
        targets: [{
            displayName: "string",
            ip: "string",
        }],
        activeHealthCheck: {
            healthyThreshold: 0,
            interval: "string",
            intervalJitter: "string",
            timeout: "string",
            unhealthyThreshold: 0,
        },
        sessionPersistence: {
            useSourceIpAddress: false,
        },
    }],
    disableSecurityGroupAssignment: false,
    externalAddress: "string",
    name: "string",
    options: {
        acls: ["string"],
        observability: {
            logs: {
                credentialsRef: "string",
                pushUrl: "string",
            },
            metrics: {
                credentialsRef: "string",
                pushUrl: "string",
            },
        },
        privateNetworkOnly: false,
    },
    planId: "string",
    region: "string",
});

    type: stackit:Loadbalancer
properties:
    disableSecurityGroupAssignment: false
    externalAddress: string
    listeners:
        - displayName: string
          port: 0
          protocol: string
          serverNameIndicators:
            - name: string
          targetPool: string
          tcp:
            idleTimeout: string
          udp:
            idleTimeout: string
    name: string
    networks:
        - networkId: string
          role: string
    options:
        acls:
            - string
        observability:
            logs:
                credentialsRef: string
                pushUrl: string
            metrics:
                credentialsRef: string
                pushUrl: string
        privateNetworkOnly: false
    planId: string
    projectId: string
    region: string
    targetPools:
        - activeHealthCheck:
            healthyThreshold: 0
            interval: string
            intervalJitter: string
            timeout: string
            unhealthyThreshold: 0
          name: string
          sessionPersistence:
            useSourceIpAddress: false
          targetPort: 0
          targets:
            - displayName: string
              ip: string

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

    Listeners List<LoadbalancerListener>
    List of all listeners which will accept traffic. Limited to 20.
    Networks List<LoadbalancerNetwork>
    List of networks that listeners and targets reside in.
    ProjectId string
    STACKIT project ID to which the Load Balancer is associated.
    TargetPools List<LoadbalancerTargetPool>
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    DisableSecurityGroupAssignment bool
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    ExternalAddress string
    External Load Balancer IP address where this Load Balancer is exposed.
    Name string
    Load balancer name.
    Options LoadbalancerOptions
    Defines any optional functionality you want to have enabled on your load balancer.
    PlanId string
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    Region string
    The resource region. If not defined, the provider region is used.
    Listeners []LoadbalancerListenerArgs
    List of all listeners which will accept traffic. Limited to 20.
    Networks []LoadbalancerNetworkArgs
    List of networks that listeners and targets reside in.
    ProjectId string
    STACKIT project ID to which the Load Balancer is associated.
    TargetPools []LoadbalancerTargetPoolArgs
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    DisableSecurityGroupAssignment bool
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    ExternalAddress string
    External Load Balancer IP address where this Load Balancer is exposed.
    Name string
    Load balancer name.
    Options LoadbalancerOptionsArgs
    Defines any optional functionality you want to have enabled on your load balancer.
    PlanId string
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    Region string
    The resource region. If not defined, the provider region is used.
    listeners List<LoadbalancerListener>
    List of all listeners which will accept traffic. Limited to 20.
    networks List<LoadbalancerNetwork>
    List of networks that listeners and targets reside in.
    projectId String
    STACKIT project ID to which the Load Balancer is associated.
    targetPools List<LoadbalancerTargetPool>
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    disableSecurityGroupAssignment Boolean
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    externalAddress String
    External Load Balancer IP address where this Load Balancer is exposed.
    name String
    Load balancer name.
    options LoadbalancerOptions
    Defines any optional functionality you want to have enabled on your load balancer.
    planId String
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    region String
    The resource region. If not defined, the provider region is used.
    listeners LoadbalancerListener[]
    List of all listeners which will accept traffic. Limited to 20.
    networks LoadbalancerNetwork[]
    List of networks that listeners and targets reside in.
    projectId string
    STACKIT project ID to which the Load Balancer is associated.
    targetPools LoadbalancerTargetPool[]
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    disableSecurityGroupAssignment boolean
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    externalAddress string
    External Load Balancer IP address where this Load Balancer is exposed.
    name string
    Load balancer name.
    options LoadbalancerOptions
    Defines any optional functionality you want to have enabled on your load balancer.
    planId string
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    region string
    The resource region. If not defined, the provider region is used.
    listeners Sequence[LoadbalancerListenerArgs]
    List of all listeners which will accept traffic. Limited to 20.
    networks Sequence[LoadbalancerNetworkArgs]
    List of networks that listeners and targets reside in.
    project_id str
    STACKIT project ID to which the Load Balancer is associated.
    target_pools Sequence[LoadbalancerTargetPoolArgs]
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    disable_security_group_assignment bool
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    external_address str
    External Load Balancer IP address where this Load Balancer is exposed.
    name str
    Load balancer name.
    options LoadbalancerOptionsArgs
    Defines any optional functionality you want to have enabled on your load balancer.
    plan_id str
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    region str
    The resource region. If not defined, the provider region is used.
    listeners List<Property Map>
    List of all listeners which will accept traffic. Limited to 20.
    networks List<Property Map>
    List of networks that listeners and targets reside in.
    projectId String
    STACKIT project ID to which the Load Balancer is associated.
    targetPools List<Property Map>
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    disableSecurityGroupAssignment Boolean
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    externalAddress String
    External Load Balancer IP address where this Load Balancer is exposed.
    name String
    Load balancer name.
    options Property Map
    Defines any optional functionality you want to have enabled on your load balancer.
    planId String
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    region String
    The resource region. If not defined, the provider region is used.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    PrivateAddress string
    Transient private Load Balancer IP address. It can change any time.
    SecurityGroupId string
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    Id string
    The provider-assigned unique ID for this managed resource.
    PrivateAddress string
    Transient private Load Balancer IP address. It can change any time.
    SecurityGroupId string
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    id String
    The provider-assigned unique ID for this managed resource.
    privateAddress String
    Transient private Load Balancer IP address. It can change any time.
    securityGroupId String
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    id string
    The provider-assigned unique ID for this managed resource.
    privateAddress string
    Transient private Load Balancer IP address. It can change any time.
    securityGroupId string
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    id str
    The provider-assigned unique ID for this managed resource.
    private_address str
    Transient private Load Balancer IP address. It can change any time.
    security_group_id str
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    id String
    The provider-assigned unique ID for this managed resource.
    privateAddress String
    Transient private Load Balancer IP address. It can change any time.
    securityGroupId String
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.

    Look up Existing Loadbalancer Resource

    Get an existing Loadbalancer 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?: LoadbalancerState, opts?: CustomResourceOptions): Loadbalancer
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        disable_security_group_assignment: Optional[bool] = None,
        external_address: Optional[str] = None,
        listeners: Optional[Sequence[LoadbalancerListenerArgs]] = None,
        name: Optional[str] = None,
        networks: Optional[Sequence[LoadbalancerNetworkArgs]] = None,
        options: Optional[LoadbalancerOptionsArgs] = None,
        plan_id: Optional[str] = None,
        private_address: Optional[str] = None,
        project_id: Optional[str] = None,
        region: Optional[str] = None,
        security_group_id: Optional[str] = None,
        target_pools: Optional[Sequence[LoadbalancerTargetPoolArgs]] = None) -> Loadbalancer
    func GetLoadbalancer(ctx *Context, name string, id IDInput, state *LoadbalancerState, opts ...ResourceOption) (*Loadbalancer, error)
    public static Loadbalancer Get(string name, Input<string> id, LoadbalancerState? state, CustomResourceOptions? opts = null)
    public static Loadbalancer get(String name, Output<String> id, LoadbalancerState state, CustomResourceOptions options)
    resources:  _:    type: stackit:Loadbalancer    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:
    DisableSecurityGroupAssignment bool
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    ExternalAddress string
    External Load Balancer IP address where this Load Balancer is exposed.
    Listeners List<LoadbalancerListener>
    List of all listeners which will accept traffic. Limited to 20.
    Name string
    Load balancer name.
    Networks List<LoadbalancerNetwork>
    List of networks that listeners and targets reside in.
    Options LoadbalancerOptions
    Defines any optional functionality you want to have enabled on your load balancer.
    PlanId string
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    PrivateAddress string
    Transient private Load Balancer IP address. It can change any time.
    ProjectId string
    STACKIT project ID to which the Load Balancer is associated.
    Region string
    The resource region. If not defined, the provider region is used.
    SecurityGroupId string
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    TargetPools List<LoadbalancerTargetPool>
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    DisableSecurityGroupAssignment bool
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    ExternalAddress string
    External Load Balancer IP address where this Load Balancer is exposed.
    Listeners []LoadbalancerListenerArgs
    List of all listeners which will accept traffic. Limited to 20.
    Name string
    Load balancer name.
    Networks []LoadbalancerNetworkArgs
    List of networks that listeners and targets reside in.
    Options LoadbalancerOptionsArgs
    Defines any optional functionality you want to have enabled on your load balancer.
    PlanId string
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    PrivateAddress string
    Transient private Load Balancer IP address. It can change any time.
    ProjectId string
    STACKIT project ID to which the Load Balancer is associated.
    Region string
    The resource region. If not defined, the provider region is used.
    SecurityGroupId string
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    TargetPools []LoadbalancerTargetPoolArgs
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    disableSecurityGroupAssignment Boolean
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    externalAddress String
    External Load Balancer IP address where this Load Balancer is exposed.
    listeners List<LoadbalancerListener>
    List of all listeners which will accept traffic. Limited to 20.
    name String
    Load balancer name.
    networks List<LoadbalancerNetwork>
    List of networks that listeners and targets reside in.
    options LoadbalancerOptions
    Defines any optional functionality you want to have enabled on your load balancer.
    planId String
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    privateAddress String
    Transient private Load Balancer IP address. It can change any time.
    projectId String
    STACKIT project ID to which the Load Balancer is associated.
    region String
    The resource region. If not defined, the provider region is used.
    securityGroupId String
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    targetPools List<LoadbalancerTargetPool>
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    disableSecurityGroupAssignment boolean
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    externalAddress string
    External Load Balancer IP address where this Load Balancer is exposed.
    listeners LoadbalancerListener[]
    List of all listeners which will accept traffic. Limited to 20.
    name string
    Load balancer name.
    networks LoadbalancerNetwork[]
    List of networks that listeners and targets reside in.
    options LoadbalancerOptions
    Defines any optional functionality you want to have enabled on your load balancer.
    planId string
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    privateAddress string
    Transient private Load Balancer IP address. It can change any time.
    projectId string
    STACKIT project ID to which the Load Balancer is associated.
    region string
    The resource region. If not defined, the provider region is used.
    securityGroupId string
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    targetPools LoadbalancerTargetPool[]
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    disable_security_group_assignment bool
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    external_address str
    External Load Balancer IP address where this Load Balancer is exposed.
    listeners Sequence[LoadbalancerListenerArgs]
    List of all listeners which will accept traffic. Limited to 20.
    name str
    Load balancer name.
    networks Sequence[LoadbalancerNetworkArgs]
    List of networks that listeners and targets reside in.
    options LoadbalancerOptionsArgs
    Defines any optional functionality you want to have enabled on your load balancer.
    plan_id str
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    private_address str
    Transient private Load Balancer IP address. It can change any time.
    project_id str
    STACKIT project ID to which the Load Balancer is associated.
    region str
    The resource region. If not defined, the provider region is used.
    security_group_id str
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    target_pools Sequence[LoadbalancerTargetPoolArgs]
    List of all target pools which will be used in the Load Balancer. Limited to 20.
    disableSecurityGroupAssignment Boolean
    If set to true, this will disable the automatic assignment of a security group to the load balancer's targets. This option is primarily used to allow targets that are not within the load balancer's own network or SNA (STACKIT network area). When this is enabled, you are fully responsible for ensuring network connectivity to the targets, including managing all routing and security group rules manually. This setting cannot be changed after the load balancer is created.
    externalAddress String
    External Load Balancer IP address where this Load Balancer is exposed.
    listeners List<Property Map>
    List of all listeners which will accept traffic. Limited to 20.
    name String
    Load balancer name.
    networks List<Property Map>
    List of networks that listeners and targets reside in.
    options Property Map
    Defines any optional functionality you want to have enabled on your load balancer.
    planId String
    The service plan ID. If not defined, the default service plan is p10. Possible values are: p10, p50, p250, p750.
    privateAddress String
    Transient private Load Balancer IP address. It can change any time.
    projectId String
    STACKIT project ID to which the Load Balancer is associated.
    region String
    The resource region. If not defined, the provider region is used.
    securityGroupId String
    The ID of the egress security group assigned to the Load Balancer's internal machines. This ID is essential for allowing traffic from the Load Balancer to targets in different networks or STACKIT network areas (SNA). To enable this, create a security group rule for your target VMs and set the remote_security_group_id of that rule to this value. This is typically used when disable_security_group_assignment is set to true.
    targetPools List<Property Map>
    List of all target pools which will be used in the Load Balancer. Limited to 20.

    Supporting Types

    LoadbalancerListener, LoadbalancerListenerArgs

    Port int
    Port number where we listen for traffic.
    Protocol string
    Protocol is the highest network protocol we understand to load balance. Possible values are: PROTOCOL_UNSPECIFIED, PROTOCOL_TCP, PROTOCOL_UDP, PROTOCOL_TCP_PROXY, PROTOCOL_TLS_PASSTHROUGH.
    TargetPool string
    Reference target pool by target pool name.
    DisplayName string
    ServerNameIndicators List<LoadbalancerListenerServerNameIndicator>
    A list of domain names to match in order to pass TLS traffic to the target pool in the current listener
    Tcp LoadbalancerListenerTcp
    Options that are specific to the TCP protocol.
    Udp LoadbalancerListenerUdp
    Options that are specific to the UDP protocol.
    Port int
    Port number where we listen for traffic.
    Protocol string
    Protocol is the highest network protocol we understand to load balance. Possible values are: PROTOCOL_UNSPECIFIED, PROTOCOL_TCP, PROTOCOL_UDP, PROTOCOL_TCP_PROXY, PROTOCOL_TLS_PASSTHROUGH.
    TargetPool string
    Reference target pool by target pool name.
    DisplayName string
    ServerNameIndicators []LoadbalancerListenerServerNameIndicator
    A list of domain names to match in order to pass TLS traffic to the target pool in the current listener
    Tcp LoadbalancerListenerTcp
    Options that are specific to the TCP protocol.
    Udp LoadbalancerListenerUdp
    Options that are specific to the UDP protocol.
    port Integer
    Port number where we listen for traffic.
    protocol String
    Protocol is the highest network protocol we understand to load balance. Possible values are: PROTOCOL_UNSPECIFIED, PROTOCOL_TCP, PROTOCOL_UDP, PROTOCOL_TCP_PROXY, PROTOCOL_TLS_PASSTHROUGH.
    targetPool String
    Reference target pool by target pool name.
    displayName String
    serverNameIndicators List<LoadbalancerListenerServerNameIndicator>
    A list of domain names to match in order to pass TLS traffic to the target pool in the current listener
    tcp LoadbalancerListenerTcp
    Options that are specific to the TCP protocol.
    udp LoadbalancerListenerUdp
    Options that are specific to the UDP protocol.
    port number
    Port number where we listen for traffic.
    protocol string
    Protocol is the highest network protocol we understand to load balance. Possible values are: PROTOCOL_UNSPECIFIED, PROTOCOL_TCP, PROTOCOL_UDP, PROTOCOL_TCP_PROXY, PROTOCOL_TLS_PASSTHROUGH.
    targetPool string
    Reference target pool by target pool name.
    displayName string
    serverNameIndicators LoadbalancerListenerServerNameIndicator[]
    A list of domain names to match in order to pass TLS traffic to the target pool in the current listener
    tcp LoadbalancerListenerTcp
    Options that are specific to the TCP protocol.
    udp LoadbalancerListenerUdp
    Options that are specific to the UDP protocol.
    port int
    Port number where we listen for traffic.
    protocol str
    Protocol is the highest network protocol we understand to load balance. Possible values are: PROTOCOL_UNSPECIFIED, PROTOCOL_TCP, PROTOCOL_UDP, PROTOCOL_TCP_PROXY, PROTOCOL_TLS_PASSTHROUGH.
    target_pool str
    Reference target pool by target pool name.
    display_name str
    server_name_indicators Sequence[LoadbalancerListenerServerNameIndicator]
    A list of domain names to match in order to pass TLS traffic to the target pool in the current listener
    tcp LoadbalancerListenerTcp
    Options that are specific to the TCP protocol.
    udp LoadbalancerListenerUdp
    Options that are specific to the UDP protocol.
    port Number
    Port number where we listen for traffic.
    protocol String
    Protocol is the highest network protocol we understand to load balance. Possible values are: PROTOCOL_UNSPECIFIED, PROTOCOL_TCP, PROTOCOL_UDP, PROTOCOL_TCP_PROXY, PROTOCOL_TLS_PASSTHROUGH.
    targetPool String
    Reference target pool by target pool name.
    displayName String
    serverNameIndicators List<Property Map>
    A list of domain names to match in order to pass TLS traffic to the target pool in the current listener
    tcp Property Map
    Options that are specific to the TCP protocol.
    udp Property Map
    Options that are specific to the UDP protocol.

    LoadbalancerListenerServerNameIndicator, LoadbalancerListenerServerNameIndicatorArgs

    Name string
    A domain name to match in order to pass TLS traffic to the target pool in the current listener
    Name string
    A domain name to match in order to pass TLS traffic to the target pool in the current listener
    name String
    A domain name to match in order to pass TLS traffic to the target pool in the current listener
    name string
    A domain name to match in order to pass TLS traffic to the target pool in the current listener
    name str
    A domain name to match in order to pass TLS traffic to the target pool in the current listener
    name String
    A domain name to match in order to pass TLS traffic to the target pool in the current listener

    LoadbalancerListenerTcp, LoadbalancerListenerTcpArgs

    IdleTimeout string
    Time after which an idle connection is closed. The default value is set to 300 seconds, and the maximum value is 3600 seconds. The format is a duration and the unit must be seconds. Example: 30s
    IdleTimeout string
    Time after which an idle connection is closed. The default value is set to 300 seconds, and the maximum value is 3600 seconds. The format is a duration and the unit must be seconds. Example: 30s
    idleTimeout String
    Time after which an idle connection is closed. The default value is set to 300 seconds, and the maximum value is 3600 seconds. The format is a duration and the unit must be seconds. Example: 30s
    idleTimeout string
    Time after which an idle connection is closed. The default value is set to 300 seconds, and the maximum value is 3600 seconds. The format is a duration and the unit must be seconds. Example: 30s
    idle_timeout str
    Time after which an idle connection is closed. The default value is set to 300 seconds, and the maximum value is 3600 seconds. The format is a duration and the unit must be seconds. Example: 30s
    idleTimeout String
    Time after which an idle connection is closed. The default value is set to 300 seconds, and the maximum value is 3600 seconds. The format is a duration and the unit must be seconds. Example: 30s

    LoadbalancerListenerUdp, LoadbalancerListenerUdpArgs

    IdleTimeout string
    Time after which an idle session is closed. The default value is set to 1 minute, and the maximum value is 2 minutes. The format is a duration and the unit must be seconds. Example: 30s
    IdleTimeout string
    Time after which an idle session is closed. The default value is set to 1 minute, and the maximum value is 2 minutes. The format is a duration and the unit must be seconds. Example: 30s
    idleTimeout String
    Time after which an idle session is closed. The default value is set to 1 minute, and the maximum value is 2 minutes. The format is a duration and the unit must be seconds. Example: 30s
    idleTimeout string
    Time after which an idle session is closed. The default value is set to 1 minute, and the maximum value is 2 minutes. The format is a duration and the unit must be seconds. Example: 30s
    idle_timeout str
    Time after which an idle session is closed. The default value is set to 1 minute, and the maximum value is 2 minutes. The format is a duration and the unit must be seconds. Example: 30s
    idleTimeout String
    Time after which an idle session is closed. The default value is set to 1 minute, and the maximum value is 2 minutes. The format is a duration and the unit must be seconds. Example: 30s

    LoadbalancerNetwork, LoadbalancerNetworkArgs

    NetworkId string
    Openstack network ID.
    Role string
    The role defines how the load balancer is using the network. Possible values are: ROLE_UNSPECIFIED, ROLE_LISTENERS_AND_TARGETS, ROLE_LISTENERS, ROLE_TARGETS.
    NetworkId string
    Openstack network ID.
    Role string
    The role defines how the load balancer is using the network. Possible values are: ROLE_UNSPECIFIED, ROLE_LISTENERS_AND_TARGETS, ROLE_LISTENERS, ROLE_TARGETS.
    networkId String
    Openstack network ID.
    role String
    The role defines how the load balancer is using the network. Possible values are: ROLE_UNSPECIFIED, ROLE_LISTENERS_AND_TARGETS, ROLE_LISTENERS, ROLE_TARGETS.
    networkId string
    Openstack network ID.
    role string
    The role defines how the load balancer is using the network. Possible values are: ROLE_UNSPECIFIED, ROLE_LISTENERS_AND_TARGETS, ROLE_LISTENERS, ROLE_TARGETS.
    network_id str
    Openstack network ID.
    role str
    The role defines how the load balancer is using the network. Possible values are: ROLE_UNSPECIFIED, ROLE_LISTENERS_AND_TARGETS, ROLE_LISTENERS, ROLE_TARGETS.
    networkId String
    Openstack network ID.
    role String
    The role defines how the load balancer is using the network. Possible values are: ROLE_UNSPECIFIED, ROLE_LISTENERS_AND_TARGETS, ROLE_LISTENERS, ROLE_TARGETS.

    LoadbalancerOptions, LoadbalancerOptionsArgs

    Acls List<string>
    Load Balancer is accessible only from an IP address in this range.
    Observability LoadbalancerOptionsObservability
    We offer Load Balancer metrics observability via ARGUS or external solutions. Not changeable after creation.
    PrivateNetworkOnly bool
    If true, Load Balancer is accessible only via a private network IP address.
    Acls []string
    Load Balancer is accessible only from an IP address in this range.
    Observability LoadbalancerOptionsObservability
    We offer Load Balancer metrics observability via ARGUS or external solutions. Not changeable after creation.
    PrivateNetworkOnly bool
    If true, Load Balancer is accessible only via a private network IP address.
    acls List<String>
    Load Balancer is accessible only from an IP address in this range.
    observability LoadbalancerOptionsObservability
    We offer Load Balancer metrics observability via ARGUS or external solutions. Not changeable after creation.
    privateNetworkOnly Boolean
    If true, Load Balancer is accessible only via a private network IP address.
    acls string[]
    Load Balancer is accessible only from an IP address in this range.
    observability LoadbalancerOptionsObservability
    We offer Load Balancer metrics observability via ARGUS or external solutions. Not changeable after creation.
    privateNetworkOnly boolean
    If true, Load Balancer is accessible only via a private network IP address.
    acls Sequence[str]
    Load Balancer is accessible only from an IP address in this range.
    observability LoadbalancerOptionsObservability
    We offer Load Balancer metrics observability via ARGUS or external solutions. Not changeable after creation.
    private_network_only bool
    If true, Load Balancer is accessible only via a private network IP address.
    acls List<String>
    Load Balancer is accessible only from an IP address in this range.
    observability Property Map
    We offer Load Balancer metrics observability via ARGUS or external solutions. Not changeable after creation.
    privateNetworkOnly Boolean
    If true, Load Balancer is accessible only via a private network IP address.

    LoadbalancerOptionsObservability, LoadbalancerOptionsObservabilityArgs

    Logs LoadbalancerOptionsObservabilityLogs
    Observability logs configuration. Not changeable after creation.
    Metrics LoadbalancerOptionsObservabilityMetrics
    Observability metrics configuration. Not changeable after creation.
    Logs LoadbalancerOptionsObservabilityLogs
    Observability logs configuration. Not changeable after creation.
    Metrics LoadbalancerOptionsObservabilityMetrics
    Observability metrics configuration. Not changeable after creation.
    logs LoadbalancerOptionsObservabilityLogs
    Observability logs configuration. Not changeable after creation.
    metrics LoadbalancerOptionsObservabilityMetrics
    Observability metrics configuration. Not changeable after creation.
    logs LoadbalancerOptionsObservabilityLogs
    Observability logs configuration. Not changeable after creation.
    metrics LoadbalancerOptionsObservabilityMetrics
    Observability metrics configuration. Not changeable after creation.
    logs LoadbalancerOptionsObservabilityLogs
    Observability logs configuration. Not changeable after creation.
    metrics LoadbalancerOptionsObservabilityMetrics
    Observability metrics configuration. Not changeable after creation.
    logs Property Map
    Observability logs configuration. Not changeable after creation.
    metrics Property Map
    Observability metrics configuration. Not changeable after creation.

    LoadbalancerOptionsObservabilityLogs, LoadbalancerOptionsObservabilityLogsArgs

    CredentialsRef string
    Credentials reference for logs. Not changeable after creation.
    PushUrl string
    Credentials reference for logs. Not changeable after creation.
    CredentialsRef string
    Credentials reference for logs. Not changeable after creation.
    PushUrl string
    Credentials reference for logs. Not changeable after creation.
    credentialsRef String
    Credentials reference for logs. Not changeable after creation.
    pushUrl String
    Credentials reference for logs. Not changeable after creation.
    credentialsRef string
    Credentials reference for logs. Not changeable after creation.
    pushUrl string
    Credentials reference for logs. Not changeable after creation.
    credentials_ref str
    Credentials reference for logs. Not changeable after creation.
    push_url str
    Credentials reference for logs. Not changeable after creation.
    credentialsRef String
    Credentials reference for logs. Not changeable after creation.
    pushUrl String
    Credentials reference for logs. Not changeable after creation.

    LoadbalancerOptionsObservabilityMetrics, LoadbalancerOptionsObservabilityMetricsArgs

    CredentialsRef string
    Credentials reference for metrics. Not changeable after creation.
    PushUrl string
    Credentials reference for metrics. Not changeable after creation.
    CredentialsRef string
    Credentials reference for metrics. Not changeable after creation.
    PushUrl string
    Credentials reference for metrics. Not changeable after creation.
    credentialsRef String
    Credentials reference for metrics. Not changeable after creation.
    pushUrl String
    Credentials reference for metrics. Not changeable after creation.
    credentialsRef string
    Credentials reference for metrics. Not changeable after creation.
    pushUrl string
    Credentials reference for metrics. Not changeable after creation.
    credentials_ref str
    Credentials reference for metrics. Not changeable after creation.
    push_url str
    Credentials reference for metrics. Not changeable after creation.
    credentialsRef String
    Credentials reference for metrics. Not changeable after creation.
    pushUrl String
    Credentials reference for metrics. Not changeable after creation.

    LoadbalancerTargetPool, LoadbalancerTargetPoolArgs

    Name string
    Target pool name.
    TargetPort int
    Identical port number where each target listens for traffic.
    Targets List<LoadbalancerTargetPoolTarget>
    List of all targets which will be used in the pool. Limited to 1000.
    ActiveHealthCheck LoadbalancerTargetPoolActiveHealthCheck
    SessionPersistence LoadbalancerTargetPoolSessionPersistence
    Here you can setup various session persistence options, so far only "use_source_ip_address" is supported.
    Name string
    Target pool name.
    TargetPort int
    Identical port number where each target listens for traffic.
    Targets []LoadbalancerTargetPoolTarget
    List of all targets which will be used in the pool. Limited to 1000.
    ActiveHealthCheck LoadbalancerTargetPoolActiveHealthCheck
    SessionPersistence LoadbalancerTargetPoolSessionPersistence
    Here you can setup various session persistence options, so far only "use_source_ip_address" is supported.
    name String
    Target pool name.
    targetPort Integer
    Identical port number where each target listens for traffic.
    targets List<LoadbalancerTargetPoolTarget>
    List of all targets which will be used in the pool. Limited to 1000.
    activeHealthCheck LoadbalancerTargetPoolActiveHealthCheck
    sessionPersistence LoadbalancerTargetPoolSessionPersistence
    Here you can setup various session persistence options, so far only "use_source_ip_address" is supported.
    name string
    Target pool name.
    targetPort number
    Identical port number where each target listens for traffic.
    targets LoadbalancerTargetPoolTarget[]
    List of all targets which will be used in the pool. Limited to 1000.
    activeHealthCheck LoadbalancerTargetPoolActiveHealthCheck
    sessionPersistence LoadbalancerTargetPoolSessionPersistence
    Here you can setup various session persistence options, so far only "use_source_ip_address" is supported.
    name str
    Target pool name.
    target_port int
    Identical port number where each target listens for traffic.
    targets Sequence[LoadbalancerTargetPoolTarget]
    List of all targets which will be used in the pool. Limited to 1000.
    active_health_check LoadbalancerTargetPoolActiveHealthCheck
    session_persistence LoadbalancerTargetPoolSessionPersistence
    Here you can setup various session persistence options, so far only "use_source_ip_address" is supported.
    name String
    Target pool name.
    targetPort Number
    Identical port number where each target listens for traffic.
    targets List<Property Map>
    List of all targets which will be used in the pool. Limited to 1000.
    activeHealthCheck Property Map
    sessionPersistence Property Map
    Here you can setup various session persistence options, so far only "use_source_ip_address" is supported.

    LoadbalancerTargetPoolActiveHealthCheck, LoadbalancerTargetPoolActiveHealthCheckArgs

    HealthyThreshold int
    Healthy threshold of the health checking.
    Interval string
    Interval duration of health checking in seconds.
    IntervalJitter string
    Interval duration threshold of the health checking in seconds.
    Timeout string
    Active health checking timeout duration in seconds.
    UnhealthyThreshold int
    Unhealthy threshold of the health checking.
    HealthyThreshold int
    Healthy threshold of the health checking.
    Interval string
    Interval duration of health checking in seconds.
    IntervalJitter string
    Interval duration threshold of the health checking in seconds.
    Timeout string
    Active health checking timeout duration in seconds.
    UnhealthyThreshold int
    Unhealthy threshold of the health checking.
    healthyThreshold Integer
    Healthy threshold of the health checking.
    interval String
    Interval duration of health checking in seconds.
    intervalJitter String
    Interval duration threshold of the health checking in seconds.
    timeout String
    Active health checking timeout duration in seconds.
    unhealthyThreshold Integer
    Unhealthy threshold of the health checking.
    healthyThreshold number
    Healthy threshold of the health checking.
    interval string
    Interval duration of health checking in seconds.
    intervalJitter string
    Interval duration threshold of the health checking in seconds.
    timeout string
    Active health checking timeout duration in seconds.
    unhealthyThreshold number
    Unhealthy threshold of the health checking.
    healthy_threshold int
    Healthy threshold of the health checking.
    interval str
    Interval duration of health checking in seconds.
    interval_jitter str
    Interval duration threshold of the health checking in seconds.
    timeout str
    Active health checking timeout duration in seconds.
    unhealthy_threshold int
    Unhealthy threshold of the health checking.
    healthyThreshold Number
    Healthy threshold of the health checking.
    interval String
    Interval duration of health checking in seconds.
    intervalJitter String
    Interval duration threshold of the health checking in seconds.
    timeout String
    Active health checking timeout duration in seconds.
    unhealthyThreshold Number
    Unhealthy threshold of the health checking.

    LoadbalancerTargetPoolSessionPersistence, LoadbalancerTargetPoolSessionPersistenceArgs

    UseSourceIpAddress bool
    If true then all connections from one source IP address are redirected to the same target. This setting changes the load balancing algorithm to Maglev.
    UseSourceIpAddress bool
    If true then all connections from one source IP address are redirected to the same target. This setting changes the load balancing algorithm to Maglev.
    useSourceIpAddress Boolean
    If true then all connections from one source IP address are redirected to the same target. This setting changes the load balancing algorithm to Maglev.
    useSourceIpAddress boolean
    If true then all connections from one source IP address are redirected to the same target. This setting changes the load balancing algorithm to Maglev.
    use_source_ip_address bool
    If true then all connections from one source IP address are redirected to the same target. This setting changes the load balancing algorithm to Maglev.
    useSourceIpAddress Boolean
    If true then all connections from one source IP address are redirected to the same target. This setting changes the load balancing algorithm to Maglev.

    LoadbalancerTargetPoolTarget, LoadbalancerTargetPoolTargetArgs

    DisplayName string
    Target display name
    Ip string
    Target IP
    DisplayName string
    Target display name
    Ip string
    Target IP
    displayName String
    Target display name
    ip String
    Target IP
    displayName string
    Target display name
    ip string
    Target IP
    display_name str
    Target display name
    ip str
    Target IP
    displayName String
    Target display name
    ip String
    Target IP

    Package Details

    Repository
    stackit stackitcloud/pulumi-stackit
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the stackit Terraform Provider.
    stackit logo
    Viewing docs for stackit v0.0.4
    published on Friday, Feb 20, 2026 by stackitcloud
    Schema (JSON)
    stackitcloud/pulumi-stackit
      Try Pulumi Cloud free. Your team will thank you.