linode.NodeBalancer
Explore with Pulumi AI
Provides a Linode NodeBalancer resource. This can be used to create, modify, and delete Linodes NodeBalancers in Linode’s managed load balancer service. For more information, see Getting Started with NodeBalancers and the Linode APIv4 docs.
Example Usage
The following example shows how one might use this resource to configure a NodeBalancer.
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
return await Deployment.RunAsync(() =>
{
var foobar = new Linode.NodeBalancer("foobar", new()
{
ClientConnThrottle = 20,
Label = "mynodebalancer",
Region = "us-east",
Tags = new[]
{
"foobar",
},
});
});
package main
import (
"github.com/pulumi/pulumi-linode/sdk/v4/go/linode"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := linode.NewNodeBalancer(ctx, "foobar", &linode.NodeBalancerArgs{
ClientConnThrottle: pulumi.Int(20),
Label: pulumi.String("mynodebalancer"),
Region: pulumi.String("us-east"),
Tags: pulumi.StringArray{
pulumi.String("foobar"),
},
})
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.linode.NodeBalancer;
import com.pulumi.linode.NodeBalancerArgs;
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 foobar = new NodeBalancer("foobar", NodeBalancerArgs.builder()
.clientConnThrottle(20)
.label("mynodebalancer")
.region("us-east")
.tags("foobar")
.build());
}
}
import pulumi
import pulumi_linode as linode
foobar = linode.NodeBalancer("foobar",
client_conn_throttle=20,
label="mynodebalancer",
region="us-east",
tags=["foobar"])
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
const foobar = new linode.NodeBalancer("foobar", {
clientConnThrottle: 20,
label: "mynodebalancer",
region: "us-east",
tags: ["foobar"],
});
resources:
foobar:
type: linode:NodeBalancer
properties:
clientConnThrottle: 20
label: mynodebalancer
region: us-east
tags:
- foobar
Create NodeBalancer Resource
new NodeBalancer(name: string, args?: NodeBalancerArgs, opts?: CustomResourceOptions);
@overload
def NodeBalancer(resource_name: str,
opts: Optional[ResourceOptions] = None,
client_conn_throttle: Optional[int] = None,
firewall_id: Optional[int] = None,
label: Optional[str] = None,
region: Optional[str] = None,
tags: Optional[Sequence[str]] = None)
@overload
def NodeBalancer(resource_name: str,
args: Optional[NodeBalancerArgs] = None,
opts: Optional[ResourceOptions] = None)
func NewNodeBalancer(ctx *Context, name string, args *NodeBalancerArgs, opts ...ResourceOption) (*NodeBalancer, error)
public NodeBalancer(string name, NodeBalancerArgs? args = null, CustomResourceOptions? opts = null)
public NodeBalancer(String name, NodeBalancerArgs args)
public NodeBalancer(String name, NodeBalancerArgs args, CustomResourceOptions options)
type: linode:NodeBalancer
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args NodeBalancerArgs
- 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 NodeBalancerArgs
- 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 NodeBalancerArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args NodeBalancerArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args NodeBalancerArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
NodeBalancer 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 NodeBalancer resource accepts the following input properties:
- Client
Conn intThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- Firewall
Id int ID for the firewall you'd like to use with this NodeBalancer.
- Label string
The label of the Linode NodeBalancer
- Region string
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- List<string>
A list of tags applied to this object. Tags are for organizational purposes only.
- Client
Conn intThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- Firewall
Id int ID for the firewall you'd like to use with this NodeBalancer.
- Label string
The label of the Linode NodeBalancer
- Region string
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- []string
A list of tags applied to this object. Tags are for organizational purposes only.
- client
Conn IntegerThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- firewall
Id Integer ID for the firewall you'd like to use with this NodeBalancer.
- label String
The label of the Linode NodeBalancer
- region String
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- List<String>
A list of tags applied to this object. Tags are for organizational purposes only.
- client
Conn numberThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- firewall
Id number ID for the firewall you'd like to use with this NodeBalancer.
- label string
The label of the Linode NodeBalancer
- region string
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- string[]
A list of tags applied to this object. Tags are for organizational purposes only.
- client_
conn_ intthrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- firewall_
id int ID for the firewall you'd like to use with this NodeBalancer.
- label str
The label of the Linode NodeBalancer
- region str
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- Sequence[str]
A list of tags applied to this object. Tags are for organizational purposes only.
- client
Conn NumberThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- firewall
Id Number ID for the firewall you'd like to use with this NodeBalancer.
- label String
The label of the Linode NodeBalancer
- region String
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- List<String>
A list of tags applied to this object. Tags are for organizational purposes only.
Outputs
All input properties are implicitly available as output properties. Additionally, the NodeBalancer resource produces the following output properties:
- Created string
When this NodeBalancer was created
- Hostname string
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- Id string
The provider-assigned unique ID for this managed resource.
- Ipv4 string
The Public IPv4 Address of this NodeBalancer
- Ipv6 string
The Public IPv6 Address of this NodeBalancer
- Transfers
List<Node
Balancer Transfer> Information about the amount of transfer this NodeBalancer has had so far this month.
- Updated string
When this NodeBalancer was last updated.
- Created string
When this NodeBalancer was created
- Hostname string
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- Id string
The provider-assigned unique ID for this managed resource.
- Ipv4 string
The Public IPv4 Address of this NodeBalancer
- Ipv6 string
The Public IPv6 Address of this NodeBalancer
- Transfers
[]Node
Balancer Transfer Information about the amount of transfer this NodeBalancer has had so far this month.
- Updated string
When this NodeBalancer was last updated.
- created String
When this NodeBalancer was created
- hostname String
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- id String
The provider-assigned unique ID for this managed resource.
- ipv4 String
The Public IPv4 Address of this NodeBalancer
- ipv6 String
The Public IPv6 Address of this NodeBalancer
- transfers
List<Node
Balancer Transfer> Information about the amount of transfer this NodeBalancer has had so far this month.
- updated String
When this NodeBalancer was last updated.
- created string
When this NodeBalancer was created
- hostname string
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- id string
The provider-assigned unique ID for this managed resource.
- ipv4 string
The Public IPv4 Address of this NodeBalancer
- ipv6 string
The Public IPv6 Address of this NodeBalancer
- transfers
Node
Balancer Transfer[] Information about the amount of transfer this NodeBalancer has had so far this month.
- updated string
When this NodeBalancer was last updated.
- created str
When this NodeBalancer was created
- hostname str
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- id str
The provider-assigned unique ID for this managed resource.
- ipv4 str
The Public IPv4 Address of this NodeBalancer
- ipv6 str
The Public IPv6 Address of this NodeBalancer
- transfers
Sequence[Node
Balancer Transfer] Information about the amount of transfer this NodeBalancer has had so far this month.
- updated str
When this NodeBalancer was last updated.
- created String
When this NodeBalancer was created
- hostname String
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- id String
The provider-assigned unique ID for this managed resource.
- ipv4 String
The Public IPv4 Address of this NodeBalancer
- ipv6 String
The Public IPv6 Address of this NodeBalancer
- transfers List<Property Map>
Information about the amount of transfer this NodeBalancer has had so far this month.
- updated String
When this NodeBalancer was last updated.
Look up Existing NodeBalancer Resource
Get an existing NodeBalancer 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?: NodeBalancerState, opts?: CustomResourceOptions): NodeBalancer
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
client_conn_throttle: Optional[int] = None,
created: Optional[str] = None,
firewall_id: Optional[int] = None,
hostname: Optional[str] = None,
ipv4: Optional[str] = None,
ipv6: Optional[str] = None,
label: Optional[str] = None,
region: Optional[str] = None,
tags: Optional[Sequence[str]] = None,
transfers: Optional[Sequence[NodeBalancerTransferArgs]] = None,
updated: Optional[str] = None) -> NodeBalancer
func GetNodeBalancer(ctx *Context, name string, id IDInput, state *NodeBalancerState, opts ...ResourceOption) (*NodeBalancer, error)
public static NodeBalancer Get(string name, Input<string> id, NodeBalancerState? state, CustomResourceOptions? opts = null)
public static NodeBalancer get(String name, Output<String> id, NodeBalancerState 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.
- Client
Conn intThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- Created string
When this NodeBalancer was created
- Firewall
Id int ID for the firewall you'd like to use with this NodeBalancer.
- Hostname string
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- Ipv4 string
The Public IPv4 Address of this NodeBalancer
- Ipv6 string
The Public IPv6 Address of this NodeBalancer
- Label string
The label of the Linode NodeBalancer
- Region string
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- List<string>
A list of tags applied to this object. Tags are for organizational purposes only.
- Transfers
List<Node
Balancer Transfer> Information about the amount of transfer this NodeBalancer has had so far this month.
- Updated string
When this NodeBalancer was last updated.
- Client
Conn intThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- Created string
When this NodeBalancer was created
- Firewall
Id int ID for the firewall you'd like to use with this NodeBalancer.
- Hostname string
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- Ipv4 string
The Public IPv4 Address of this NodeBalancer
- Ipv6 string
The Public IPv6 Address of this NodeBalancer
- Label string
The label of the Linode NodeBalancer
- Region string
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- []string
A list of tags applied to this object. Tags are for organizational purposes only.
- Transfers
[]Node
Balancer Transfer Args Information about the amount of transfer this NodeBalancer has had so far this month.
- Updated string
When this NodeBalancer was last updated.
- client
Conn IntegerThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- created String
When this NodeBalancer was created
- firewall
Id Integer ID for the firewall you'd like to use with this NodeBalancer.
- hostname String
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- ipv4 String
The Public IPv4 Address of this NodeBalancer
- ipv6 String
The Public IPv6 Address of this NodeBalancer
- label String
The label of the Linode NodeBalancer
- region String
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- List<String>
A list of tags applied to this object. Tags are for organizational purposes only.
- transfers
List<Node
Balancer Transfer> Information about the amount of transfer this NodeBalancer has had so far this month.
- updated String
When this NodeBalancer was last updated.
- client
Conn numberThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- created string
When this NodeBalancer was created
- firewall
Id number ID for the firewall you'd like to use with this NodeBalancer.
- hostname string
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- ipv4 string
The Public IPv4 Address of this NodeBalancer
- ipv6 string
The Public IPv6 Address of this NodeBalancer
- label string
The label of the Linode NodeBalancer
- region string
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- string[]
A list of tags applied to this object. Tags are for organizational purposes only.
- transfers
Node
Balancer Transfer[] Information about the amount of transfer this NodeBalancer has had so far this month.
- updated string
When this NodeBalancer was last updated.
- client_
conn_ intthrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- created str
When this NodeBalancer was created
- firewall_
id int ID for the firewall you'd like to use with this NodeBalancer.
- hostname str
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- ipv4 str
The Public IPv4 Address of this NodeBalancer
- ipv6 str
The Public IPv6 Address of this NodeBalancer
- label str
The label of the Linode NodeBalancer
- region str
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- Sequence[str]
A list of tags applied to this object. Tags are for organizational purposes only.
- transfers
Sequence[Node
Balancer Transfer Args] Information about the amount of transfer this NodeBalancer has had so far this month.
- updated str
When this NodeBalancer was last updated.
- client
Conn NumberThrottle Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
- created String
When this NodeBalancer was created
- firewall
Id Number ID for the firewall you'd like to use with this NodeBalancer.
- hostname String
This NodeBalancer's hostname, ending with .nodebalancer.linode.com
- ipv4 String
The Public IPv4 Address of this NodeBalancer
- ipv6 String
The Public IPv6 Address of this NodeBalancer
- label String
The label of the Linode NodeBalancer
- region String
The region where this NodeBalancer will be deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
forces the creation of a new Linode NodeBalancer..- List<String>
A list of tags applied to this object. Tags are for organizational purposes only.
- transfers List<Property Map>
Information about the amount of transfer this NodeBalancer has had so far this month.
- updated String
When this NodeBalancer was last updated.
Supporting Types
NodeBalancerTransfer, NodeBalancerTransferArgs
Import
Linodes NodeBalancers can be imported using the Linode NodeBalancer id
, e.g.
$ pulumi import linode:index/nodeBalancer:NodeBalancer mynodebalancer 1234567
The Linode Guide, Import Existing Infrastructure to Terraform, offers resource importing examples for NodeBalancers and other Linode resource types.
Package Details
- Repository
- Linode pulumi/pulumi-linode
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
linode
Terraform Provider.