OVH v0.2.0, Feb 19 23

ovh.IpLoadBalancing.HttpFarm

Creates a HTTP backend server group (farm) to be used by loadbalancing frontend(s)

Example Usage

using System.Collections.Generic;
using Pulumi;
using Ovh = Lbrlabs.PulumiPackage.Ovh;
using Ovh = Pulumi.Ovh;

return await Deployment.RunAsync(() => 
{
    var lb = Ovh.IpLoadBalancing.GetIpLoadBalancing.Invoke(new()
    {
        ServiceName = "ip-1.2.3.4",
        State = "ok",
    });

    var farmname = new Ovh.IpLoadBalancing.HttpFarm("farmname", new()
    {
        DisplayName = "ingress-8080-gra",
        ServiceName = lb.Apply(getIpLoadBalancingResult => getIpLoadBalancingResult.Id),
        Zone = "GRA",
    });

});

package main

import (
	"github.com/lbrlabs/pulumi-ovh/sdk/go/ovh/IpLoadBalancing"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		lb, err := IpLoadBalancing.GetIpLoadBalancing(ctx, &iploadbalancing.GetIpLoadBalancingArgs{
			ServiceName: pulumi.StringRef("ip-1.2.3.4"),
			State:       pulumi.StringRef("ok"),
		}, nil)
		if err != nil {
			return err
		}
		_, err = IpLoadBalancing.NewHttpFarm(ctx, "farmname", &IpLoadBalancing.HttpFarmArgs{
			DisplayName: pulumi.String("ingress-8080-gra"),
			ServiceName: *pulumi.String(lb.Id),
			Zone:        pulumi.String("GRA"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ovh.IpLoadBalancing.IpLoadBalancingFunctions;
import com.pulumi.ovh.IpLoadBalancing.inputs.GetIpLoadBalancingArgs;
import com.pulumi.ovh.IpLoadBalancing.HttpFarm;
import com.pulumi.ovh.IpLoadBalancing.HttpFarmArgs;
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 lb = IpLoadBalancingFunctions.getIpLoadBalancing(GetIpLoadBalancingArgs.builder()
            .serviceName("ip-1.2.3.4")
            .state("ok")
            .build());

        var farmname = new HttpFarm("farmname", HttpFarmArgs.builder()        
            .displayName("ingress-8080-gra")
            .serviceName(lb.applyValue(getIpLoadBalancingResult -> getIpLoadBalancingResult.id()))
            .zone("GRA")
            .build());

    }
}

import pulumi
import lbrlabs_pulumi_ovh as ovh
import pulumi_ovh as ovh

lb = ovh.IpLoadBalancing.get_ip_load_balancing(service_name="ip-1.2.3.4",
    state="ok")
farmname = ovh.ip_load_balancing.HttpFarm("farmname",
    display_name="ingress-8080-gra",
    service_name=lb.id,
    zone="GRA")

import * as pulumi from "@pulumi/pulumi";
import * as ovh from "@lbrlabs/pulumi-ovh";
import * as ovh from "@pulumi/ovh";

const lb = ovh.IpLoadBalancing.getIpLoadBalancing({
    serviceName: "ip-1.2.3.4",
    state: "ok",
});
const farmname = new ovh.iploadbalancing.HttpFarm("farmname", {
    displayName: "ingress-8080-gra",
    serviceName: lb.then(lb => lb.id),
    zone: "GRA",
});

resources:
  farmname:
    type: ovh:IpLoadBalancing:HttpFarm
    properties:
      displayName: ingress-8080-gra
      serviceName: ${lb.id}
      zone: GRA
variables:
  lb:
    fn::invoke:
      Function: ovh:IpLoadBalancing:getIpLoadBalancing
      Arguments:
        serviceName: ip-1.2.3.4
        state: ok

Create HttpFarm Resource

new HttpFarm(name: string, args: HttpFarmArgs, opts?: CustomResourceOptions);

@overload
def HttpFarm(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             balance: Optional[str] = None,
             display_name: Optional[str] = None,
             port: Optional[int] = None,
             probe: Optional[_iploadbalancing.HttpFarmProbeArgs] = None,
             service_name: Optional[str] = None,
             stickiness: Optional[str] = None,
             vrack_network_id: Optional[int] = None,
             zone: Optional[str] = None)
@overload
def HttpFarm(resource_name: str,
             args: HttpFarmArgs,
             opts: Optional[ResourceOptions] = None)

func NewHttpFarm(ctx *Context, name string, args HttpFarmArgs, opts ...ResourceOption) (*HttpFarm, error)

public HttpFarm(string name, HttpFarmArgs args, CustomResourceOptions? opts = null)

public HttpFarm(String name, HttpFarmArgs args)
public HttpFarm(String name, HttpFarmArgs args, CustomResourceOptions options)

type: ovh:IpLoadBalancing:HttpFarm
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string: The unique name of the resource.
args HttpFarmArgs: 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 HttpFarmArgs: 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 HttpFarmArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args HttpFarmArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args HttpFarmArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

HttpFarm Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The HttpFarm resource accepts the following input properties:

ServiceName string: The internal name of your IP load balancing
Zone string: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)
Balance string: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
DisplayName string: Readable label for loadbalancer farm
Port int: Port for backends to receive traffic on.
Probe Lbrlabs.PulumiPackage.Ovh.IpLoadBalancing.Inputs.HttpFarmProbeArgs: define a backend healthcheck probe
Stickiness string: Stickiness type. No stickiness if null (sourceIp, cookie)
VrackNetworkId int: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack

ServiceName string: The internal name of your IP load balancing
Zone string: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)
Balance string: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
DisplayName string: Readable label for loadbalancer farm
Port int: Port for backends to receive traffic on.
Probe HttpFarmProbeArgs: define a backend healthcheck probe
Stickiness string: Stickiness type. No stickiness if null (sourceIp, cookie)
VrackNetworkId int: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack

