Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. UpCloud
  3. API Docs
  4. LoadbalancerStaticBackendMember
UpCloud v0.1.0 published on Friday, Mar 14, 2025 by UpCloudLtd
UpCloudLtd/pulumi-upcloud

upcloud.LoadbalancerStaticBackendMember

Explore with Pulumi AI

upcloud logo
UpCloud v0.1.0 published on Friday, Mar 14, 2025 by UpCloudLtd
UpCloudLtd/pulumi-upcloud

    This resource represents load balancer static backend member

    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",
});
const lbBe1Sm1 = new upcloud.LoadbalancerStaticBackendMember("lb_be_1_sm_1", {
    backend: upcloudLoadbalancerBackend.lbBe1.id,
    name: "lb-be-1-sm-1-test",
    ip: "10.0.0.10",
    port: 8000,
    weight: 0,
    maxSessions: 0,
    enabled: true,
});

    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")
lb_be1_sm1 = upcloud.LoadbalancerStaticBackendMember("lb_be_1_sm_1",
    backend=upcloud_loadbalancer_backend["lbBe1"]["id"],
    name="lb-be-1-sm-1-test",
    ip="10.0.0.10",
    port=8000,
    weight=0,
    max_sessions=0,
    enabled=True)

    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
		}
		_, err = upcloud.NewLoadbalancerStaticBackendMember(ctx, "lb_be_1_sm_1", &upcloud.LoadbalancerStaticBackendMemberArgs{
			Backend:     pulumi.Any(upcloudLoadbalancerBackend.LbBe1.Id),
			Name:        pulumi.String("lb-be-1-sm-1-test"),
			Ip:          pulumi.String("10.0.0.10"),
			Port:        pulumi.Int(8000),
			Weight:      pulumi.Int(0),
			MaxSessions: pulumi.Int(0),
			Enabled:     pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    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",
    });

    var lbBe1Sm1 = new UpCloud.LoadbalancerStaticBackendMember("lb_be_1_sm_1", new()
    {
        Backend = upcloudLoadbalancerBackend.LbBe1.Id,
        Name = "lb-be-1-sm-1-test",
        Ip = "10.0.0.10",
        Port = 8000,
        Weight = 0,
        MaxSessions = 0,
        Enabled = true,
    });

});

    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 com.pulumi.upcloud.LoadbalancerStaticBackendMember;
import com.pulumi.upcloud.LoadbalancerStaticBackendMemberArgs;
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());

        var lbBe1Sm1 = new LoadbalancerStaticBackendMember("lbBe1Sm1", LoadbalancerStaticBackendMemberArgs.builder()
            .backend(upcloudLoadbalancerBackend.lbBe1().id())
            .name("lb-be-1-sm-1-test")
            .ip("10.0.0.10")
            .port(8000)
            .weight(0)
            .maxSessions(0)
            .enabled(true)
            .build());

    }
}

    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
  lbBe1Sm1:
    type: upcloud:LoadbalancerStaticBackendMember
    name: lb_be_1_sm_1
    properties:
      backend: ${upcloudLoadbalancerBackend.lbBe1.id}
      name: lb-be-1-sm-1-test
      ip: 10.0.0.10
      port: 8000
      weight: 0
      maxSessions: 0
      enabled: true

    Create LoadbalancerStaticBackendMember Resource

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

    Constructor syntax

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

@overload
def LoadbalancerStaticBackendMember(resource_name: str,
                                    opts: Optional[ResourceOptions] = None,
                                    backend: Optional[str] = None,
                                    max_sessions: Optional[int] = None,
                                    weight: Optional[int] = None,
                                    enabled: Optional[bool] = None,
                                    ip: Optional[str] = None,
                                    name: Optional[str] = None,
                                    port: Optional[int] = None)
    func NewLoadbalancerStaticBackendMember(ctx *Context, name string, args LoadbalancerStaticBackendMemberArgs, opts ...ResourceOption) (*LoadbalancerStaticBackendMember, error)
    public LoadbalancerStaticBackendMember(string name, LoadbalancerStaticBackendMemberArgs args, CustomResourceOptions? opts = null)
    public LoadbalancerStaticBackendMember(String name, LoadbalancerStaticBackendMemberArgs args)
