Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. UpCloud
  3. API Docs
  4. LoadbalancerBackend
UpCloud v0.2.0 published on Wednesday, Apr 16, 2025 by UpCloudLtd
UpCloudLtd/pulumi-upcloud

upcloud.LoadbalancerBackend

Explore with Pulumi AI

UpCloud v0.2.0 published on Wednesday, Apr 16, 2025 by UpCloudLtd
UpCloudLtd/pulumi-upcloud

This resource represents load balancer backend service.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as upcloud from "@upcloud/pulumi-upcloud";

const config = new pulumi.Config();
const lbZone = config.get("lbZone") || "fi-hel2";
const lbNetwork = new upcloud.Network("lb_network", {
    name: "lb-test-net",
    zone: lbZone,
    ipNetwork: {
        address: "10.0.0.0/24",
        dhcp: true,
        family: "IPv4",
    },
});
const lb = new upcloud.Loadbalancer("lb", {
    configuredStatus: "started",
    name: "lb-test",
    plan: "development",
    zone: lbZone,
    network: upcloudNetwork.lbNetwork.id,
});
const lbBe1 = new upcloud.LoadbalancerBackend("lb_be_1", {
    loadbalancer: upcloudLoadbalancer.lb.id,
    name: "lb-be-1-test",
});
Copy
import pulumi
import pulumi_upcloud as upcloud

config = pulumi.Config()
lb_zone = config.get("lbZone")
if lb_zone is None:
    lb_zone = "fi-hel2"
lb_network = upcloud.Network("lb_network",
    name="lb-test-net",
    zone=lb_zone,
    ip_network={
        "address": "10.0.0.0/24",
        "dhcp": True,
        "family": "IPv4",
    })
lb = upcloud.Loadbalancer("lb",
    configured_status="started",
    name="lb-test",
    plan="development",
    zone=lb_zone,
    network=upcloud_network["lbNetwork"]["id"])
lb_be1 = upcloud.LoadbalancerBackend("lb_be_1",
    loadbalancer=upcloud_loadbalancer["lb"]["id"],
    name="lb-be-1-test")
Copy
package main

