civo.getLoadBalancer

Get information on a load balancer for use in other resources. This data source provides all of the load balancers properties as configured on your Civo account.

An error will be raised if the provided load balancer name does not exist in your Civo account.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Civo = Pulumi.Civo;

return await Deployment.RunAsync(() => 
{
    var my_lb = Civo.GetLoadBalancer.Invoke(new()
    {
        Name = "lb-name",
        Region = "LON1",
    });

    return new Dictionary<string, object?>
    {
        ["civoLoadbalancerOutput"] = my_lb.Apply(my_lb => my_lb.Apply(getLoadBalancerResult => getLoadBalancerResult.PublicIp)),
    };
});
package main

import (
	"github.com/pulumi/pulumi-civo/sdk/v2/go/civo"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		my_lb, err := civo.GetLoadBalancer(ctx, &civo.GetLoadBalancerArgs{
			Name:   pulumi.StringRef("lb-name"),
			Region: pulumi.StringRef("LON1"),
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("civoLoadbalancerOutput", my_lb.PublicIp)
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.civo.CivoFunctions;
import com.pulumi.civo.inputs.GetLoadBalancerArgs;
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 my-lb = CivoFunctions.getLoadBalancer(GetLoadBalancerArgs.builder()
            .name("lb-name")
            .region("LON1")
            .build());

        ctx.export("civoLoadbalancerOutput", my_lb.publicIp());
    }
}
import pulumi
import pulumi_civo as civo

my_lb = civo.get_load_balancer(name="lb-name",
    region="LON1")
pulumi.export("civoLoadbalancerOutput", my_lb.public_ip)
import * as pulumi from "@pulumi/pulumi";
import * as civo from "@pulumi/civo";

const my-lb = civo.getLoadBalancer({
    name: "lb-name",
    region: "LON1",
});
export const civoLoadbalancerOutput = my_lb.then(my_lb => my_lb.publicIp);
variables:
  my-lb:
    fn::invoke:
      Function: civo:getLoadBalancer
      Arguments:
        name: lb-name
        region: LON1
outputs:
  civoLoadbalancerOutput: ${["my-lb"].publicIp}

Using getLoadBalancer

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getLoadBalancer(args: GetLoadBalancerArgs, opts?: InvokeOptions): Promise<GetLoadBalancerResult>
function getLoadBalancerOutput(args: GetLoadBalancerOutputArgs, opts?: InvokeOptions): Output<GetLoadBalancerResult>
def get_load_balancer(id: Optional[str] = None,
                      name: Optional[str] = None,
                      region: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetLoadBalancerResult
def get_load_balancer_output(id: Optional[pulumi.Input[str]] = None,
                      name: Optional[pulumi.Input[str]] = None,
                      region: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetLoadBalancerResult]
func GetLoadBalancer(ctx *Context, args *GetLoadBalancerArgs, opts ...InvokeOption) (*GetLoadBalancerResult, error)
func GetLoadBalancerOutput(ctx *Context, args *GetLoadBalancerOutputArgs, opts ...InvokeOption) GetLoadBalancerResultOutput

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

public static class GetLoadBalancer 
{
    public static Task<GetLoadBalancerResult> InvokeAsync(GetLoadBalancerArgs args, InvokeOptions? opts = null)
    public static Output<GetLoadBalancerResult> Invoke(GetLoadBalancerInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetLoadBalancerResult> getLoadBalancer(GetLoadBalancerArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: civo:index/getLoadBalancer:getLoadBalancer
  arguments:
    # arguments dictionary

The following arguments are supported:

Id string

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

Name string

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

Region string

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

Id string

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

Name string

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

Region string

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

id String

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

name String

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

region String

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

id string

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

name string

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

region string

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

id str

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

name str

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

region str

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

id String

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

name String

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

region String

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

getLoadBalancer Result

The following output properties are available:

Algorithm string

The algorithm used by the load balancer

Backends List<GetLoadBalancerBackend>
ClusterId string

The cluster id of the load balancer

EnableProxyProtocol string

The enabled proxy protocol of the load balancer

ExternalTrafficPolicy string

The external traffic policy of the load balancer

FirewallId string

The firewall id of the load balancer

PrivateIp string

The private ip of the load balancer

PublicIp string

The public ip of the load balancer

SessionAffinity string

The session affinity of the load balancer

SessionAffinityConfigTimeout int

The session affinity config timeout of the load balancer

State string

The state of the load balancer

Id string

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

Name string

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

Region string

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

Algorithm string

The algorithm used by the load balancer

Backends []GetLoadBalancerBackend
ClusterId string

The cluster id of the load balancer

EnableProxyProtocol string

The enabled proxy protocol of the load balancer

ExternalTrafficPolicy string

The external traffic policy of the load balancer

FirewallId string

The firewall id of the load balancer

PrivateIp string

The private ip of the load balancer

PublicIp string

The public ip of the load balancer

SessionAffinity string

The session affinity of the load balancer

SessionAffinityConfigTimeout int

The session affinity config timeout of the load balancer

State string

The state of the load balancer

Id string

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

Name string

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

Region string

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

algorithm String

The algorithm used by the load balancer

backends List<GetLoadBalancerBackend>
clusterId String

The cluster id of the load balancer

enableProxyProtocol String

The enabled proxy protocol of the load balancer

externalTrafficPolicy String

The external traffic policy of the load balancer

firewallId String

The firewall id of the load balancer

privateIp String

The private ip of the load balancer

publicIp String

The public ip of the load balancer

sessionAffinity String

The session affinity of the load balancer

sessionAffinityConfigTimeout Integer

The session affinity config timeout of the load balancer

state String

The state of the load balancer

id String

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

name String

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

region String

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

algorithm string

The algorithm used by the load balancer

backends GetLoadBalancerBackend[]
clusterId string

The cluster id of the load balancer

enableProxyProtocol string

The enabled proxy protocol of the load balancer

externalTrafficPolicy string

The external traffic policy of the load balancer

firewallId string

The firewall id of the load balancer

privateIp string

The private ip of the load balancer

publicIp string

The public ip of the load balancer

sessionAffinity string

The session affinity of the load balancer

sessionAffinityConfigTimeout number

The session affinity config timeout of the load balancer

state string

The state of the load balancer

id string

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

name string

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

region string

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

algorithm str

The algorithm used by the load balancer

backends Sequence[GetLoadBalancerBackend]
cluster_id str

The cluster id of the load balancer

enable_proxy_protocol str

The enabled proxy protocol of the load balancer

external_traffic_policy str

The external traffic policy of the load balancer

firewall_id str

The firewall id of the load balancer

private_ip str

The private ip of the load balancer

public_ip str

The public ip of the load balancer

session_affinity str

The session affinity of the load balancer

session_affinity_config_timeout int

The session affinity config timeout of the load balancer

state str

The state of the load balancer

id str

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

name str

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

region str

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

algorithm String

The algorithm used by the load balancer

backends List<Property Map>
clusterId String

The cluster id of the load balancer

enableProxyProtocol String

The enabled proxy protocol of the load balancer

externalTrafficPolicy String

The external traffic policy of the load balancer

firewallId String

The firewall id of the load balancer

privateIp String

The private ip of the load balancer

publicIp String

The public ip of the load balancer

sessionAffinity String

The session affinity of the load balancer

sessionAffinityConfigTimeout Number

The session affinity config timeout of the load balancer

state String

The state of the load balancer

id String

The id of the load balancer to retrieve (You can find this id from service annotations 'kubernetes.civo.com/loadbalancer-id')

name String

The name of the load balancer (You can find this name from service annotations 'kubernetes.civo.com/loadbalancer-name')

region String

The region of the load balancer, if you delcare this field, the datasource will use this value instead of the one defined in the provider

Supporting Types

GetLoadBalancerBackend

healthCheckPort Integer
ip String
protocol String
sourcePort Integer
targetPort Integer
healthCheckPort number
ip string
protocol string
sourcePort number
targetPort number
healthCheckPort Number
ip String
protocol String
sourcePort Number
targetPort Number

Package Details

Repository
Civo pulumi/pulumi-civo
License
Apache-2.0
Notes

This Pulumi package is based on the civo Terraform Provider.