public LoadbalancerStaticBackendMember(String name, LoadbalancerStaticBackendMemberArgs args, CustomResourceOptions options)

    type: upcloud:LoadbalancerStaticBackendMember
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 LoadbalancerStaticBackendMemberArgs
    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 LoadbalancerStaticBackendMemberArgs
    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 LoadbalancerStaticBackendMemberArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LoadbalancerStaticBackendMemberArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LoadbalancerStaticBackendMemberArgs
    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 loadbalancerStaticBackendMemberResource = new UpCloud.LoadbalancerStaticBackendMember("loadbalancerStaticBackendMemberResource", new()
{
    Backend = "string",
    MaxSessions = 0,
    Weight = 0,
    Enabled = false,
    Ip = "string",
    Name = "string",
    Port = 0,
});

    example, err := upcloud.NewLoadbalancerStaticBackendMember(ctx, "loadbalancerStaticBackendMemberResource", &upcloud.LoadbalancerStaticBackendMemberArgs{
	Backend:     pulumi.String("string"),
	MaxSessions: pulumi.Int(0),
	Weight:      pulumi.Int(0),
	Enabled:     pulumi.Bool(false),
	Ip:          pulumi.String("string"),
	Name:        pulumi.String("string"),
	Port:        pulumi.Int(0),
})

    var loadbalancerStaticBackendMemberResource = new LoadbalancerStaticBackendMember("loadbalancerStaticBackendMemberResource", LoadbalancerStaticBackendMemberArgs.builder()
    .backend("string")
    .maxSessions(0)
    .weight(0)
    .enabled(false)
    .ip("string")
    .name("string")
    .port(0)
    .build());

    loadbalancer_static_backend_member_resource = upcloud.LoadbalancerStaticBackendMember("loadbalancerStaticBackendMemberResource",
    backend="string",
    max_sessions=0,
    weight=0,
    enabled=False,
    ip="string",
    name="string",
    port=0)

    const loadbalancerStaticBackendMemberResource = new upcloud.LoadbalancerStaticBackendMember("loadbalancerStaticBackendMemberResource", {
    backend: "string",
    maxSessions: 0,
    weight: 0,
    enabled: false,
    ip: "string",
    name: "string",
    port: 0,
});

    type: upcloud:LoadbalancerStaticBackendMember