serviceName String: The internal name of your IP load balancing
zone String: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)
balance String: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
displayName String: Readable label for loadbalancer farm
port Integer: Port for backends to receive traffic on.
probe HttpFarmProbeArgs: define a backend healthcheck probe
stickiness String: Stickiness type. No stickiness if null (sourceIp, cookie)
vrackNetworkId Integer: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack

serviceName string: The internal name of your IP load balancing
zone string: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)
balance string: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
displayName string: Readable label for loadbalancer farm
port number: Port for backends to receive traffic on.
probe HttpFarmProbeArgs: define a backend healthcheck probe
stickiness string: Stickiness type. No stickiness if null (sourceIp, cookie)
vrackNetworkId number: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack

service_name str: The internal name of your IP load balancing
zone str: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)
balance str: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
display_name str: Readable label for loadbalancer farm
port int: Port for backends to receive traffic on.
probe HttpFarmProbeArgs: define a backend healthcheck probe
stickiness str: Stickiness type. No stickiness if null (sourceIp, cookie)
vrack_network_id int: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack

serviceName String: The internal name of your IP load balancing
zone String: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)
balance String: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
displayName String: Readable label for loadbalancer farm
port Number: Port for backends to receive traffic on.
probe Property Map: define a backend healthcheck probe
stickiness String: Stickiness type. No stickiness if null (sourceIp, cookie)
vrackNetworkId Number: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack

Outputs

All input properties are implicitly available as output properties. Additionally, the HttpFarm 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 HttpFarm Resource

Get an existing HttpFarm 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?: HttpFarmState, opts?: CustomResourceOptions): HttpFarm

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        balance: Optional[str] = None,
        display_name: Optional[str] = None,
        port: Optional[int] = None,
        probe: Optional[_iploadbalancing.HttpFarmProbeArgs] = None,
        service_name: Optional[str] = None,
        stickiness: Optional[str] = None,
        vrack_network_id: Optional[int] = None,
        zone: Optional[str] = None) -> HttpFarm

func GetHttpFarm(ctx *Context, name string, id IDInput, state *HttpFarmState, opts ...ResourceOption) (*HttpFarm, error)

public static HttpFarm Get(string name, Input<string> id, HttpFarmState? state, CustomResourceOptions? opts = null)

public static HttpFarm get(String name, Output<String> id, HttpFarmState state, CustomResourceOptions options)

Resource lookup is not supported in YAML

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:

Balance string: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
DisplayName string: Readable label for loadbalancer farm
Port int: Port for backends to receive traffic on.
Probe Lbrlabs.PulumiPackage.Ovh.IpLoadBalancing.Inputs.HttpFarmProbeArgs: define a backend healthcheck probe
ServiceName string: The internal name of your IP load balancing
Stickiness string: Stickiness type. No stickiness if null (sourceIp, cookie)
VrackNetworkId int: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack
Zone string: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)

Balance string: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
DisplayName string: Readable label for loadbalancer farm
Port int: Port for backends to receive traffic on.
Probe HttpFarmProbeArgs: define a backend healthcheck probe
ServiceName string: The internal name of your IP load balancing
Stickiness string: Stickiness type. No stickiness if null (sourceIp, cookie)
VrackNetworkId int: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack
Zone string: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)

balance String: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
displayName String: Readable label for loadbalancer farm
port Integer: Port for backends to receive traffic on.
probe HttpFarmProbeArgs: define a backend healthcheck probe
serviceName String: The internal name of your IP load balancing
stickiness String: Stickiness type. No stickiness if null (sourceIp, cookie)
vrackNetworkId Integer: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack
zone String: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)