import (
	"github.com/UpCloudLtd/pulumi-upcloud/sdk/go/upcloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		lbZone := "fi-hel2"
		if param := cfg.Get("lbZone"); param != "" {
			lbZone = param
		}
		_, err := upcloud.NewNetwork(ctx, "lb_network", &upcloud.NetworkArgs{
			Name: pulumi.String("lb-test-net"),
			Zone: pulumi.String(lbZone),
			IpNetwork: &upcloud.NetworkIpNetworkArgs{
				Address: pulumi.String("10.0.0.0/24"),
				Dhcp:    pulumi.Bool(true),
				Family:  pulumi.String("IPv4"),
			},
		})
		if err != nil {
			return err
		}
		_, err = upcloud.NewLoadbalancer(ctx, "lb", &upcloud.LoadbalancerArgs{
			ConfiguredStatus: pulumi.String("started"),
			Name:             pulumi.String("lb-test"),
			Plan:             pulumi.String("development"),
			Zone:             pulumi.String(lbZone),
			Network:          pulumi.Any(upcloudNetwork.LbNetwork.Id),
		})
		if err != nil {
			return err
		}
		_, err = upcloud.NewLoadbalancerBackend(ctx, "lb_be_1", &upcloud.LoadbalancerBackendArgs{
			Loadbalancer: pulumi.Any(upcloudLoadbalancer.Lb.Id),
			Name:         pulumi.String("lb-be-1-test"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using UpCloud = UpCloud.Pulumi.UpCloud;

return await Deployment.RunAsync(() => 
{
    var config = new Config();
    var lbZone = config.Get("lbZone") ?? "fi-hel2";
    var lbNetwork = new UpCloud.Network("lb_network", new()
    {
        Name = "lb-test-net",
        Zone = lbZone,
        IpNetwork = new UpCloud.Inputs.NetworkIpNetworkArgs
        {
            Address = "10.0.0.0/24",
            Dhcp = true,
            Family = "IPv4",
        },
    });

    var lb = new UpCloud.Loadbalancer("lb", new()
    {
        ConfiguredStatus = "started",
        Name = "lb-test",
        Plan = "development",
        Zone = lbZone,
        Network = upcloudNetwork.LbNetwork.Id,
    });

    var lbBe1 = new UpCloud.LoadbalancerBackend("lb_be_1", new()
    {
        Loadbalancer = upcloudLoadbalancer.Lb.Id,
        Name = "lb-be-1-test",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.upcloud.Network;
import com.pulumi.upcloud.NetworkArgs;
import com.pulumi.upcloud.inputs.NetworkIpNetworkArgs;
import com.pulumi.upcloud.Loadbalancer;
import com.pulumi.upcloud.LoadbalancerArgs;
import com.pulumi.upcloud.LoadbalancerBackend;
import com.pulumi.upcloud.LoadbalancerBackendArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        final var config = ctx.config();
        final var lbZone = config.get("lbZone").orElse("fi-hel2");
        var lbNetwork = new Network("lbNetwork", NetworkArgs.builder()
            .name("lb-test-net")
            .zone(lbZone)
            .ipNetwork(NetworkIpNetworkArgs.builder()
                .address("10.0.0.0/24")
                .dhcp(true)
                .family("IPv4")
                .build())
            .build());

        var lb = new Loadbalancer("lb", LoadbalancerArgs.builder()
            .configuredStatus("started")
            .name("lb-test")
            .plan("development")
            .zone(lbZone)
            .network(upcloudNetwork.lbNetwork().id())
            .build());

        var lbBe1 = new LoadbalancerBackend("lbBe1", LoadbalancerBackendArgs.builder()
            .loadbalancer(upcloudLoadbalancer.lb().id())
            .name("lb-be-1-test")
            .build());

    }
}
Copy
configuration:
  lbZone:
    type: string
    default: fi-hel2
resources:
  lbNetwork:
    type: upcloud:Network
    name: lb_network
    properties:
      name: lb-test-net
      zone: ${lbZone}
      ipNetwork:
        address: 10.0.0.0/24
        dhcp: true
        family: IPv4
  lb:
    type: upcloud:Loadbalancer
    properties:
      configuredStatus: started
      name: lb-test
      plan: development
      zone: ${lbZone}
      network: ${upcloudNetwork.lbNetwork.id}
  lbBe1:
    type: upcloud:LoadbalancerBackend
    name: lb_be_1
    properties:
      loadbalancer: ${upcloudLoadbalancer.lb.id}
      name: lb-be-1-test
Copy

Create LoadbalancerBackend Resource

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

Constructor syntax

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

@overload
def LoadbalancerBackend(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        loadbalancer: Optional[str] = None,
                        name: Optional[str] = None,
                        properties: Optional[LoadbalancerBackendPropertiesArgs] = None,
                        resolver_name: Optional[str] = None)
func NewLoadbalancerBackend(ctx *Context, name string, args LoadbalancerBackendArgs, opts ...ResourceOption) (*LoadbalancerBackend, error)
public LoadbalancerBackend(string name, LoadbalancerBackendArgs args, CustomResourceOptions? opts = null)
public LoadbalancerBackend(String name, LoadbalancerBackendArgs args)
public LoadbalancerBackend(String name, LoadbalancerBackendArgs args, CustomResourceOptions options)

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

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. LoadbalancerBackendArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. LoadbalancerBackendArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. LoadbalancerBackendArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. LoadbalancerBackendArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. LoadbalancerBackendArgs
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 loadbalancerBackendResource = new UpCloud.LoadbalancerBackend("loadbalancerBackendResource", new()
{
    Loadbalancer = "string",
    Name = "string",
    Properties = new UpCloud.Inputs.LoadbalancerBackendPropertiesArgs
    {
        HealthCheckExpectedStatus = 0,
        HealthCheckFall = 0,
        HealthCheckInterval = 0,
        HealthCheckRise = 0,
        HealthCheckTlsVerify = false,
        HealthCheckType = "string",
        HealthCheckUrl = "string",
        Http2Enabled = false,
        OutboundProxyProtocol = "string",
        StickySessionCookieName = "string",
        TimeoutServer = 0,
        TimeoutTunnel = 0,
        TlsEnabled = false,
        TlsUseSystemCa = false,
        TlsVerify = false,
    },
    ResolverName = "string",
});
Copy
example, err := upcloud.NewLoadbalancerBackend(ctx, "loadbalancerBackendResource", &upcloud.LoadbalancerBackendArgs{
	Loadbalancer: pulumi.String("string"),
	Name:         pulumi.String("string"),
	Properties: &upcloud.LoadbalancerBackendPropertiesArgs{
		HealthCheckExpectedStatus: pulumi.Int(0),
		HealthCheckFall:           pulumi.Int(0),
		HealthCheckInterval:       pulumi.Int(0),
		HealthCheckRise:           pulumi.Int(0),
		HealthCheckTlsVerify:      pulumi.Bool(false),
		HealthCheckType:           pulumi.String("string"),
		HealthCheckUrl:            pulumi.String("string"),
		Http2Enabled:              pulumi.Bool(false),
		OutboundProxyProtocol:     pulumi.String("string"),
		StickySessionCookieName:   pulumi.String("string"),
		TimeoutServer:             pulumi.Int(0),
		TimeoutTunnel:             pulumi.Int(0),
		TlsEnabled:                pulumi.Bool(false),
		TlsUseSystemCa:            pulumi.Bool(false),
		TlsVerify:                 pulumi.Bool(false),
	},
	ResolverName: pulumi.String("string"),
})
Copy
var loadbalancerBackendResource = new LoadbalancerBackend("loadbalancerBackendResource", LoadbalancerBackendArgs.builder()
    .loadbalancer("string")
    .name("string")
    .properties(LoadbalancerBackendPropertiesArgs.builder()
        .healthCheckExpectedStatus(0)
        .healthCheckFall(0)
        .healthCheckInterval(0)
        .healthCheckRise(0)
        .healthCheckTlsVerify(false)
        .healthCheckType("string")
        .healthCheckUrl("string")
        .http2Enabled(false)
        .outboundProxyProtocol("string")
        .stickySessionCookieName("string")
        .timeoutServer(0)
        .timeoutTunnel(0)
        .tlsEnabled(false)
        .tlsUseSystemCa(false)
        .tlsVerify(false)
        .build())
    .resolverName("string")
    .build());
Copy
loadbalancer_backend_resource = upcloud.LoadbalancerBackend("loadbalancerBackendResource",
    loadbalancer="string",
    name="string",
    properties={
        "health_check_expected_status": 0,
        "health_check_fall": 0,
        "health_check_interval": 0,
        "health_check_rise": 0,
        "health_check_tls_verify": False,
        "health_check_type": "string",
        "health_check_url": "string",
        "http2_enabled": False,
        "outbound_proxy_protocol": "string",
        "sticky_session_cookie_name": "string",
        "timeout_server": 0,
        "timeout_tunnel": 0,
        "tls_enabled": False,
        "tls_use_system_ca": False,
        "tls_verify": False,
    },
    resolver_name="string")
Copy
const loadbalancerBackendResource = new upcloud.LoadbalancerBackend("loadbalancerBackendResource", {
    loadbalancer: "string",
    name: "string",
    properties: {
        healthCheckExpectedStatus: 0,
        healthCheckFall: 0,
        healthCheckInterval: 0,
        healthCheckRise: 0,
        healthCheckTlsVerify: false,
        healthCheckType: "string",
        healthCheckUrl: "string",
        http2Enabled: false,
        outboundProxyProtocol: "string",
        stickySessionCookieName: "string",
        timeoutServer: 0,
        timeoutTunnel: 0,
        tlsEnabled: false,
        tlsUseSystemCa: false,
        tlsVerify: false,
    },
    resolverName: "string",
});
Copy
type: upcloud:LoadbalancerBackend
properties:
    loadbalancer: string
    name: string
    properties:
        healthCheckExpectedStatus: 0
        healthCheckFall: 0
        healthCheckInterval: 0
        healthCheckRise: 0
        healthCheckTlsVerify: false
        healthCheckType: string
        healthCheckUrl: string
        http2Enabled: false
        outboundProxyProtocol: string
        stickySessionCookieName: string
        timeoutServer: 0
        timeoutTunnel: 0
        tlsEnabled: false
        tlsUseSystemCa: false
        tlsVerify: false
    resolverName: string
Copy

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

Loadbalancer This property is required. string
UUID of the load balancer to which the backend is connected.
Name string
The name of the backend. Must be unique within the load balancer service.
Properties UpCloud.Pulumi.UpCloud.Inputs.LoadbalancerBackendProperties
ResolverName string
Domain name resolver used with dynamic type members.
Loadbalancer This property is required. string
UUID of the load balancer to which the backend is connected.
Name string
The name of the backend. Must be unique within the load balancer service.
Properties LoadbalancerBackendPropertiesArgs
ResolverName string
Domain name resolver used with dynamic type members.
loadbalancer This property is required. String
UUID of the load balancer to which the backend is connected.
name String
The name of the backend. Must be unique within the load balancer service.
properties LoadbalancerBackendProperties
resolverName String
Domain name resolver used with dynamic type members.
loadbalancer This property is required. string
UUID of the load balancer to which the backend is connected.
name string
The name of the backend. Must be unique within the load balancer service.
properties LoadbalancerBackendProperties
resolverName string
Domain name resolver used with dynamic type members.
loadbalancer This property is required. str
UUID of the load balancer to which the backend is connected.
name str
The name of the backend. Must be unique within the load balancer service.
properties LoadbalancerBackendPropertiesArgs
resolver_name str
Domain name resolver used with dynamic type members.
loadbalancer This property is required. String
UUID of the load balancer to which the backend is connected.
name String
The name of the backend. Must be unique within the load balancer service.
properties Property Map
resolverName String
Domain name resolver used with dynamic type members.

Outputs

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

Id string
The provider-assigned unique ID for this managed resource.
Members List<string>
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
TlsConfigs List<string>
Set of TLS config names.
Id string
The provider-assigned unique ID for this managed resource.
Members []string
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
TlsConfigs []string
Set of TLS config names.
id String
The provider-assigned unique ID for this managed resource.
members List<String>
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
tlsConfigs List<String>
Set of TLS config names.
id string
The provider-assigned unique ID for this managed resource.
members string[]
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
tlsConfigs string[]
Set of TLS config names.
id str
The provider-assigned unique ID for this managed resource.
members Sequence[str]
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
tls_configs Sequence[str]
Set of TLS config names.
id String
The provider-assigned unique ID for this managed resource.
members List<String>
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
tlsConfigs List<String>
Set of TLS config names.

Look up Existing LoadbalancerBackend Resource

Get an existing LoadbalancerBackend 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?: LoadbalancerBackendState, opts?: CustomResourceOptions): LoadbalancerBackend
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        loadbalancer: Optional[str] = None,
        members: Optional[Sequence[str]] = None,
        name: Optional[str] = None,
        properties: Optional[LoadbalancerBackendPropertiesArgs] = None,
        resolver_name: Optional[str] = None,
        tls_configs: Optional[Sequence[str]] = None) -> LoadbalancerBackend
func GetLoadbalancerBackend(ctx *Context, name string, id IDInput, state *LoadbalancerBackendState, opts ...ResourceOption) (*LoadbalancerBackend, error)
public static LoadbalancerBackend Get(string name, Input<string> id, LoadbalancerBackendState? state, CustomResourceOptions? opts = null)
public static LoadbalancerBackend get(String name, Output<String> id, LoadbalancerBackendState state, CustomResourceOptions options)
resources:  _:    type: upcloud:LoadbalancerBackend    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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:
Loadbalancer string
UUID of the load balancer to which the backend is connected.
Members List<string>
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
Name string
The name of the backend. Must be unique within the load balancer service.
Properties UpCloud.Pulumi.UpCloud.Inputs.LoadbalancerBackendProperties
ResolverName string
Domain name resolver used with dynamic type members.
TlsConfigs List<string>
Set of TLS config names.
Loadbalancer string
UUID of the load balancer to which the backend is connected.
Members []string
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
Name string
The name of the backend. Must be unique within the load balancer service.
Properties LoadbalancerBackendPropertiesArgs
ResolverName string
Domain name resolver used with dynamic type members.
TlsConfigs []string
Set of TLS config names.
loadbalancer String
UUID of the load balancer to which the backend is connected.
members List<String>
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
name String
The name of the backend. Must be unique within the load balancer service.
properties LoadbalancerBackendProperties
resolverName String
Domain name resolver used with dynamic type members.
tlsConfigs List<String>
Set of TLS config names.
loadbalancer string
UUID of the load balancer to which the backend is connected.
members string[]
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
name string
The name of the backend. Must be unique within the load balancer service.
properties LoadbalancerBackendProperties
resolverName string
Domain name resolver used with dynamic type members.
tlsConfigs string[]
Set of TLS config names.
loadbalancer str
UUID of the load balancer to which the backend is connected.
members Sequence[str]
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
name str
The name of the backend. Must be unique within the load balancer service.
properties LoadbalancerBackendPropertiesArgs
resolver_name str
Domain name resolver used with dynamic type members.
tls_configs Sequence[str]
Set of TLS config names.
loadbalancer String
UUID of the load balancer to which the backend is connected.
members List<String>
Backend member server UUIDs. Members receive traffic dispatched from the frontends.
name String
The name of the backend. Must be unique within the load balancer service.
properties Property Map
resolverName String
Domain name resolver used with dynamic type members.
tlsConfigs List<String>
Set of TLS config names.

Supporting Types

LoadbalancerBackendProperties
, LoadbalancerBackendPropertiesArgs

HealthCheckExpectedStatus int
Expected HTTP status code returned by the customer application to mark server as healthy. Ignored for tcp health_check_type.
HealthCheckFall int
Sets how many failed health checks are allowed until the backend member is taken off from the rotation.
HealthCheckInterval int
Interval between health checks in seconds.
HealthCheckRise int
Sets how many successful health checks are required to put the backend member back into rotation.
HealthCheckTlsVerify bool
Enables certificate verification with the system CA certificate bundle. Works with https scheme in health_check_url, otherwise ignored.
HealthCheckType string
Health check type.
HealthCheckUrl string
Target path for health check HTTP GET requests. Ignored for tcp health_check_type.
Http2Enabled bool
Allow HTTP/2 connections to backend members by utilizing ALPN extension of TLS protocol, therefore it can only be enabled when tls_enabled is set to true. Note: members should support HTTP/2 for this setting to work.
OutboundProxyProtocol string
Enable outbound proxy protocol by setting the desired version. Defaults to empty string. Empty string disables proxy protocol.
StickySessionCookieName string
Sets sticky session cookie name. Empty string disables sticky session.
TimeoutServer int
Backend server timeout in seconds.
TimeoutTunnel int
Maximum inactivity time on the client and server side for tunnels in seconds.
TlsEnabled bool
Enables TLS connection from the load balancer to backend servers.
TlsUseSystemCa bool
If enabled, then the system CA certificate bundle will be used for the certificate verification.
TlsVerify bool
Enables backend servers certificate verification. Please make sure that TLS config with the certificate bundle of type authority attached to the backend or tls_use_system_ca enabled. Note: tls_verify has preference over health_check_tls_verify when tls_enabled in true.
HealthCheckExpectedStatus int
Expected HTTP status code returned by the customer application to mark server as healthy. Ignored for tcp health_check_type.
HealthCheckFall int
Sets how many failed health checks are allowed until the backend member is taken off from the rotation.
HealthCheckInterval int
Interval between health checks in seconds.
HealthCheckRise int
Sets how many successful health checks are required to put the backend member back into rotation.
HealthCheckTlsVerify bool
Enables certificate verification with the system CA certificate bundle. Works with https scheme in health_check_url, otherwise ignored.
HealthCheckType string
Health check type.
HealthCheckUrl string
Target path for health check HTTP GET requests. Ignored for tcp health_check_type.
Http2Enabled bool
Allow HTTP/2 connections to backend members by utilizing ALPN extension of TLS protocol, therefore it can only be enabled when tls_enabled is set to true. Note: members should support HTTP/2 for this setting to work.
OutboundProxyProtocol string
Enable outbound proxy protocol by setting the desired version. Defaults to empty string. Empty string disables proxy protocol.
StickySessionCookieName string
Sets sticky session cookie name. Empty string disables sticky session.
TimeoutServer int
Backend server timeout in seconds.
TimeoutTunnel int
Maximum inactivity time on the client and server side for tunnels in seconds.
TlsEnabled bool
Enables TLS connection from the load balancer to backend servers.
TlsUseSystemCa bool
If enabled, then the system CA certificate bundle will be used for the certificate verification.
TlsVerify bool
Enables backend servers certificate verification. Please make sure that TLS config with the certificate bundle of type authority attached to the backend or tls_use_system_ca enabled. Note: tls_verify has preference over health_check_tls_verify when tls_enabled in true.
healthCheckExpectedStatus Integer
Expected HTTP status code returned by the customer application to mark server as healthy. Ignored for tcp health_check_type.
healthCheckFall Integer
Sets how many failed health checks are allowed until the backend member is taken off from the rotation.
healthCheckInterval Integer
Interval between health checks in seconds.
healthCheckRise Integer
Sets how many successful health checks are required to put the backend member back into rotation.
healthCheckTlsVerify Boolean
Enables certificate verification with the system CA certificate bundle. Works with https scheme in health_check_url, otherwise ignored.
healthCheckType String
Health check type.
healthCheckUrl String
Target path for health check HTTP GET requests. Ignored for tcp health_check_type.
http2Enabled Boolean
Allow HTTP/2 connections to backend members by utilizing ALPN extension of TLS protocol, therefore it can only be enabled when tls_enabled is set to true. Note: members should support HTTP/2 for this setting to work.
outboundProxyProtocol String
Enable outbound proxy protocol by setting the desired version. Defaults to empty string. Empty string disables proxy protocol.
stickySessionCookieName String
Sets sticky session cookie name. Empty string disables sticky session.
timeoutServer Integer
Backend server timeout in seconds.
timeoutTunnel Integer
Maximum inactivity time on the client and server side for tunnels in seconds.
tlsEnabled Boolean
Enables TLS connection from the load balancer to backend servers.
tlsUseSystemCa Boolean
If enabled, then the system CA certificate bundle will be used for the certificate verification.
tlsVerify Boolean
Enables backend servers certificate verification. Please make sure that TLS config with the certificate bundle of type authority attached to the backend or tls_use_system_ca enabled. Note: tls_verify has preference over health_check_tls_verify when tls_enabled in true.
healthCheckExpectedStatus number
Expected HTTP status code returned by the customer application to mark server as healthy. Ignored for tcp health_check_type.
healthCheckFall number
Sets how many failed health checks are allowed until the backend member is taken off from the rotation.
healthCheckInterval number
Interval between health checks in seconds.
healthCheckRise number
Sets how many successful health checks are required to put the backend member back into rotation.
healthCheckTlsVerify boolean
Enables certificate verification with the system CA certificate bundle. Works with https scheme in health_check_url, otherwise ignored.
healthCheckType string
Health check type.
healthCheckUrl string
Target path for health check HTTP GET requests. Ignored for tcp health_check_type.
http2Enabled boolean
Allow HTTP/2 connections to backend members by utilizing ALPN extension of TLS protocol, therefore it can only be enabled when tls_enabled is set to true. Note: members should support HTTP/2 for this setting to work.
outboundProxyProtocol string
Enable outbound proxy protocol by setting the desired version. Defaults to empty string. Empty string disables proxy protocol.
stickySessionCookieName string
Sets sticky session cookie name. Empty string disables sticky session.
timeoutServer number
Backend server timeout in seconds.
timeoutTunnel number
Maximum inactivity time on the client and server side for tunnels in seconds.
tlsEnabled boolean
Enables TLS connection from the load balancer to backend servers.
tlsUseSystemCa boolean
If enabled, then the system CA certificate bundle will be used for the certificate verification.
tlsVerify boolean
Enables backend servers certificate verification. Please make sure that TLS config with the certificate bundle of type authority attached to the backend or tls_use_system_ca enabled. Note: tls_verify has preference over health_check_tls_verify when tls_enabled in true.
health_check_expected_status int
Expected HTTP status code returned by the customer application to mark server as healthy. Ignored for tcp health_check_type.
health_check_fall int
Sets how many failed health checks are allowed until the backend member is taken off from the rotation.
health_check_interval int
Interval between health checks in seconds.
health_check_rise int
Sets how many successful health checks are required to put the backend member back into rotation.
health_check_tls_verify bool
Enables certificate verification with the system CA certificate bundle. Works with https scheme in health_check_url, otherwise ignored.
health_check_type str
Health check type.
health_check_url str
Target path for health check HTTP GET requests. Ignored for tcp health_check_type.
http2_enabled bool
Allow HTTP/2 connections to backend members by utilizing ALPN extension of TLS protocol, therefore it can only be enabled when tls_enabled is set to true. Note: members should support HTTP/2 for this setting to work.
outbound_proxy_protocol str
Enable outbound proxy protocol by setting the desired version. Defaults to empty string. Empty string disables proxy protocol.
sticky_session_cookie_name str
Sets sticky session cookie name. Empty string disables sticky session.
timeout_server int
Backend server timeout in seconds.
timeout_tunnel int
Maximum inactivity time on the client and server side for tunnels in seconds.
tls_enabled bool
Enables TLS connection from the load balancer to backend servers.
tls_use_system_ca bool
If enabled, then the system CA certificate bundle will be used for the certificate verification.
tls_verify bool
Enables backend servers certificate verification. Please make sure that TLS config with the certificate bundle of type authority attached to the backend or tls_use_system_ca enabled. Note: tls_verify has preference over health_check_tls_verify when tls_enabled in true.
healthCheckExpectedStatus Number
Expected HTTP status code returned by the customer application to mark server as healthy. Ignored for tcp health_check_type.
healthCheckFall Number
Sets how many failed health checks are allowed until the backend member is taken off from the rotation.
healthCheckInterval Number
Interval between health checks in seconds.
healthCheckRise Number
Sets how many successful health checks are required to put the backend member back into rotation.
healthCheckTlsVerify Boolean
Enables certificate verification with the system CA certificate bundle. Works with https scheme in health_check_url, otherwise ignored.
healthCheckType String
Health check type.
healthCheckUrl String
Target path for health check HTTP GET requests. Ignored for tcp health_check_type.
http2Enabled Boolean
Allow HTTP/2 connections to backend members by utilizing ALPN extension of TLS protocol, therefore it can only be enabled when tls_enabled is set to true. Note: members should support HTTP/2 for this setting to work.
outboundProxyProtocol String
Enable outbound proxy protocol by setting the desired version. Defaults to empty string. Empty string disables proxy protocol.
stickySessionCookieName String
Sets sticky session cookie name. Empty string disables sticky session.
timeoutServer Number
Backend server timeout in seconds.
timeoutTunnel Number
Maximum inactivity time on the client and server side for tunnels in seconds.
tlsEnabled Boolean
Enables TLS connection from the load balancer to backend servers.
tlsUseSystemCa Boolean
If enabled, then the system CA certificate bundle will be used for the certificate verification.
tlsVerify Boolean
Enables backend servers certificate verification. Please make sure that TLS config with the certificate bundle of type authority attached to the backend or tls_use_system_ca enabled. Note: tls_verify has preference over health_check_tls_verify when tls_enabled in true.

Package Details

Repository
upcloud UpCloudLtd/pulumi-upcloud
License
Apache-2.0
Notes
This Pulumi package is based on the upcloud Terraform Provider.
UpCloud v0.2.0 published on Wednesday, Apr 16, 2025 by UpCloudLtd
UpCloudLtd/pulumi-upcloud