yandex.LbNetworkLoadBalancer
Explore with Pulumi AI
Creates a network load balancer in the specified folder using the data specified in the config. For more information, see the official documentation.
Example Usage
using Pulumi;
using Yandex = Pulumi.Yandex;
class MyStack : Stack
{
public MyStack()
{
var foo = new Yandex.LbNetworkLoadBalancer("foo", new Yandex.LbNetworkLoadBalancerArgs
{
AttachedTargetGroups =
{
new Yandex.Inputs.LbNetworkLoadBalancerAttachedTargetGroupArgs
{
Healthchecks =
{
new Yandex.Inputs.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckArgs
{
HttpOptions = new Yandex.Inputs.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckHttpOptionsArgs
{
Path = "/ping",
Port = 8080,
},
Name = "http",
},
},
TargetGroupId = yandex_lb_target_group.My_target_group.Id,
},
},
Listeners =
{
new Yandex.Inputs.LbNetworkLoadBalancerListenerArgs
{
ExternalAddressSpec = new Yandex.Inputs.LbNetworkLoadBalancerListenerExternalAddressSpecArgs
{
IpVersion = "ipv4",
},
Name = "my-listener",
Port = 8080,
},
},
});
}
}
package main
import (
"github.com/pulumi/pulumi-yandex/sdk/go/yandex"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := yandex.NewLbNetworkLoadBalancer(ctx, "foo", &yandex.LbNetworkLoadBalancerArgs{
AttachedTargetGroups: LbNetworkLoadBalancerAttachedTargetGroupArray{
&LbNetworkLoadBalancerAttachedTargetGroupArgs{
Healthchecks: LbNetworkLoadBalancerAttachedTargetGroupHealthcheckArray{
&LbNetworkLoadBalancerAttachedTargetGroupHealthcheckArgs{
HttpOptions: &LbNetworkLoadBalancerAttachedTargetGroupHealthcheckHttpOptionsArgs{
Path: pulumi.String("/ping"),
Port: pulumi.Int(8080),
},
Name: pulumi.String("http"),
},
},
TargetGroupId: pulumi.Any(yandex_lb_target_group.My - target - group.Id),
},
},
Listeners: LbNetworkLoadBalancerListenerArray{
&LbNetworkLoadBalancerListenerArgs{
ExternalAddressSpec: &LbNetworkLoadBalancerListenerExternalAddressSpecArgs{
IpVersion: pulumi.String("ipv4"),
},
Name: pulumi.String("my-listener"),
Port: pulumi.Int(8080),
},
},
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_yandex as yandex
foo = yandex.LbNetworkLoadBalancer("foo",
attached_target_groups=[yandex.LbNetworkLoadBalancerAttachedTargetGroupArgs(
healthchecks=[yandex.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckArgs(
http_options=yandex.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckHttpOptionsArgs(
path="/ping",
port=8080,
),
name="http",
)],
target_group_id=yandex_lb_target_group["my-target-group"]["id"],
)],
listeners=[yandex.LbNetworkLoadBalancerListenerArgs(
external_address_spec=yandex.LbNetworkLoadBalancerListenerExternalAddressSpecArgs(
ip_version="ipv4",
),
name="my-listener",
port=8080,
)])
import * as pulumi from "@pulumi/pulumi";
import * as yandex from "@pulumi/yandex";
const foo = new yandex.LbNetworkLoadBalancer("foo", {
attachedTargetGroups: [{
healthchecks: [{
httpOptions: {
path: "/ping",
port: 8080,
},
name: "http",
}],
targetGroupId: yandex_lb_target_group_my_target_group.id,
}],
listeners: [{
externalAddressSpec: {
ipVersion: "ipv4",
},
name: "my-listener",
port: 8080,
}],
});
Coming soon!
Create LbNetworkLoadBalancer Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new LbNetworkLoadBalancer(name: string, args?: LbNetworkLoadBalancerArgs, opts?: CustomResourceOptions);
@overload
def LbNetworkLoadBalancer(resource_name: str,
args: Optional[LbNetworkLoadBalancerArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def LbNetworkLoadBalancer(resource_name: str,
opts: Optional[ResourceOptions] = None,
attached_target_groups: Optional[Sequence[LbNetworkLoadBalancerAttachedTargetGroupArgs]] = None,
description: Optional[str] = None,
folder_id: Optional[str] = None,
labels: Optional[Mapping[str, str]] = None,
listeners: Optional[Sequence[LbNetworkLoadBalancerListenerArgs]] = None,
name: Optional[str] = None,
region_id: Optional[str] = None,
type: Optional[str] = None)
func NewLbNetworkLoadBalancer(ctx *Context, name string, args *LbNetworkLoadBalancerArgs, opts ...ResourceOption) (*LbNetworkLoadBalancer, error)
public LbNetworkLoadBalancer(string name, LbNetworkLoadBalancerArgs? args = null, CustomResourceOptions? opts = null)
public LbNetworkLoadBalancer(String name, LbNetworkLoadBalancerArgs args)
public LbNetworkLoadBalancer(String name, LbNetworkLoadBalancerArgs args, CustomResourceOptions options)
type: yandex:LbNetworkLoadBalancer
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 LbNetworkLoadBalancerArgs
- 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 LbNetworkLoadBalancerArgs
- 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 LbNetworkLoadBalancerArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args LbNetworkLoadBalancerArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args LbNetworkLoadBalancerArgs
- 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 lbNetworkLoadBalancerResource = new Yandex.LbNetworkLoadBalancer("lbNetworkLoadBalancerResource", new()
{
AttachedTargetGroups = new[]
{
new Yandex.Inputs.LbNetworkLoadBalancerAttachedTargetGroupArgs
{
Healthchecks = new[]
{
new Yandex.Inputs.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckArgs
{
Name = "string",
HealthyThreshold = 0,
HttpOptions = new Yandex.Inputs.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckHttpOptionsArgs
{
Port = 0,
Path = "string",
},
Interval = 0,
TcpOptions = new Yandex.Inputs.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckTcpOptionsArgs
{
Port = 0,
},
Timeout = 0,
UnhealthyThreshold = 0,
},
},
TargetGroupId = "string",
},
},
Description = "string",
FolderId = "string",
Labels =
{
{ "string", "string" },
},
Listeners = new[]
{
new Yandex.Inputs.LbNetworkLoadBalancerListenerArgs
{
Name = "string",
Port = 0,
ExternalAddressSpec = new Yandex.Inputs.LbNetworkLoadBalancerListenerExternalAddressSpecArgs
{
Address = "string",
IpVersion = "string",
},
InternalAddressSpec = new Yandex.Inputs.LbNetworkLoadBalancerListenerInternalAddressSpecArgs
{
SubnetId = "string",
Address = "string",
IpVersion = "string",
},
Protocol = "string",
TargetPort = 0,
},
},
Name = "string",
RegionId = "string",
Type = "string",
});
example, err := yandex.NewLbNetworkLoadBalancer(ctx, "lbNetworkLoadBalancerResource", &yandex.LbNetworkLoadBalancerArgs{
AttachedTargetGroups: yandex.LbNetworkLoadBalancerAttachedTargetGroupArray{
&yandex.LbNetworkLoadBalancerAttachedTargetGroupArgs{
Healthchecks: yandex.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckArray{
&yandex.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckArgs{
Name: pulumi.String("string"),
HealthyThreshold: pulumi.Int(0),
HttpOptions: &yandex.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckHttpOptionsArgs{
Port: pulumi.Int(0),
Path: pulumi.String("string"),
},
Interval: pulumi.Int(0),
TcpOptions: &yandex.LbNetworkLoadBalancerAttachedTargetGroupHealthcheckTcpOptionsArgs{
Port: pulumi.Int(0),
},
Timeout: pulumi.Int(0),
UnhealthyThreshold: pulumi.Int(0),
},
},
TargetGroupId: pulumi.String("string"),
},
},
Description: pulumi.String("string"),
FolderId: pulumi.String("string"),
Labels: pulumi.StringMap{
"string": pulumi.String("string"),
},
Listeners: yandex.LbNetworkLoadBalancerListenerArray{
&yandex.LbNetworkLoadBalancerListenerArgs{
Name: pulumi.String("string"),
Port: pulumi.Int(0),
ExternalAddressSpec: &yandex.LbNetworkLoadBalancerListenerExternalAddressSpecArgs{
Address: pulumi.String("string"),
IpVersion: pulumi.String("string"),
},
InternalAddressSpec: &yandex.LbNetworkLoadBalancerListenerInternalAddressSpecArgs{
SubnetId: pulumi.String("string"),
Address: pulumi.String("string"),
IpVersion: pulumi.String("string"),
},
Protocol: pulumi.String("string"),
TargetPort: pulumi.Int(0),
},
},
Name: pulumi.String("string"),
RegionId: pulumi.String("string"),
Type: pulumi.String("string"),
})
var lbNetworkLoadBalancerResource = new LbNetworkLoadBalancer("lbNetworkLoadBalancerResource", LbNetworkLoadBalancerArgs.builder()
.attachedTargetGroups(LbNetworkLoadBalancerAttachedTargetGroupArgs.builder()
.healthchecks(LbNetworkLoadBalancerAttachedTargetGroupHealthcheckArgs.builder()
.name("string")
.healthyThreshold(0)
.httpOptions(LbNetworkLoadBalancerAttachedTargetGroupHealthcheckHttpOptionsArgs.builder()
.port(0)
.path("string")
.build())
.interval(0)
.tcpOptions(LbNetworkLoadBalancerAttachedTargetGroupHealthcheckTcpOptionsArgs.builder()
.port(0)
.build())
.timeout(0)
.unhealthyThreshold(0)
.build())
.targetGroupId("string")
.build())
.description("string")
.folderId("string")
.labels(Map.of("string", "string"))
.listeners(LbNetworkLoadBalancerListenerArgs.builder()
.name("string")
.port(0)
.externalAddressSpec(LbNetworkLoadBalancerListenerExternalAddressSpecArgs.builder()
.address("string")
.ipVersion("string")
.build())
.internalAddressSpec(LbNetworkLoadBalancerListenerInternalAddressSpecArgs.builder()
.subnetId("string")
.address("string")
.ipVersion("string")
.build())
.protocol("string")
.targetPort(0)
.build())
.name("string")
.regionId("string")
.type("string")
.build());
lb_network_load_balancer_resource = yandex.LbNetworkLoadBalancer("lbNetworkLoadBalancerResource",
attached_target_groups=[{
"healthchecks": [{
"name": "string",
"healthy_threshold": 0,
"http_options": {
"port": 0,
"path": "string",
},
"interval": 0,
"tcp_options": {
"port": 0,
},
"timeout": 0,
"unhealthy_threshold": 0,
}],
"target_group_id": "string",
}],
description="string",
folder_id="string",
labels={
"string": "string",
},
listeners=[{
"name": "string",
"port": 0,
"external_address_spec": {
"address": "string",
"ip_version": "string",
},
"internal_address_spec": {
"subnet_id": "string",
"address": "string",
"ip_version": "string",
},
"protocol": "string",
"target_port": 0,
}],
name="string",
region_id="string",
type="string")
const lbNetworkLoadBalancerResource = new yandex.LbNetworkLoadBalancer("lbNetworkLoadBalancerResource", {
attachedTargetGroups: [{
healthchecks: [{
name: "string",
healthyThreshold: 0,
httpOptions: {
port: 0,
path: "string",
},
interval: 0,
tcpOptions: {
port: 0,
},
timeout: 0,
unhealthyThreshold: 0,
}],
targetGroupId: "string",
}],
description: "string",
folderId: "string",
labels: {
string: "string",
},
listeners: [{
name: "string",
port: 0,
externalAddressSpec: {
address: "string",
ipVersion: "string",
},
internalAddressSpec: {
subnetId: "string",
address: "string",
ipVersion: "string",
},
protocol: "string",
targetPort: 0,
}],
name: "string",
regionId: "string",
type: "string",
});
type: yandex:LbNetworkLoadBalancer
properties:
attachedTargetGroups:
- healthchecks:
- healthyThreshold: 0
httpOptions:
path: string
port: 0
interval: 0
name: string
tcpOptions:
port: 0
timeout: 0
unhealthyThreshold: 0
targetGroupId: string
description: string
folderId: string
labels:
string: string
listeners:
- externalAddressSpec:
address: string
ipVersion: string
internalAddressSpec:
address: string
ipVersion: string
subnetId: string
name: string
port: 0
protocol: string
targetPort: 0
name: string
regionId: string
type: string
LbNetworkLoadBalancer 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 LbNetworkLoadBalancer resource accepts the following input properties:
- Attached
Target List<LbGroups Network Load Balancer Attached Target Group> - An AttachedTargetGroup resource. The structure is documented below.
- Description string
- An optional description of the network load balancer. Provide this property when you create the resource.
- Folder
Id string - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- Labels Dictionary<string, string>
- Labels to assign to this network load balancer. A list of key/value pairs.
- Listeners
List<Lb
Network Load Balancer Listener> - Listener specification that will be used by a network load balancer. The structure is documented below.
- Name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- Region
Id string - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- Type string
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- Attached
Target []LbGroups Network Load Balancer Attached Target Group Args - An AttachedTargetGroup resource. The structure is documented below.
- Description string
- An optional description of the network load balancer. Provide this property when you create the resource.
- Folder
Id string - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- Labels map[string]string
- Labels to assign to this network load balancer. A list of key/value pairs.
- Listeners
[]Lb
Network Load Balancer Listener Args - Listener specification that will be used by a network load balancer. The structure is documented below.
- Name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- Region
Id string - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- Type string
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- attached
Target List<LbGroups Network Load Balancer Attached Target Group> - An AttachedTargetGroup resource. The structure is documented below.
- description String
- An optional description of the network load balancer. Provide this property when you create the resource.
- folder
Id String - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- labels Map<String,String>
- Labels to assign to this network load balancer. A list of key/value pairs.
- listeners
List<Lb
Network Load Balancer Listener> - Listener specification that will be used by a network load balancer. The structure is documented below.
- name String
- Name of the listener. The name must be unique for each listener on a single load balancer.
- region
Id String - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- type String
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- attached
Target LbGroups Network Load Balancer Attached Target Group[] - An AttachedTargetGroup resource. The structure is documented below.
- description string
- An optional description of the network load balancer. Provide this property when you create the resource.
- folder
Id string - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- labels {[key: string]: string}
- Labels to assign to this network load balancer. A list of key/value pairs.
- listeners
Lb
Network Load Balancer Listener[] - Listener specification that will be used by a network load balancer. The structure is documented below.
- name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- region
Id string - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- type string
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- attached_
target_ Sequence[Lbgroups Network Load Balancer Attached Target Group Args] - An AttachedTargetGroup resource. The structure is documented below.
- description str
- An optional description of the network load balancer. Provide this property when you create the resource.
- folder_
id str - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- labels Mapping[str, str]
- Labels to assign to this network load balancer. A list of key/value pairs.
- listeners
Sequence[Lb
Network Load Balancer Listener Args] - Listener specification that will be used by a network load balancer. The structure is documented below.
- name str
- Name of the listener. The name must be unique for each listener on a single load balancer.
- region_
id str - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- type str
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- attached
Target List<Property Map>Groups - An AttachedTargetGroup resource. The structure is documented below.
- description String
- An optional description of the network load balancer. Provide this property when you create the resource.
- folder
Id String - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- labels Map<String>
- Labels to assign to this network load balancer. A list of key/value pairs.
- listeners List<Property Map>
- Listener specification that will be used by a network load balancer. The structure is documented below.
- name String
- Name of the listener. The name must be unique for each listener on a single load balancer.
- region
Id String - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- type String
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
Outputs
All input properties are implicitly available as output properties. Additionally, the LbNetworkLoadBalancer resource produces the following output properties:
- created_
at str - The network load balancer creation timestamp.
- id str
- The provider-assigned unique ID for this managed resource.
Look up Existing LbNetworkLoadBalancer Resource
Get an existing LbNetworkLoadBalancer 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?: LbNetworkLoadBalancerState, opts?: CustomResourceOptions): LbNetworkLoadBalancer
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
attached_target_groups: Optional[Sequence[LbNetworkLoadBalancerAttachedTargetGroupArgs]] = None,
created_at: Optional[str] = None,
description: Optional[str] = None,
folder_id: Optional[str] = None,
labels: Optional[Mapping[str, str]] = None,
listeners: Optional[Sequence[LbNetworkLoadBalancerListenerArgs]] = None,
name: Optional[str] = None,
region_id: Optional[str] = None,
type: Optional[str] = None) -> LbNetworkLoadBalancer
func GetLbNetworkLoadBalancer(ctx *Context, name string, id IDInput, state *LbNetworkLoadBalancerState, opts ...ResourceOption) (*LbNetworkLoadBalancer, error)
public static LbNetworkLoadBalancer Get(string name, Input<string> id, LbNetworkLoadBalancerState? state, CustomResourceOptions? opts = null)
public static LbNetworkLoadBalancer get(String name, Output<String> id, LbNetworkLoadBalancerState 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.
- Attached
Target List<LbGroups Network Load Balancer Attached Target Group> - An AttachedTargetGroup resource. The structure is documented below.
- Created
At string - The network load balancer creation timestamp.
- Description string
- An optional description of the network load balancer. Provide this property when you create the resource.
- Folder
Id string - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- Labels Dictionary<string, string>
- Labels to assign to this network load balancer. A list of key/value pairs.
- Listeners
List<Lb
Network Load Balancer Listener> - Listener specification that will be used by a network load balancer. The structure is documented below.
- Name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- Region
Id string - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- Type string
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- Attached
Target []LbGroups Network Load Balancer Attached Target Group Args - An AttachedTargetGroup resource. The structure is documented below.
- Created
At string - The network load balancer creation timestamp.
- Description string
- An optional description of the network load balancer. Provide this property when you create the resource.
- Folder
Id string - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- Labels map[string]string
- Labels to assign to this network load balancer. A list of key/value pairs.
- Listeners
[]Lb
Network Load Balancer Listener Args - Listener specification that will be used by a network load balancer. The structure is documented below.
- Name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- Region
Id string - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- Type string
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- attached
Target List<LbGroups Network Load Balancer Attached Target Group> - An AttachedTargetGroup resource. The structure is documented below.
- created
At String - The network load balancer creation timestamp.
- description String
- An optional description of the network load balancer. Provide this property when you create the resource.
- folder
Id String - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- labels Map<String,String>
- Labels to assign to this network load balancer. A list of key/value pairs.
- listeners
List<Lb
Network Load Balancer Listener> - Listener specification that will be used by a network load balancer. The structure is documented below.
- name String
- Name of the listener. The name must be unique for each listener on a single load balancer.
- region
Id String - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- type String
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- attached
Target LbGroups Network Load Balancer Attached Target Group[] - An AttachedTargetGroup resource. The structure is documented below.
- created
At string - The network load balancer creation timestamp.
- description string
- An optional description of the network load balancer. Provide this property when you create the resource.
- folder
Id string - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- labels {[key: string]: string}
- Labels to assign to this network load balancer. A list of key/value pairs.
- listeners
Lb
Network Load Balancer Listener[] - Listener specification that will be used by a network load balancer. The structure is documented below.
- name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- region
Id string - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- type string
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- attached_
target_ Sequence[Lbgroups Network Load Balancer Attached Target Group Args] - An AttachedTargetGroup resource. The structure is documented below.
- created_
at str - The network load balancer creation timestamp.
- description str
- An optional description of the network load balancer. Provide this property when you create the resource.
- folder_
id str - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- labels Mapping[str, str]
- Labels to assign to this network load balancer. A list of key/value pairs.
- listeners
Sequence[Lb
Network Load Balancer Listener Args] - Listener specification that will be used by a network load balancer. The structure is documented below.
- name str
- Name of the listener. The name must be unique for each listener on a single load balancer.
- region_
id str - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- type str
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
- attached
Target List<Property Map>Groups - An AttachedTargetGroup resource. The structure is documented below.
- created
At String - The network load balancer creation timestamp.
- description String
- An optional description of the network load balancer. Provide this property when you create the resource.
- folder
Id String - The ID of the folder to which the resource belongs. If omitted, the provider folder is used.
- labels Map<String>
- Labels to assign to this network load balancer. A list of key/value pairs.
- listeners List<Property Map>
- Listener specification that will be used by a network load balancer. The structure is documented below.
- name String
- Name of the listener. The name must be unique for each listener on a single load balancer.
- region
Id String - ID of the availability zone where the network load balancer resides. The default is 'ru-central1'.
- type String
- Type of the network load balancer. Must be one of 'external' or 'internal'. The default is 'external'.
Supporting Types
LbNetworkLoadBalancerAttachedTargetGroup, LbNetworkLoadBalancerAttachedTargetGroupArgs
- Healthchecks
List<Lb
Network Load Balancer Attached Target Group Healthcheck> - A HealthCheck resource. The structure is documented below.
- Target
Group stringId - ID of the target group.
- Healthchecks
[]Lb
Network Load Balancer Attached Target Group Healthcheck - A HealthCheck resource. The structure is documented below.
- Target
Group stringId - ID of the target group.
- healthchecks
List<Lb
Network Load Balancer Attached Target Group Healthcheck> - A HealthCheck resource. The structure is documented below.
- target
Group StringId - ID of the target group.
- healthchecks
Lb
Network Load Balancer Attached Target Group Healthcheck[] - A HealthCheck resource. The structure is documented below.
- target
Group stringId - ID of the target group.
- healthchecks
Sequence[Lb
Network Load Balancer Attached Target Group Healthcheck] - A HealthCheck resource. The structure is documented below.
- target_
group_ strid - ID of the target group.
- healthchecks List<Property Map>
- A HealthCheck resource. The structure is documented below.
- target
Group StringId - ID of the target group.
LbNetworkLoadBalancerAttachedTargetGroupHealthcheck, LbNetworkLoadBalancerAttachedTargetGroupHealthcheckArgs
- Name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- Healthy
Threshold int - Number of successful health checks required in order to set the
HEALTHY
status for the target. - Http
Options LbNetwork Load Balancer Attached Target Group Healthcheck Http Options - Options for HTTP health check. The structure is documented below.
- Interval int
- The interval between health checks. The default is 2 seconds.
- Tcp
Options LbNetwork Load Balancer Attached Target Group Healthcheck Tcp Options - Options for TCP health check. The structure is documented below.
- Timeout int
- Timeout for a target to return a response for the health check. The default is 1 second.
- Unhealthy
Threshold int - Number of failed health checks before changing the status to
UNHEALTHY
. The default is 2.
- Name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- Healthy
Threshold int - Number of successful health checks required in order to set the
HEALTHY
status for the target. - Http
Options LbNetwork Load Balancer Attached Target Group Healthcheck Http Options - Options for HTTP health check. The structure is documented below.
- Interval int
- The interval between health checks. The default is 2 seconds.
- Tcp
Options LbNetwork Load Balancer Attached Target Group Healthcheck Tcp Options - Options for TCP health check. The structure is documented below.
- Timeout int
- Timeout for a target to return a response for the health check. The default is 1 second.
- Unhealthy
Threshold int - Number of failed health checks before changing the status to
UNHEALTHY
. The default is 2.
- name String
- Name of the listener. The name must be unique for each listener on a single load balancer.
- healthy
Threshold Integer - Number of successful health checks required in order to set the
HEALTHY
status for the target. - http
Options LbNetwork Load Balancer Attached Target Group Healthcheck Http Options - Options for HTTP health check. The structure is documented below.
- interval Integer
- The interval between health checks. The default is 2 seconds.
- tcp
Options LbNetwork Load Balancer Attached Target Group Healthcheck Tcp Options - Options for TCP health check. The structure is documented below.
- timeout Integer
- Timeout for a target to return a response for the health check. The default is 1 second.
- unhealthy
Threshold Integer - Number of failed health checks before changing the status to
UNHEALTHY
. The default is 2.
- name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- healthy
Threshold number - Number of successful health checks required in order to set the
HEALTHY
status for the target. - http
Options LbNetwork Load Balancer Attached Target Group Healthcheck Http Options - Options for HTTP health check. The structure is documented below.
- interval number
- The interval between health checks. The default is 2 seconds.
- tcp
Options LbNetwork Load Balancer Attached Target Group Healthcheck Tcp Options - Options for TCP health check. The structure is documented below.
- timeout number
- Timeout for a target to return a response for the health check. The default is 1 second.
- unhealthy
Threshold number - Number of failed health checks before changing the status to
UNHEALTHY
. The default is 2.
- name str
- Name of the listener. The name must be unique for each listener on a single load balancer.
- healthy_
threshold int - Number of successful health checks required in order to set the
HEALTHY
status for the target. - http_
options LbNetwork Load Balancer Attached Target Group Healthcheck Http Options - Options for HTTP health check. The structure is documented below.
- interval int
- The interval between health checks. The default is 2 seconds.
- tcp_
options LbNetwork Load Balancer Attached Target Group Healthcheck Tcp Options - Options for TCP health check. The structure is documented below.
- timeout int
- Timeout for a target to return a response for the health check. The default is 1 second.
- unhealthy_
threshold int - Number of failed health checks before changing the status to
UNHEALTHY
. The default is 2.
- name String
- Name of the listener. The name must be unique for each listener on a single load balancer.
- healthy
Threshold Number - Number of successful health checks required in order to set the
HEALTHY
status for the target. - http
Options Property Map - Options for HTTP health check. The structure is documented below.
- interval Number
- The interval between health checks. The default is 2 seconds.
- tcp
Options Property Map - Options for TCP health check. The structure is documented below.
- timeout Number
- Timeout for a target to return a response for the health check. The default is 1 second.
- unhealthy
Threshold Number - Number of failed health checks before changing the status to
UNHEALTHY
. The default is 2.
LbNetworkLoadBalancerAttachedTargetGroupHealthcheckHttpOptions, LbNetworkLoadBalancerAttachedTargetGroupHealthcheckHttpOptionsArgs
LbNetworkLoadBalancerAttachedTargetGroupHealthcheckTcpOptions, LbNetworkLoadBalancerAttachedTargetGroupHealthcheckTcpOptionsArgs
- Port int
- Port for incoming traffic.
- Port int
- Port for incoming traffic.
- port Integer
- Port for incoming traffic.
- port number
- Port for incoming traffic.
- port int
- Port for incoming traffic.
- port Number
- Port for incoming traffic.
LbNetworkLoadBalancerListener, LbNetworkLoadBalancerListenerArgs
- Name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- Port int
- Port for incoming traffic.
- External
Address LbSpec Network Load Balancer Listener External Address Spec - External IP address specification. The structure is documented below.
- Internal
Address LbSpec Network Load Balancer Listener Internal Address Spec - Internal IP address specification. The structure is documented below.
- Protocol string
- Protocol for incoming traffic. TCP or UDP and the default is TCP.
- Target
Port int - Port of a target. The default is the same as listener's port.
- Name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- Port int
- Port for incoming traffic.
- External
Address LbSpec Network Load Balancer Listener External Address Spec - External IP address specification. The structure is documented below.
- Internal
Address LbSpec Network Load Balancer Listener Internal Address Spec - Internal IP address specification. The structure is documented below.
- Protocol string
- Protocol for incoming traffic. TCP or UDP and the default is TCP.
- Target
Port int - Port of a target. The default is the same as listener's port.
- name String
- Name of the listener. The name must be unique for each listener on a single load balancer.
- port Integer
- Port for incoming traffic.
- external
Address LbSpec Network Load Balancer Listener External Address Spec - External IP address specification. The structure is documented below.
- internal
Address LbSpec Network Load Balancer Listener Internal Address Spec - Internal IP address specification. The structure is documented below.
- protocol String
- Protocol for incoming traffic. TCP or UDP and the default is TCP.
- target
Port Integer - Port of a target. The default is the same as listener's port.
- name string
- Name of the listener. The name must be unique for each listener on a single load balancer.
- port number
- Port for incoming traffic.
- external
Address LbSpec Network Load Balancer Listener External Address Spec - External IP address specification. The structure is documented below.
- internal
Address LbSpec Network Load Balancer Listener Internal Address Spec - Internal IP address specification. The structure is documented below.
- protocol string
- Protocol for incoming traffic. TCP or UDP and the default is TCP.
- target
Port number - Port of a target. The default is the same as listener's port.
- name str
- Name of the listener. The name must be unique for each listener on a single load balancer.
- port int
- Port for incoming traffic.
- external_
address_ Lbspec Network Load Balancer Listener External Address Spec - External IP address specification. The structure is documented below.
- internal_
address_ Lbspec Network Load Balancer Listener Internal Address Spec - Internal IP address specification. The structure is documented below.
- protocol str
- Protocol for incoming traffic. TCP or UDP and the default is TCP.
- target_
port int - Port of a target. The default is the same as listener's port.
- name String
- Name of the listener. The name must be unique for each listener on a single load balancer.
- port Number
- Port for incoming traffic.
- external
Address Property MapSpec - External IP address specification. The structure is documented below.
- internal
Address Property MapSpec - Internal IP address specification. The structure is documented below.
- protocol String
- Protocol for incoming traffic. TCP or UDP and the default is TCP.
- target
Port Number - Port of a target. The default is the same as listener's port.
LbNetworkLoadBalancerListenerExternalAddressSpec, LbNetworkLoadBalancerListenerExternalAddressSpecArgs
- address str
- Internal IP address for a listener. Must belong to the subnet that is referenced in subnet_id. IP address will be allocated if it wasn't been set.
- ip_
version str - IP version of the internal addresses that the load balancer works with. Must be one of ipv4 or ipv6. The default is ipv4.
LbNetworkLoadBalancerListenerInternalAddressSpec, LbNetworkLoadBalancerListenerInternalAddressSpecArgs
- Subnet
Id string - ID of the subnet to which the internal IP address belongs.
- Address string
- Internal IP address for a listener. Must belong to the subnet that is referenced in subnet_id. IP address will be allocated if it wasn't been set.
- Ip
Version string - IP version of the internal addresses that the load balancer works with. Must be one of ipv4 or ipv6. The default is ipv4.
- Subnet
Id string - ID of the subnet to which the internal IP address belongs.
- Address string
- Internal IP address for a listener. Must belong to the subnet that is referenced in subnet_id. IP address will be allocated if it wasn't been set.
- Ip
Version string - IP version of the internal addresses that the load balancer works with. Must be one of ipv4 or ipv6. The default is ipv4.
- subnet
Id String - ID of the subnet to which the internal IP address belongs.
- address String
- Internal IP address for a listener. Must belong to the subnet that is referenced in subnet_id. IP address will be allocated if it wasn't been set.
- ip
Version String - IP version of the internal addresses that the load balancer works with. Must be one of ipv4 or ipv6. The default is ipv4.
- subnet
Id string - ID of the subnet to which the internal IP address belongs.
- address string
- Internal IP address for a listener. Must belong to the subnet that is referenced in subnet_id. IP address will be allocated if it wasn't been set.
- ip
Version string - IP version of the internal addresses that the load balancer works with. Must be one of ipv4 or ipv6. The default is ipv4.
- subnet_
id str - ID of the subnet to which the internal IP address belongs.
- address str
- Internal IP address for a listener. Must belong to the subnet that is referenced in subnet_id. IP address will be allocated if it wasn't been set.
- ip_
version str - IP version of the internal addresses that the load balancer works with. Must be one of ipv4 or ipv6. The default is ipv4.
- subnet
Id String - ID of the subnet to which the internal IP address belongs.
- address String
- Internal IP address for a listener. Must belong to the subnet that is referenced in subnet_id. IP address will be allocated if it wasn't been set.
- ip
Version String - IP version of the internal addresses that the load balancer works with. Must be one of ipv4 or ipv6. The default is ipv4.
Import
A network load balancer can be imported using the id
of the resource, e.g.
$ pulumi import yandex:index/lbNetworkLoadBalancer:LbNetworkLoadBalancer default network_load_balancer_id
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Yandex pulumi/pulumi-yandex
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
yandex
Terraform Provider.