balance string: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
displayName string: Readable label for loadbalancer farm
port number: Port for backends to receive traffic on.
probe HttpFarmProbeArgs: define a backend healthcheck probe
serviceName string: The internal name of your IP load balancing
stickiness string: Stickiness type. No stickiness if null (sourceIp, cookie)
vrackNetworkId number: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack
zone string: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)

balance str: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
display_name str: Readable label for loadbalancer farm
port int: Port for backends to receive traffic on.
probe HttpFarmProbeArgs: define a backend healthcheck probe
service_name str: The internal name of your IP load balancing
stickiness str: Stickiness type. No stickiness if null (sourceIp, cookie)
vrack_network_id int: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack
zone str: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)

balance String: Load balancing algorithm. roundrobin if null (first, leastconn, roundrobin, source)
displayName String: Readable label for loadbalancer farm
port Number: Port for backends to receive traffic on.
probe Property Map: define a backend healthcheck probe
serviceName String: The internal name of your IP load balancing
stickiness String: Stickiness type. No stickiness if null (sourceIp, cookie)
vrackNetworkId Number: Internal Load Balancer identifier of the vRack private network to attach to your farm, mandatory when your Load Balancer is attached to a vRack
zone String: Zone where the farm will be defined (ie. GRA, BHS also supports ALL)

Supporting Types

HttpFarmProbe

Type string: Valid values : http, internal, mysql, oco, pgsql, smtp, tcp
ForceSsl bool: Force use of SSL (TLS)
Interval int: probe interval, Value between 30 and 3600 seconds, default 30
Match string: What to match pattern against (contains, default, internal, matches, status)
Method string: HTTP probe method (GET, HEAD, OPTIONS, internal)
Negate bool: Negate probe result
Pattern string: Pattern to match against match
Port int: Port for backends to receive traffic on.
Url string: URL for HTTP probe type.

Type string: Valid values : http, internal, mysql, oco, pgsql, smtp, tcp
ForceSsl bool: Force use of SSL (TLS)
Interval int: probe interval, Value between 30 and 3600 seconds, default 30
Match string: What to match pattern against (contains, default, internal, matches, status)
Method string: HTTP probe method (GET, HEAD, OPTIONS, internal)
Negate bool: Negate probe result
Pattern string: Pattern to match against match
Port int: Port for backends to receive traffic on.
Url string: URL for HTTP probe type.

type String: Valid values : http, internal, mysql, oco, pgsql, smtp, tcp
forceSsl Boolean: Force use of SSL (TLS)
interval Integer: probe interval, Value between 30 and 3600 seconds, default 30
match String: What to match pattern against (contains, default, internal, matches, status)
method String: HTTP probe method (GET, HEAD, OPTIONS, internal)
negate Boolean: Negate probe result
pattern String: Pattern to match against match
port Integer: Port for backends to receive traffic on.
url String: URL for HTTP probe type.

type string: Valid values : http, internal, mysql, oco, pgsql, smtp, tcp
forceSsl boolean: Force use of SSL (TLS)
interval number: probe interval, Value between 30 and 3600 seconds, default 30
match string: What to match pattern against (contains, default, internal, matches, status)
method string: HTTP probe method (GET, HEAD, OPTIONS, internal)
negate boolean: Negate probe result
pattern string: Pattern to match against match
port number: Port for backends to receive traffic on.
url string: URL for HTTP probe type.

type str: Valid values : http, internal, mysql, oco, pgsql, smtp, tcp
force_ssl bool: Force use of SSL (TLS)
interval int: probe interval, Value between 30 and 3600 seconds, default 30
match str: What to match pattern against (contains, default, internal, matches, status)
method str: HTTP probe method (GET, HEAD, OPTIONS, internal)
negate bool: Negate probe result
pattern str: Pattern to match against match
port int: Port for backends to receive traffic on.
url str: URL for HTTP probe type.

type String: Valid values : http, internal, mysql, oco, pgsql, smtp, tcp
forceSsl Boolean: Force use of SSL (TLS)
interval Number: probe interval, Value between 30 and 3600 seconds, default 30
match String: What to match pattern against (contains, default, internal, matches, status)
method String: HTTP probe method (GET, HEAD, OPTIONS, internal)
negate Boolean: Negate probe result
pattern String: Pattern to match against match
port Number: Port for backends to receive traffic on.
url String: URL for HTTP probe type.

Package Details

Repository: ovh lbrlabs/pulumi-ovh
License: Apache-2.0
Notes: This Pulumi package is based on the ovh Terraform Provider.