properties:
    backend: string
    enabled: false
    ip: string
    maxSessions: 0
    name: string
    port: 0
    weight: 0

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

    Backend string
    ID of the load balancer backend to which the member is connected.
    MaxSessions int
    Maximum number of sessions before queueing.
    Weight int
    Weight of the member. The higher the weight, the more traffic the member receives.
    Enabled bool
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    Ip string
    Optional fallback IP address in case of failure on DNS resolving.
    Name string
    The name of the member. Must be unique within within the load balancer backend.
    Port int
    Server port. Port is optional and can be specified in DNS SRV record.
    Backend string
    ID of the load balancer backend to which the member is connected.
    MaxSessions int
    Maximum number of sessions before queueing.
    Weight int
    Weight of the member. The higher the weight, the more traffic the member receives.
    Enabled bool
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    Ip string
    Optional fallback IP address in case of failure on DNS resolving.
    Name string
    The name of the member. Must be unique within within the load balancer backend.
    Port int
    Server port. Port is optional and can be specified in DNS SRV record.
    backend String
    ID of the load balancer backend to which the member is connected.
    maxSessions Integer
    Maximum number of sessions before queueing.
    weight Integer
    Weight of the member. The higher the weight, the more traffic the member receives.
    enabled Boolean
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    ip String
    Optional fallback IP address in case of failure on DNS resolving.
    name String
    The name of the member. Must be unique within within the load balancer backend.
    port Integer
    Server port. Port is optional and can be specified in DNS SRV record.
    backend string
    ID of the load balancer backend to which the member is connected.
    maxSessions number
    Maximum number of sessions before queueing.
    weight number
    Weight of the member. The higher the weight, the more traffic the member receives.
    enabled boolean
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    ip string
    Optional fallback IP address in case of failure on DNS resolving.
    name string
    The name of the member. Must be unique within within the load balancer backend.
    port number
    Server port. Port is optional and can be specified in DNS SRV record.
    backend str
    ID of the load balancer backend to which the member is connected.
    max_sessions int
    Maximum number of sessions before queueing.
    weight int
    Weight of the member. The higher the weight, the more traffic the member receives.
    enabled bool
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    ip str
    Optional fallback IP address in case of failure on DNS resolving.
    name str
    The name of the member. Must be unique within within the load balancer backend.
    port int
    Server port. Port is optional and can be specified in DNS SRV record.
    backend String
    ID of the load balancer backend to which the member is connected.
    maxSessions Number
    Maximum number of sessions before queueing.
    weight Number
    Weight of the member. The higher the weight, the more traffic the member receives.
    enabled Boolean
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    ip String
    Optional fallback IP address in case of failure on DNS resolving.
    name String
    The name of the member. Must be unique within within the load balancer backend.
    port Number
    Server port. Port is optional and can be specified in DNS SRV record.

    Outputs

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

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

    Look up Existing LoadbalancerStaticBackendMember Resource

    Get an existing LoadbalancerStaticBackendMember 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?: LoadbalancerStaticBackendMemberState, opts?: CustomResourceOptions): LoadbalancerStaticBackendMember
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        backend: Optional[str] = None,
        enabled: Optional[bool] = None,
        ip: Optional[str] = None,
        max_sessions: Optional[int] = None,
        name: Optional[str] = None,
        port: Optional[int] = None,
        weight: Optional[int] = None) -> LoadbalancerStaticBackendMember
    func GetLoadbalancerStaticBackendMember(ctx *Context, name string, id IDInput, state *LoadbalancerStaticBackendMemberState, opts ...ResourceOption) (*LoadbalancerStaticBackendMember, error)
    public static LoadbalancerStaticBackendMember Get(string name, Input<string> id, LoadbalancerStaticBackendMemberState? state, CustomResourceOptions? opts = null)
    public static LoadbalancerStaticBackendMember get(String name, Output<String> id, LoadbalancerStaticBackendMemberState state, CustomResourceOptions options)
    resources:  _:    type: upcloud:LoadbalancerStaticBackendMember    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:
    Backend string
    ID of the load balancer backend to which the member is connected.
    Enabled bool
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    Ip string
    Optional fallback IP address in case of failure on DNS resolving.
    MaxSessions int
    Maximum number of sessions before queueing.
    Name string
    The name of the member. Must be unique within within the load balancer backend.
    Port int
    Server port. Port is optional and can be specified in DNS SRV record.
    Weight int
    Weight of the member. The higher the weight, the more traffic the member receives.
    Backend string
    ID of the load balancer backend to which the member is connected.
    Enabled bool
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    Ip string
    Optional fallback IP address in case of failure on DNS resolving.
    MaxSessions int
    Maximum number of sessions before queueing.
    Name string
    The name of the member. Must be unique within within the load balancer backend.
    Port int
    Server port. Port is optional and can be specified in DNS SRV record.
    Weight int
    Weight of the member. The higher the weight, the more traffic the member receives.
    backend String
    ID of the load balancer backend to which the member is connected.
    enabled Boolean
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    ip String
    Optional fallback IP address in case of failure on DNS resolving.
    maxSessions Integer
    Maximum number of sessions before queueing.
    name String
    The name of the member. Must be unique within within the load balancer backend.
    port Integer
    Server port. Port is optional and can be specified in DNS SRV record.
    weight Integer
    Weight of the member. The higher the weight, the more traffic the member receives.
    backend string
    ID of the load balancer backend to which the member is connected.
    enabled boolean
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    ip string
    Optional fallback IP address in case of failure on DNS resolving.
    maxSessions number
    Maximum number of sessions before queueing.
    name string
    The name of the member. Must be unique within within the load balancer backend.
    port number
    Server port. Port is optional and can be specified in DNS SRV record.
    weight number
    Weight of the member. The higher the weight, the more traffic the member receives.
    backend str
    ID of the load balancer backend to which the member is connected.
    enabled bool
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    ip str
    Optional fallback IP address in case of failure on DNS resolving.
    max_sessions int
    Maximum number of sessions before queueing.
    name str
    The name of the member. Must be unique within within the load balancer backend.
    port int
    Server port. Port is optional and can be specified in DNS SRV record.
    weight int
    Weight of the member. The higher the weight, the more traffic the member receives.
    backend String
    ID of the load balancer backend to which the member is connected.
    enabled Boolean
    Indicates if the member is enabled. Disabled members are excluded from load balancing.
    ip String
    Optional fallback IP address in case of failure on DNS resolving.
    maxSessions Number
    Maximum number of sessions before queueing.
    name String
    The name of the member. Must be unique within within the load balancer backend.
    port Number
    Server port. Port is optional and can be specified in DNS SRV record.
    weight Number
    Weight of the member. The higher the weight, the more traffic the member receives.

    Package Details

    Repository
    upcloud UpCloudLtd/pulumi-upcloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the upcloud Terraform Provider.
    upcloud logo
    UpCloud v0.1.0 published on Friday, Mar 14, 2025 by UpCloudLtd
    UpCloudLtd/pulumi-upcloud