gcore.Lbpool
Explore with Pulumi AI
Represent load balancer listener pool. A pool is a list of virtual machines to which the listener will redirect incoming traffic
Example Usage
Prerequisite
import * as pulumi from "@pulumi/pulumi";
import * as gcore from "@pulumi/gcore";
const project = gcore.getProject({
name: "Default",
});
const region = gcore.getRegion({
name: "Luxembourg-2",
});
import pulumi
import pulumi_gcore as gcore
project = gcore.get_project(name="Default")
region = gcore.get_region(name="Luxembourg-2")
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/gcore"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := gcore.GetProject(ctx, &gcore.GetProjectArgs{
Name: "Default",
}, nil)
if err != nil {
return err
}
_, err = gcore.GetRegion(ctx, &gcore.GetRegionArgs{
Name: "Luxembourg-2",
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcore = Pulumi.Gcore;
return await Deployment.RunAsync(() =>
{
var project = Gcore.GetProject.Invoke(new()
{
Name = "Default",
});
var region = Gcore.GetRegion.Invoke(new()
{
Name = "Luxembourg-2",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcore.GcoreFunctions;
import com.pulumi.gcore.inputs.GetProjectArgs;
import com.pulumi.gcore.inputs.GetRegionArgs;
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 project = GcoreFunctions.getProject(GetProjectArgs.builder()
.name("Default")
.build());
final var region = GcoreFunctions.getRegion(GetRegionArgs.builder()
.name("Luxembourg-2")
.build());
}
}
variables:
project:
fn::invoke:
function: gcore:getProject
arguments:
name: Default
region:
fn::invoke:
function: gcore:getRegion
arguments:
name: Luxembourg-2
TCP Pool with health monitor and session persistence
import * as pulumi from "@pulumi/pulumi";
import * as gcore from "@pulumi/gcore";
const tcp80Lblistener = new gcore.Lblistener("tcp80Lblistener", {
projectId: data.gcore_project.project.id,
regionId: data.gcore_region.region.id,
loadbalancerId: gcore_loadbalancerv2.lb.id,
protocol: "TCP",
protocolPort: 80,
});
const tcp80Lbpool = new gcore.Lbpool("tcp80Lbpool", {
projectId: data.gcore_project.project.id,
regionId: data.gcore_region.region.id,
loadbalancerId: gcore_loadbalancerv2.lb.id,
listenerId: tcp80Lblistener.lblistenerId,
protocol: "TCP",
lbAlgorithm: "ROUND_ROBIN",
healthMonitor: {
type: "PING",
delay: 10,
maxRetries: 5,
timeout: 5,
},
sessionPersistence: {
type: "APP_COOKIE",
cookieName: "test_new_cookie",
},
});
import pulumi
import pulumi_gcore as gcore
tcp80_lblistener = gcore.Lblistener("tcp80Lblistener",
project_id=data["gcore_project"]["project"]["id"],
region_id=data["gcore_region"]["region"]["id"],
loadbalancer_id=gcore_loadbalancerv2["lb"]["id"],
protocol="TCP",
protocol_port=80)
tcp80_lbpool = gcore.Lbpool("tcp80Lbpool",
project_id=data["gcore_project"]["project"]["id"],
region_id=data["gcore_region"]["region"]["id"],
loadbalancer_id=gcore_loadbalancerv2["lb"]["id"],
listener_id=tcp80_lblistener.lblistener_id,
protocol="TCP",
lb_algorithm="ROUND_ROBIN",
health_monitor={
"type": "PING",
"delay": 10,
"max_retries": 5,
"timeout": 5,
},
session_persistence={
"type": "APP_COOKIE",
"cookie_name": "test_new_cookie",
})
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/gcore"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
tcp80Lblistener, err := gcore.NewLblistener(ctx, "tcp80Lblistener", &gcore.LblistenerArgs{
ProjectId: pulumi.Any(data.Gcore_project.Project.Id),
RegionId: pulumi.Any(data.Gcore_region.Region.Id),
LoadbalancerId: pulumi.Any(gcore_loadbalancerv2.Lb.Id),
Protocol: pulumi.String("TCP"),
ProtocolPort: pulumi.Float64(80),
})
if err != nil {
return err
}
_, err = gcore.NewLbpool(ctx, "tcp80Lbpool", &gcore.LbpoolArgs{
ProjectId: pulumi.Any(data.Gcore_project.Project.Id),
RegionId: pulumi.Any(data.Gcore_region.Region.Id),
LoadbalancerId: pulumi.Any(gcore_loadbalancerv2.Lb.Id),
ListenerId: tcp80Lblistener.LblistenerId,
Protocol: pulumi.String("TCP"),
LbAlgorithm: pulumi.String("ROUND_ROBIN"),
HealthMonitor: &gcore.LbpoolHealthMonitorArgs{
Type: pulumi.String("PING"),
Delay: pulumi.Float64(10),
MaxRetries: pulumi.Float64(5),
Timeout: pulumi.Float64(5),
},
SessionPersistence: &gcore.LbpoolSessionPersistenceArgs{
Type: pulumi.String("APP_COOKIE"),
CookieName: pulumi.String("test_new_cookie"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcore = Pulumi.Gcore;
return await Deployment.RunAsync(() =>
{
var tcp80Lblistener = new Gcore.Lblistener("tcp80Lblistener", new()
{
ProjectId = data.Gcore_project.Project.Id,
RegionId = data.Gcore_region.Region.Id,
LoadbalancerId = gcore_loadbalancerv2.Lb.Id,
Protocol = "TCP",
ProtocolPort = 80,
});
var tcp80Lbpool = new Gcore.Lbpool("tcp80Lbpool", new()
{
ProjectId = data.Gcore_project.Project.Id,
RegionId = data.Gcore_region.Region.Id,
LoadbalancerId = gcore_loadbalancerv2.Lb.Id,
ListenerId = tcp80Lblistener.LblistenerId,
Protocol = "TCP",
LbAlgorithm = "ROUND_ROBIN",
HealthMonitor = new Gcore.Inputs.LbpoolHealthMonitorArgs
{
Type = "PING",
Delay = 10,
MaxRetries = 5,
Timeout = 5,
},
SessionPersistence = new Gcore.Inputs.LbpoolSessionPersistenceArgs
{
Type = "APP_COOKIE",
CookieName = "test_new_cookie",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcore.Lblistener;
import com.pulumi.gcore.LblistenerArgs;
import com.pulumi.gcore.Lbpool;
import com.pulumi.gcore.LbpoolArgs;
import com.pulumi.gcore.inputs.LbpoolHealthMonitorArgs;
import com.pulumi.gcore.inputs.LbpoolSessionPersistenceArgs;
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) {
var tcp80Lblistener = new Lblistener("tcp80Lblistener", LblistenerArgs.builder()
.projectId(data.gcore_project().project().id())
.regionId(data.gcore_region().region().id())
.loadbalancerId(gcore_loadbalancerv2.lb().id())
.protocol("TCP")
.protocolPort(80)
.build());
var tcp80Lbpool = new Lbpool("tcp80Lbpool", LbpoolArgs.builder()
.projectId(data.gcore_project().project().id())
.regionId(data.gcore_region().region().id())
.loadbalancerId(gcore_loadbalancerv2.lb().id())
.listenerId(tcp80Lblistener.lblistenerId())
.protocol("TCP")
.lbAlgorithm("ROUND_ROBIN")
.healthMonitor(LbpoolHealthMonitorArgs.builder()
.type("PING")
.delay(10)
.maxRetries(5)
.timeout(5)
.build())
.sessionPersistence(LbpoolSessionPersistenceArgs.builder()
.type("APP_COOKIE")
.cookieName("test_new_cookie")
.build())
.build());
}
}
resources:
tcp80Lblistener:
type: gcore:Lblistener
properties:
projectId: ${data.gcore_project.project.id}
regionId: ${data.gcore_region.region.id}
loadbalancerId: ${gcore_loadbalancerv2.lb.id}
protocol: TCP
protocolPort: 80
tcp80Lbpool:
type: gcore:Lbpool
properties:
projectId: ${data.gcore_project.project.id}
regionId: ${data.gcore_region.region.id}
loadbalancerId: ${gcore_loadbalancerv2.lb.id}
listenerId: ${tcp80Lblistener.lblistenerId}
protocol: TCP
lbAlgorithm: ROUND_ROBIN
healthMonitor:
type: PING
delay: 10
maxRetries: 5
timeout: 5
sessionPersistence:
type: APP_COOKIE
cookieName: test_new_cookie
Simple pool with proxy protocol
import * as pulumi from "@pulumi/pulumi";
import * as gcore from "@pulumi/gcore";
const proxy8080Lblistener = new gcore.Lblistener("proxy8080Lblistener", {
projectId: data.gcore_project.project.id,
regionId: data.gcore_region.region.id,
loadbalancerId: gcore_loadbalancerv2.lb.id,
protocol: "TCP",
protocolPort: 8080,
});
const proxy8080Lbpool = new gcore.Lbpool("proxy8080Lbpool", {
projectId: data.gcore_project.project.id,
regionId: data.gcore_region.region.id,
loadbalancerId: gcore_loadbalancerv2.lb.id,
listenerId: proxy8080Lblistener.lblistenerId,
protocol: "PROXY",
lbAlgorithm: "LEAST_CONNECTIONS",
});
import pulumi
import pulumi_gcore as gcore
proxy8080_lblistener = gcore.Lblistener("proxy8080Lblistener",
project_id=data["gcore_project"]["project"]["id"],
region_id=data["gcore_region"]["region"]["id"],
loadbalancer_id=gcore_loadbalancerv2["lb"]["id"],
protocol="TCP",
protocol_port=8080)
proxy8080_lbpool = gcore.Lbpool("proxy8080Lbpool",
project_id=data["gcore_project"]["project"]["id"],
region_id=data["gcore_region"]["region"]["id"],
loadbalancer_id=gcore_loadbalancerv2["lb"]["id"],
listener_id=proxy8080_lblistener.lblistener_id,
protocol="PROXY",
lb_algorithm="LEAST_CONNECTIONS")
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/gcore"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
proxy8080Lblistener, err := gcore.NewLblistener(ctx, "proxy8080Lblistener", &gcore.LblistenerArgs{
ProjectId: pulumi.Any(data.Gcore_project.Project.Id),
RegionId: pulumi.Any(data.Gcore_region.Region.Id),
LoadbalancerId: pulumi.Any(gcore_loadbalancerv2.Lb.Id),
Protocol: pulumi.String("TCP"),
ProtocolPort: pulumi.Float64(8080),
})
if err != nil {
return err
}
_, err = gcore.NewLbpool(ctx, "proxy8080Lbpool", &gcore.LbpoolArgs{
ProjectId: pulumi.Any(data.Gcore_project.Project.Id),
RegionId: pulumi.Any(data.Gcore_region.Region.Id),
LoadbalancerId: pulumi.Any(gcore_loadbalancerv2.Lb.Id),
ListenerId: proxy8080Lblistener.LblistenerId,
Protocol: pulumi.String("PROXY"),
LbAlgorithm: pulumi.String("LEAST_CONNECTIONS"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcore = Pulumi.Gcore;
return await Deployment.RunAsync(() =>
{
var proxy8080Lblistener = new Gcore.Lblistener("proxy8080Lblistener", new()
{
ProjectId = data.Gcore_project.Project.Id,
RegionId = data.Gcore_region.Region.Id,
LoadbalancerId = gcore_loadbalancerv2.Lb.Id,
Protocol = "TCP",
ProtocolPort = 8080,
});
var proxy8080Lbpool = new Gcore.Lbpool("proxy8080Lbpool", new()
{
ProjectId = data.Gcore_project.Project.Id,
RegionId = data.Gcore_region.Region.Id,
LoadbalancerId = gcore_loadbalancerv2.Lb.Id,
ListenerId = proxy8080Lblistener.LblistenerId,
Protocol = "PROXY",
LbAlgorithm = "LEAST_CONNECTIONS",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcore.Lblistener;
import com.pulumi.gcore.LblistenerArgs;
import com.pulumi.gcore.Lbpool;
import com.pulumi.gcore.LbpoolArgs;
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) {
var proxy8080Lblistener = new Lblistener("proxy8080Lblistener", LblistenerArgs.builder()
.projectId(data.gcore_project().project().id())
.regionId(data.gcore_region().region().id())
.loadbalancerId(gcore_loadbalancerv2.lb().id())
.protocol("TCP")
.protocolPort(8080)
.build());
var proxy8080Lbpool = new Lbpool("proxy8080Lbpool", LbpoolArgs.builder()
.projectId(data.gcore_project().project().id())
.regionId(data.gcore_region().region().id())
.loadbalancerId(gcore_loadbalancerv2.lb().id())
.listenerId(proxy8080Lblistener.lblistenerId())
.protocol("PROXY")
.lbAlgorithm("LEAST_CONNECTIONS")
.build());
}
}
resources:
proxy8080Lblistener:
type: gcore:Lblistener
properties:
projectId: ${data.gcore_project.project.id}
regionId: ${data.gcore_region.region.id}
loadbalancerId: ${gcore_loadbalancerv2.lb.id}
protocol: TCP
protocolPort: 8080
proxy8080Lbpool:
type: gcore:Lbpool
properties:
projectId: ${data.gcore_project.project.id}
regionId: ${data.gcore_region.region.id}
loadbalancerId: ${gcore_loadbalancerv2.lb.id}
listenerId: ${proxy8080Lblistener.lblistenerId}
protocol: PROXY
lbAlgorithm: LEAST_CONNECTIONS
Create Lbpool Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Lbpool(name: string, args: LbpoolArgs, opts?: CustomResourceOptions);
@overload
def Lbpool(resource_name: str,
args: LbpoolArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Lbpool(resource_name: str,
opts: Optional[ResourceOptions] = None,
protocol: Optional[str] = None,
lb_algorithm: Optional[str] = None,
project_id: Optional[float] = None,
listener_id: Optional[str] = None,
loadbalancer_id: Optional[str] = None,
name: Optional[str] = None,
health_monitor: Optional[LbpoolHealthMonitorArgs] = None,
project_name: Optional[str] = None,
lbpool_id: Optional[str] = None,
region_id: Optional[float] = None,
region_name: Optional[str] = None,
session_persistence: Optional[LbpoolSessionPersistenceArgs] = None,
timeouts: Optional[LbpoolTimeoutsArgs] = None)
func NewLbpool(ctx *Context, name string, args LbpoolArgs, opts ...ResourceOption) (*Lbpool, error)
public Lbpool(string name, LbpoolArgs args, CustomResourceOptions? opts = null)
public Lbpool(String name, LbpoolArgs args)
public Lbpool(String name, LbpoolArgs args, CustomResourceOptions options)
type: gcore:Lbpool
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 LbpoolArgs
- 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 LbpoolArgs
- 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 LbpoolArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args LbpoolArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args LbpoolArgs
- 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 lbpoolResource = new Gcore.Lbpool("lbpoolResource", new()
{
Protocol = "string",
LbAlgorithm = "string",
ProjectId = 0,
ListenerId = "string",
LoadbalancerId = "string",
Name = "string",
HealthMonitor = new Gcore.Inputs.LbpoolHealthMonitorArgs
{
Delay = 0,
MaxRetries = 0,
Timeout = 0,
Type = "string",
ExpectedCodes = "string",
HttpMethod = "string",
Id = "string",
MaxRetriesDown = 0,
UrlPath = "string",
},
ProjectName = "string",
LbpoolId = "string",
RegionId = 0,
RegionName = "string",
SessionPersistence = new Gcore.Inputs.LbpoolSessionPersistenceArgs
{
Type = "string",
CookieName = "string",
PersistenceGranularity = "string",
PersistenceTimeout = 0,
},
Timeouts = new Gcore.Inputs.LbpoolTimeoutsArgs
{
Create = "string",
Delete = "string",
Update = "string",
},
});
example, err := gcore.NewLbpool(ctx, "lbpoolResource", &gcore.LbpoolArgs{
Protocol: pulumi.String("string"),
LbAlgorithm: pulumi.String("string"),
ProjectId: pulumi.Float64(0),
ListenerId: pulumi.String("string"),
LoadbalancerId: pulumi.String("string"),
Name: pulumi.String("string"),
HealthMonitor: &gcore.LbpoolHealthMonitorArgs{
Delay: pulumi.Float64(0),
MaxRetries: pulumi.Float64(0),
Timeout: pulumi.Float64(0),
Type: pulumi.String("string"),
ExpectedCodes: pulumi.String("string"),
HttpMethod: pulumi.String("string"),
Id: pulumi.String("string"),
MaxRetriesDown: pulumi.Float64(0),
UrlPath: pulumi.String("string"),
},
ProjectName: pulumi.String("string"),
LbpoolId: pulumi.String("string"),
RegionId: pulumi.Float64(0),
RegionName: pulumi.String("string"),
SessionPersistence: &gcore.LbpoolSessionPersistenceArgs{
Type: pulumi.String("string"),
CookieName: pulumi.String("string"),
PersistenceGranularity: pulumi.String("string"),
PersistenceTimeout: pulumi.Float64(0),
},
Timeouts: &gcore.LbpoolTimeoutsArgs{
Create: pulumi.String("string"),
Delete: pulumi.String("string"),
Update: pulumi.String("string"),
},
})
var lbpoolResource = new Lbpool("lbpoolResource", LbpoolArgs.builder()
.protocol("string")
.lbAlgorithm("string")
.projectId(0)
.listenerId("string")
.loadbalancerId("string")
.name("string")
.healthMonitor(LbpoolHealthMonitorArgs.builder()
.delay(0)
.maxRetries(0)
.timeout(0)
.type("string")
.expectedCodes("string")
.httpMethod("string")
.id("string")
.maxRetriesDown(0)
.urlPath("string")
.build())
.projectName("string")
.lbpoolId("string")
.regionId(0)
.regionName("string")
.sessionPersistence(LbpoolSessionPersistenceArgs.builder()
.type("string")
.cookieName("string")
.persistenceGranularity("string")
.persistenceTimeout(0)
.build())
.timeouts(LbpoolTimeoutsArgs.builder()
.create("string")
.delete("string")
.update("string")
.build())
.build());
lbpool_resource = gcore.Lbpool("lbpoolResource",
protocol="string",
lb_algorithm="string",
project_id=0,
listener_id="string",
loadbalancer_id="string",
name="string",
health_monitor={
"delay": 0,
"max_retries": 0,
"timeout": 0,
"type": "string",
"expected_codes": "string",
"http_method": "string",
"id": "string",
"max_retries_down": 0,
"url_path": "string",
},
project_name="string",
lbpool_id="string",
region_id=0,
region_name="string",
session_persistence={
"type": "string",
"cookie_name": "string",
"persistence_granularity": "string",
"persistence_timeout": 0,
},
timeouts={
"create": "string",
"delete": "string",
"update": "string",
})
const lbpoolResource = new gcore.Lbpool("lbpoolResource", {
protocol: "string",
lbAlgorithm: "string",
projectId: 0,
listenerId: "string",
loadbalancerId: "string",
name: "string",
healthMonitor: {
delay: 0,
maxRetries: 0,
timeout: 0,
type: "string",
expectedCodes: "string",
httpMethod: "string",
id: "string",
maxRetriesDown: 0,
urlPath: "string",
},
projectName: "string",
lbpoolId: "string",
regionId: 0,
regionName: "string",
sessionPersistence: {
type: "string",
cookieName: "string",
persistenceGranularity: "string",
persistenceTimeout: 0,
},
timeouts: {
create: "string",
"delete": "string",
update: "string",
},
});
type: gcore:Lbpool
properties:
healthMonitor:
delay: 0
expectedCodes: string
httpMethod: string
id: string
maxRetries: 0
maxRetriesDown: 0
timeout: 0
type: string
urlPath: string
lbAlgorithm: string
lbpoolId: string
listenerId: string
loadbalancerId: string
name: string
projectId: 0
projectName: string
protocol: string
regionId: 0
regionName: string
sessionPersistence:
cookieName: string
persistenceGranularity: string
persistenceTimeout: 0
type: string
timeouts:
create: string
delete: string
update: string
Lbpool 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 Lbpool resource accepts the following input properties:
- Lb
Algorithm string - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- Protocol string
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- Health
Monitor LbpoolHealth Monitor - Health Monitor settings for defining health state of members inside this pool.
- Lbpool
Id string - The ID of this resource.
- Listener
Id string - ID of the target listener associated with load balancer to attach newly created pool.
- Loadbalancer
Id string - ID of the target load balancer to attach newly created pool.
- Name string
- Pool name.
- Project
Id double - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - Project
Name string - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - Region
Id double - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - Region
Name string - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - Session
Persistence LbpoolSession Persistence - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- Timeouts
Lbpool
Timeouts
- Lb
Algorithm string - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- Protocol string
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- Health
Monitor LbpoolHealth Monitor Args - Health Monitor settings for defining health state of members inside this pool.
- Lbpool
Id string - The ID of this resource.
- Listener
Id string - ID of the target listener associated with load balancer to attach newly created pool.
- Loadbalancer
Id string - ID of the target load balancer to attach newly created pool.
- Name string
- Pool name.
- Project
Id float64 - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - Project
Name string - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - Region
Id float64 - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - Region
Name string - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - Session
Persistence LbpoolSession Persistence Args - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- Timeouts
Lbpool
Timeouts Args
- lb
Algorithm String - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- protocol String
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- health
Monitor LbpoolHealth Monitor - Health Monitor settings for defining health state of members inside this pool.
- lbpool
Id String - The ID of this resource.
- listener
Id String - ID of the target listener associated with load balancer to attach newly created pool.
- loadbalancer
Id String - ID of the target load balancer to attach newly created pool.
- name String
- Pool name.
- project
Id Double - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - project
Name String - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - region
Id Double - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - region
Name String - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - session
Persistence LbpoolSession Persistence - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- timeouts
Lbpool
Timeouts
- lb
Algorithm string - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- protocol string
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- health
Monitor LbpoolHealth Monitor - Health Monitor settings for defining health state of members inside this pool.
- lbpool
Id string - The ID of this resource.
- listener
Id string - ID of the target listener associated with load balancer to attach newly created pool.
- loadbalancer
Id string - ID of the target load balancer to attach newly created pool.
- name string
- Pool name.
- project
Id number - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - project
Name string - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - region
Id number - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - region
Name string - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - session
Persistence LbpoolSession Persistence - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- timeouts
Lbpool
Timeouts
- lb_
algorithm str - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- protocol str
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- health_
monitor LbpoolHealth Monitor Args - Health Monitor settings for defining health state of members inside this pool.
- lbpool_
id str - The ID of this resource.
- listener_
id str - ID of the target listener associated with load balancer to attach newly created pool.
- loadbalancer_
id str - ID of the target load balancer to attach newly created pool.
- name str
- Pool name.
- project_
id float - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - project_
name str - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - region_
id float - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - region_
name str - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - session_
persistence LbpoolSession Persistence Args - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- timeouts
Lbpool
Timeouts Args
- lb
Algorithm String - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- protocol String
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- health
Monitor Property Map - Health Monitor settings for defining health state of members inside this pool.
- lbpool
Id String - The ID of this resource.
- listener
Id String - ID of the target listener associated with load balancer to attach newly created pool.
- loadbalancer
Id String - ID of the target load balancer to attach newly created pool.
- name String
- Pool name.
- project
Id Number - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - project
Name String - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - region
Id Number - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - region
Name String - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - session
Persistence Property Map - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- timeouts Property Map
Outputs
All input properties are implicitly available as output properties. Additionally, the Lbpool resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Last
Updated string - Datetime when load balancer pool was updated at the last time.
- Id string
- The provider-assigned unique ID for this managed resource.
- Last
Updated string - Datetime when load balancer pool was updated at the last time.
- id String
- The provider-assigned unique ID for this managed resource.
- last
Updated String - Datetime when load balancer pool was updated at the last time.
- id string
- The provider-assigned unique ID for this managed resource.
- last
Updated string - Datetime when load balancer pool was updated at the last time.
- id str
- The provider-assigned unique ID for this managed resource.
- last_
updated str - Datetime when load balancer pool was updated at the last time.
- id String
- The provider-assigned unique ID for this managed resource.
- last
Updated String - Datetime when load balancer pool was updated at the last time.
Look up Existing Lbpool Resource
Get an existing Lbpool 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?: LbpoolState, opts?: CustomResourceOptions): Lbpool
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
health_monitor: Optional[LbpoolHealthMonitorArgs] = None,
last_updated: Optional[str] = None,
lb_algorithm: Optional[str] = None,
lbpool_id: Optional[str] = None,
listener_id: Optional[str] = None,
loadbalancer_id: Optional[str] = None,
name: Optional[str] = None,
project_id: Optional[float] = None,
project_name: Optional[str] = None,
protocol: Optional[str] = None,
region_id: Optional[float] = None,
region_name: Optional[str] = None,
session_persistence: Optional[LbpoolSessionPersistenceArgs] = None,
timeouts: Optional[LbpoolTimeoutsArgs] = None) -> Lbpool
func GetLbpool(ctx *Context, name string, id IDInput, state *LbpoolState, opts ...ResourceOption) (*Lbpool, error)
public static Lbpool Get(string name, Input<string> id, LbpoolState? state, CustomResourceOptions? opts = null)
public static Lbpool get(String name, Output<String> id, LbpoolState state, CustomResourceOptions options)
resources: _: type: gcore:Lbpool 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.
- Health
Monitor LbpoolHealth Monitor - Health Monitor settings for defining health state of members inside this pool.
- Last
Updated string - Datetime when load balancer pool was updated at the last time.
- Lb
Algorithm string - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- Lbpool
Id string - The ID of this resource.
- Listener
Id string - ID of the target listener associated with load balancer to attach newly created pool.
- Loadbalancer
Id string - ID of the target load balancer to attach newly created pool.
- Name string
- Pool name.
- Project
Id double - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - Project
Name string - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - Protocol string
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- Region
Id double - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - Region
Name string - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - Session
Persistence LbpoolSession Persistence - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- Timeouts
Lbpool
Timeouts
- Health
Monitor LbpoolHealth Monitor Args - Health Monitor settings for defining health state of members inside this pool.
- Last
Updated string - Datetime when load balancer pool was updated at the last time.
- Lb
Algorithm string - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- Lbpool
Id string - The ID of this resource.
- Listener
Id string - ID of the target listener associated with load balancer to attach newly created pool.
- Loadbalancer
Id string - ID of the target load balancer to attach newly created pool.
- Name string
- Pool name.
- Project
Id float64 - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - Project
Name string - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - Protocol string
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- Region
Id float64 - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - Region
Name string - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - Session
Persistence LbpoolSession Persistence Args - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- Timeouts
Lbpool
Timeouts Args
- health
Monitor LbpoolHealth Monitor - Health Monitor settings for defining health state of members inside this pool.
- last
Updated String - Datetime when load balancer pool was updated at the last time.
- lb
Algorithm String - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- lbpool
Id String - The ID of this resource.
- listener
Id String - ID of the target listener associated with load balancer to attach newly created pool.
- loadbalancer
Id String - ID of the target load balancer to attach newly created pool.
- name String
- Pool name.
- project
Id Double - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - project
Name String - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - protocol String
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- region
Id Double - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - region
Name String - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - session
Persistence LbpoolSession Persistence - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- timeouts
Lbpool
Timeouts
- health
Monitor LbpoolHealth Monitor - Health Monitor settings for defining health state of members inside this pool.
- last
Updated string - Datetime when load balancer pool was updated at the last time.
- lb
Algorithm string - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- lbpool
Id string - The ID of this resource.
- listener
Id string - ID of the target listener associated with load balancer to attach newly created pool.
- loadbalancer
Id string - ID of the target load balancer to attach newly created pool.
- name string
- Pool name.
- project
Id number - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - project
Name string - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - protocol string
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- region
Id number - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - region
Name string - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - session
Persistence LbpoolSession Persistence - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- timeouts
Lbpool
Timeouts
- health_
monitor LbpoolHealth Monitor Args - Health Monitor settings for defining health state of members inside this pool.
- last_
updated str - Datetime when load balancer pool was updated at the last time.
- lb_
algorithm str - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- lbpool_
id str - The ID of this resource.
- listener_
id str - ID of the target listener associated with load balancer to attach newly created pool.
- loadbalancer_
id str - ID of the target load balancer to attach newly created pool.
- name str
- Pool name.
- project_
id float - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - project_
name str - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - protocol str
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- region_
id float - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - region_
name str - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - session_
persistence LbpoolSession Persistence Args - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- timeouts
Lbpool
Timeouts Args
- health
Monitor Property Map - Health Monitor settings for defining health state of members inside this pool.
- last
Updated String - Datetime when load balancer pool was updated at the last time.
- lb
Algorithm String - Available values is 'ROUNDROBIN', 'LEASTCONNECTIONS', 'SOURCE_IP'
- lbpool
Id String - The ID of this resource.
- listener
Id String - ID of the target listener associated with load balancer to attach newly created pool.
- loadbalancer
Id String - ID of the target load balancer to attach newly created pool.
- name String
- Pool name.
- project
Id Number - ID of the desired project to create load balancer pool in. Alternative for
project_name
. One of them should be specified. - project
Name String - Name of the desired project to create load balancer pool in. Alternative for
project_id
. One of them should be specified. - protocol String
- Available values are 'HTTP', 'HTTPS', 'TCP', 'UDP', 'PROXY', 'PROXYV2'
- region
Id Number - ID of the desired region to create load balancer pool in. Alternative for
region_name
. One of them should be specified. - region
Name String - Name of the desired region to create load balancer pool in. Alternative for
region_id
. One of them should be specified. - session
Persistence Property Map - Pool session persistence tells the load balancer to attempt to send future requests from a client to the same backend member as the initial request.
- timeouts Property Map
Supporting Types
LbpoolHealthMonitor, LbpoolHealthMonitorArgs
- Delay double
- The time, in seconds, between sending probes to members.
- Max
Retries double - The number of successful checks before changing the operating status of the member to ONLINE.
- Timeout double
- The maximum time, in seconds, that a monitor waits to connect before it times out.
- Type string
- Available values is 'HTTP', 'HTTPS', 'PING', 'TCP', 'TLS-HELLO', 'UDP-CONNECT
- Expected
Codes string - The list of HTTP status codes expected in response from the member to declare it healthy.
- Http
Method string - The HTTP method that the health monitor uses for requests.
- Id string
- Health Monitor ID.
- Max
Retries doubleDown - The number of allowed check failures before changing the operating status of the member to ERROR.
- Url
Path string - The HTTP URL path of the request sent by the monitor to test the health of a backend member.
- Delay float64
- The time, in seconds, between sending probes to members.
- Max
Retries float64 - The number of successful checks before changing the operating status of the member to ONLINE.
- Timeout float64
- The maximum time, in seconds, that a monitor waits to connect before it times out.
- Type string
- Available values is 'HTTP', 'HTTPS', 'PING', 'TCP', 'TLS-HELLO', 'UDP-CONNECT
- Expected
Codes string - The list of HTTP status codes expected in response from the member to declare it healthy.
- Http
Method string - The HTTP method that the health monitor uses for requests.
- Id string
- Health Monitor ID.
- Max
Retries float64Down - The number of allowed check failures before changing the operating status of the member to ERROR.
- Url
Path string - The HTTP URL path of the request sent by the monitor to test the health of a backend member.
- delay Double
- The time, in seconds, between sending probes to members.
- max
Retries Double - The number of successful checks before changing the operating status of the member to ONLINE.
- timeout Double
- The maximum time, in seconds, that a monitor waits to connect before it times out.
- type String
- Available values is 'HTTP', 'HTTPS', 'PING', 'TCP', 'TLS-HELLO', 'UDP-CONNECT
- expected
Codes String - The list of HTTP status codes expected in response from the member to declare it healthy.
- http
Method String - The HTTP method that the health monitor uses for requests.
- id String
- Health Monitor ID.
- max
Retries DoubleDown - The number of allowed check failures before changing the operating status of the member to ERROR.
- url
Path String - The HTTP URL path of the request sent by the monitor to test the health of a backend member.
- delay number
- The time, in seconds, between sending probes to members.
- max
Retries number - The number of successful checks before changing the operating status of the member to ONLINE.
- timeout number
- The maximum time, in seconds, that a monitor waits to connect before it times out.
- type string
- Available values is 'HTTP', 'HTTPS', 'PING', 'TCP', 'TLS-HELLO', 'UDP-CONNECT
- expected
Codes string - The list of HTTP status codes expected in response from the member to declare it healthy.
- http
Method string - The HTTP method that the health monitor uses for requests.
- id string
- Health Monitor ID.
- max
Retries numberDown - The number of allowed check failures before changing the operating status of the member to ERROR.
- url
Path string - The HTTP URL path of the request sent by the monitor to test the health of a backend member.
- delay float
- The time, in seconds, between sending probes to members.
- max_
retries float - The number of successful checks before changing the operating status of the member to ONLINE.
- timeout float
- The maximum time, in seconds, that a monitor waits to connect before it times out.
- type str
- Available values is 'HTTP', 'HTTPS', 'PING', 'TCP', 'TLS-HELLO', 'UDP-CONNECT
- expected_
codes str - The list of HTTP status codes expected in response from the member to declare it healthy.
- http_
method str - The HTTP method that the health monitor uses for requests.
- id str
- Health Monitor ID.
- max_
retries_ floatdown - The number of allowed check failures before changing the operating status of the member to ERROR.
- url_
path str - The HTTP URL path of the request sent by the monitor to test the health of a backend member.
- delay Number
- The time, in seconds, between sending probes to members.
- max
Retries Number - The number of successful checks before changing the operating status of the member to ONLINE.
- timeout Number
- The maximum time, in seconds, that a monitor waits to connect before it times out.
- type String
- Available values is 'HTTP', 'HTTPS', 'PING', 'TCP', 'TLS-HELLO', 'UDP-CONNECT
- expected
Codes String - The list of HTTP status codes expected in response from the member to declare it healthy.
- http
Method String - The HTTP method that the health monitor uses for requests.
- id String
- Health Monitor ID.
- max
Retries NumberDown - The number of allowed check failures before changing the operating status of the member to ERROR.
- url
Path String - The HTTP URL path of the request sent by the monitor to test the health of a backend member.
LbpoolSessionPersistence, LbpoolSessionPersistenceArgs
- Type string
- One of: 'APPCOOKIE' (an application supplied cookie), 'HTTPCOOKIE' (a cookie created by the load balancer), 'SOURCE_IP' (the source IP address).
- string
- The name of the application cookie to use for session persistence.
- Persistence
Granularity string - The netmask used to determine SCTP or UDP SOURCE_IP session persistence.
- Persistence
Timeout double - The timeout, in seconds, after which a SCTP or UDP flow may be rescheduled to a different member.
- Type string
- One of: 'APPCOOKIE' (an application supplied cookie), 'HTTPCOOKIE' (a cookie created by the load balancer), 'SOURCE_IP' (the source IP address).
- string
- The name of the application cookie to use for session persistence.
- Persistence
Granularity string - The netmask used to determine SCTP or UDP SOURCE_IP session persistence.
- Persistence
Timeout float64 - The timeout, in seconds, after which a SCTP or UDP flow may be rescheduled to a different member.
- type String
- One of: 'APPCOOKIE' (an application supplied cookie), 'HTTPCOOKIE' (a cookie created by the load balancer), 'SOURCE_IP' (the source IP address).
- String
- The name of the application cookie to use for session persistence.
- persistence
Granularity String - The netmask used to determine SCTP or UDP SOURCE_IP session persistence.
- persistence
Timeout Double - The timeout, in seconds, after which a SCTP or UDP flow may be rescheduled to a different member.
- type string
- One of: 'APPCOOKIE' (an application supplied cookie), 'HTTPCOOKIE' (a cookie created by the load balancer), 'SOURCE_IP' (the source IP address).
- string
- The name of the application cookie to use for session persistence.
- persistence
Granularity string - The netmask used to determine SCTP or UDP SOURCE_IP session persistence.
- persistence
Timeout number - The timeout, in seconds, after which a SCTP or UDP flow may be rescheduled to a different member.
- type str
- One of: 'APPCOOKIE' (an application supplied cookie), 'HTTPCOOKIE' (a cookie created by the load balancer), 'SOURCE_IP' (the source IP address).
- str
- The name of the application cookie to use for session persistence.
- persistence_
granularity str - The netmask used to determine SCTP or UDP SOURCE_IP session persistence.
- persistence_
timeout float - The timeout, in seconds, after which a SCTP or UDP flow may be rescheduled to a different member.
- type String
- One of: 'APPCOOKIE' (an application supplied cookie), 'HTTPCOOKIE' (a cookie created by the load balancer), 'SOURCE_IP' (the source IP address).
- String
- The name of the application cookie to use for session persistence.
- persistence
Granularity String - The netmask used to determine SCTP or UDP SOURCE_IP session persistence.
- persistence
Timeout Number - The timeout, in seconds, after which a SCTP or UDP flow may be rescheduled to a different member.
LbpoolTimeouts, LbpoolTimeoutsArgs
Import
import using <project_id>:<region_id>:<lbpool_id> format
$ pulumi import gcore:index/lbpool:Lbpool lbpool1 1:6:447d2959-8ae0-4ca0-8d47-9f050a3637d7
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- gcore g-core/terraform-provider-gcore
- License
- Notes
- This Pulumi package is based on the
gcore
Terraform Provider.