linode.Instance
Explore with Pulumi AI
Provides a Linode Instance resource. This can be used to create, modify, and delete Linodes. For more information, see Getting Started with Linode and the Linode APIv4 docs.
Example Usage
Simple Linode Instance
The following example shows how one might use this resource to configure a Linode instance.
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
const web = new linode.Instance("web", {
label: "simple_instance",
image: "linode/ubuntu22.04",
region: "us-central",
type: "g6-standard-1",
authorizedKeys: ["ssh-rsa AAAA...Gw== user@example.local"],
rootPass: "this-is-not-a-safe-password",
tags: ["foo"],
swapSize: 256,
privateIp: true,
});
import pulumi
import pulumi_linode as linode
web = linode.Instance("web",
label="simple_instance",
image="linode/ubuntu22.04",
region="us-central",
type="g6-standard-1",
authorized_keys=["ssh-rsa AAAA...Gw== user@example.local"],
root_pass="this-is-not-a-safe-password",
tags=["foo"],
swap_size=256,
private_ip=True)
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.NewInstance(ctx, "web", &linode.InstanceArgs{
Label: pulumi.String("simple_instance"),
Image: pulumi.String("linode/ubuntu22.04"),
Region: pulumi.String("us-central"),
Type: pulumi.String("g6-standard-1"),
AuthorizedKeys: pulumi.StringArray{
pulumi.String("ssh-rsa AAAA...Gw== user@example.local"),
},
RootPass: pulumi.String("this-is-not-a-safe-password"),
Tags: pulumi.StringArray{
pulumi.String("foo"),
},
SwapSize: pulumi.Int(256),
PrivateIp: pulumi.Bool(true),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
return await Deployment.RunAsync(() =>
{
var web = new Linode.Instance("web", new()
{
Label = "simple_instance",
Image = "linode/ubuntu22.04",
Region = "us-central",
Type = "g6-standard-1",
AuthorizedKeys = new[]
{
"ssh-rsa AAAA...Gw== user@example.local",
},
RootPass = "this-is-not-a-safe-password",
Tags = new[]
{
"foo",
},
SwapSize = 256,
PrivateIp = true,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.Instance;
import com.pulumi.linode.InstanceArgs;
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 web = new Instance("web", InstanceArgs.builder()
.label("simple_instance")
.image("linode/ubuntu22.04")
.region("us-central")
.type("g6-standard-1")
.authorizedKeys("ssh-rsa AAAA...Gw== user@example.local")
.rootPass("this-is-not-a-safe-password")
.tags("foo")
.swapSize(256)
.privateIp(true)
.build());
}
}
resources:
web:
type: linode:Instance
properties:
label: simple_instance
image: linode/ubuntu22.04
region: us-central
type: g6-standard-1
authorizedKeys:
- ssh-rsa AAAA...Gw== user@example.local
rootPass: this-is-not-a-safe-password
tags:
- foo
swapSize: 256
privateIp: true
Linode Instance with Explicit Networking Interfaces
You can add a VPC or VLAN interface directly to a Linode instance resource.
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
const web = new linode.Instance("web", {
label: "simple_instance",
image: "linode/ubuntu22.04",
region: "us-central",
type: "g6-standard-1",
authorizedKeys: ["ssh-rsa AAAA...Gw== user@example.local"],
rootPass: "this-is-not-a-safe-password",
interfaces: [
{
purpose: "public",
},
{
purpose: "vpc",
subnetId: 123,
ipv4: {
vpc: "10.0.4.250",
},
},
],
tags: ["foo"],
swapSize: 256,
privateIp: true,
});
import pulumi
import pulumi_linode as linode
web = linode.Instance("web",
label="simple_instance",
image="linode/ubuntu22.04",
region="us-central",
type="g6-standard-1",
authorized_keys=["ssh-rsa AAAA...Gw== user@example.local"],
root_pass="this-is-not-a-safe-password",
interfaces=[
{
"purpose": "public",
},
{
"purpose": "vpc",
"subnet_id": 123,
"ipv4": {
"vpc": "10.0.4.250",
},
},
],
tags=["foo"],
swap_size=256,
private_ip=True)
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.NewInstance(ctx, "web", &linode.InstanceArgs{
Label: pulumi.String("simple_instance"),
Image: pulumi.String("linode/ubuntu22.04"),
Region: pulumi.String("us-central"),
Type: pulumi.String("g6-standard-1"),
AuthorizedKeys: pulumi.StringArray{
pulumi.String("ssh-rsa AAAA...Gw== user@example.local"),
},
RootPass: pulumi.String("this-is-not-a-safe-password"),
Interfaces: linode.InstanceInterfaceArray{
&linode.InstanceInterfaceArgs{
Purpose: pulumi.String("public"),
},
&linode.InstanceInterfaceArgs{
Purpose: pulumi.String("vpc"),
SubnetId: pulumi.Int(123),
Ipv4: &linode.InstanceInterfaceIpv4Args{
Vpc: pulumi.String("10.0.4.250"),
},
},
},
Tags: pulumi.StringArray{
pulumi.String("foo"),
},
SwapSize: pulumi.Int(256),
PrivateIp: pulumi.Bool(true),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
return await Deployment.RunAsync(() =>
{
var web = new Linode.Instance("web", new()
{
Label = "simple_instance",
Image = "linode/ubuntu22.04",
Region = "us-central",
Type = "g6-standard-1",
AuthorizedKeys = new[]
{
"ssh-rsa AAAA...Gw== user@example.local",
},
RootPass = "this-is-not-a-safe-password",
Interfaces = new[]
{
new Linode.Inputs.InstanceInterfaceArgs
{
Purpose = "public",
},
new Linode.Inputs.InstanceInterfaceArgs
{
Purpose = "vpc",
SubnetId = 123,
Ipv4 = new Linode.Inputs.InstanceInterfaceIpv4Args
{
Vpc = "10.0.4.250",
},
},
},
Tags = new[]
{
"foo",
},
SwapSize = 256,
PrivateIp = true,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.Instance;
import com.pulumi.linode.InstanceArgs;
import com.pulumi.linode.inputs.InstanceInterfaceArgs;
import com.pulumi.linode.inputs.InstanceInterfaceIpv4Args;
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 web = new Instance("web", InstanceArgs.builder()
.label("simple_instance")
.image("linode/ubuntu22.04")
.region("us-central")
.type("g6-standard-1")
.authorizedKeys("ssh-rsa AAAA...Gw== user@example.local")
.rootPass("this-is-not-a-safe-password")
.interfaces(
InstanceInterfaceArgs.builder()
.purpose("public")
.build(),
InstanceInterfaceArgs.builder()
.purpose("vpc")
.subnetId(123)
.ipv4(InstanceInterfaceIpv4Args.builder()
.vpc("10.0.4.250")
.build())
.build())
.tags("foo")
.swapSize(256)
.privateIp(true)
.build());
}
}
resources:
web:
type: linode:Instance
properties:
label: simple_instance
image: linode/ubuntu22.04
region: us-central
type: g6-standard-1
authorizedKeys:
- ssh-rsa AAAA...Gw== user@example.local
rootPass: this-is-not-a-safe-password
interfaces:
- purpose: public
- purpose: vpc
subnetId: 123
ipv4:
vpc: 10.0.4.250
tags:
- foo
swapSize: 256
privateIp: true
Linode Instance with Explicit Configs and Disks
Using explicit Instance Configs and Disks it is possible to create a more elaborate Linode instance. This can be used to provision multiple disks and volumes during Instance creation.
Coming soon!
Coming soon!
Coming soon!
Coming soon!
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.LinodeFunctions;
import com.pulumi.linode.Instance;
import com.pulumi.linode.InstanceArgs;
import com.pulumi.linode.Volume;
import com.pulumi.linode.VolumeArgs;
import com.pulumi.linode.InstanceDisk;
import com.pulumi.linode.InstanceDiskArgs;
import com.pulumi.linode.InstanceConfig;
import com.pulumi.linode.InstanceConfigArgs;
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 me = LinodeFunctions.getProfile();
var web = new Instance("web", InstanceArgs.builder()
.label("complex_instance")
.tags("foo")
.region("us-central")
.type("g6-nanode-1")
.privateIp(true)
.build());
var webVolume = new Volume("webVolume", VolumeArgs.builder()
.label("web_volume")
.size(20)
.region("us-central")
.build());
var bootDisk = new InstanceDisk("bootDisk", InstanceDiskArgs.builder()
.label("boot")
.linodeId(web.id())
.size(3000)
.image("linode/ubuntu22.04")
.authorizedKeys("ssh-rsa AAAA...Gw== user@example.local")
.authorizedUsers(me.applyValue(getProfileResult -> getProfileResult.username()))
.rootPass("terr4form-test")
.build());
var bootConfig = new InstanceConfig("bootConfig", InstanceConfigArgs.builder()
.label("boot_config")
.linodeId(web.id())
.devices(
InstanceConfigDevicesArgs.builder()
.deviceName("sda")
.diskId(bootDisk.id())
.build(),
InstanceConfigDevicesArgs.builder()
.deviceName("sdb")
.volumeId(webVolume.id())
.build())
.rootDevice("/dev/sda")
.kernel("linode/latest-64bit")
.booted(true)
.build());
}
}
resources:
web:
type: linode:Instance
properties:
label: complex_instance
tags:
- foo
region: us-central
type: g6-nanode-1
privateIp: true
webVolume:
type: linode:Volume
name: web_volume
properties:
label: web_volume
size: 20
region: us-central
bootDisk:
type: linode:InstanceDisk
name: boot_disk
properties:
label: boot
linodeId: ${web.id}
size: 3000
image: linode/ubuntu22.04
authorizedKeys:
- ssh-rsa AAAA...Gw== user@example.local
authorizedUsers:
- ${me.username}
rootPass: terr4form-test
bootConfig:
type: linode:InstanceConfig
name: boot_config
properties:
label: boot_config
linodeId: ${web.id}
devices:
- deviceName: sda
diskId: ${bootDisk.id}
- deviceName: sdb
volumeId: ${webVolume.id}
rootDevice: /dev/sda
kernel: linode/latest-64bit
booted: true
variables:
me:
fn::invoke:
Function: linode:getProfile
Arguments: {}
Linode Instance Assigned to a Placement Group
The following example shows how one might use this resource to configure a Linode instance assigned to a Placement Group.
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
const my_instance = new linode.Instance("my-instance", {
label: "my-instance",
region: "us-mia",
type: "g6-standard-1",
placementGroup: {
id: 12345,
},
});
import pulumi
import pulumi_linode as linode
my_instance = linode.Instance("my-instance",
label="my-instance",
region="us-mia",
type="g6-standard-1",
placement_group={
"id": 12345,
})
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.NewInstance(ctx, "my-instance", &linode.InstanceArgs{
Label: pulumi.String("my-instance"),
Region: pulumi.String("us-mia"),
Type: pulumi.String("g6-standard-1"),
PlacementGroup: &linode.InstancePlacementGroupArgs{
Id: pulumi.Int(12345),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
return await Deployment.RunAsync(() =>
{
var my_instance = new Linode.Instance("my-instance", new()
{
Label = "my-instance",
Region = "us-mia",
Type = "g6-standard-1",
PlacementGroup = new Linode.Inputs.InstancePlacementGroupArgs
{
Id = 12345,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.Instance;
import com.pulumi.linode.InstanceArgs;
import com.pulumi.linode.inputs.InstancePlacementGroupArgs;
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 my_instance = new Instance("my-instance", InstanceArgs.builder()
.label("my-instance")
.region("us-mia")
.type("g6-standard-1")
.placementGroup(InstancePlacementGroupArgs.builder()
.id(12345)
.build())
.build());
}
}
resources:
my-instance:
type: linode:Instance
properties:
label: my-instance
region: us-mia
type: g6-standard-1
placementGroup:
id: 12345
Create Instance Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Instance(name: string, args: InstanceArgs, opts?: CustomResourceOptions);
@overload
def Instance(resource_name: str,
args: InstanceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Instance(resource_name: str,
opts: Optional[ResourceOptions] = None,
region: Optional[str] = None,
configs: Optional[Sequence[InstanceConfigArgs]] = None,
backup_id: Optional[int] = None,
metadatas: Optional[Sequence[InstanceMetadataArgs]] = None,
backups_enabled: Optional[bool] = None,
boot_config_label: Optional[str] = None,
booted: Optional[bool] = None,
alerts: Optional[InstanceAlertsArgs] = None,
disk_encryption: Optional[str] = None,
disks: Optional[Sequence[InstanceDiskArgs]] = None,
firewall_id: Optional[int] = None,
group: Optional[str] = None,
image: Optional[str] = None,
interfaces: Optional[Sequence[InstanceInterfaceArgs]] = None,
ipv4s: Optional[Sequence[str]] = None,
watchdog_enabled: Optional[bool] = None,
authorized_users: Optional[Sequence[str]] = None,
migration_type: Optional[str] = None,
placement_group: Optional[InstancePlacementGroupArgs] = None,
placement_group_externally_managed: Optional[bool] = None,
private_ip: Optional[bool] = None,
authorized_keys: Optional[Sequence[str]] = None,
resize_disk: Optional[bool] = None,
root_pass: Optional[str] = None,
shared_ipv4s: Optional[Sequence[str]] = None,
stackscript_data: Optional[Mapping[str, str]] = None,
stackscript_id: Optional[int] = None,
swap_size: Optional[int] = None,
tags: Optional[Sequence[str]] = None,
type: Optional[str] = None,
label: Optional[str] = None)
func NewInstance(ctx *Context, name string, args InstanceArgs, opts ...ResourceOption) (*Instance, error)
public Instance(string name, InstanceArgs args, CustomResourceOptions? opts = null)
public Instance(String name, InstanceArgs args)
public Instance(String name, InstanceArgs args, CustomResourceOptions options)
type: linode:Instance
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 InstanceArgs
- 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 InstanceArgs
- 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 InstanceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InstanceArgs
- 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 instanceResource = new Linode.Instance("instanceResource", new()
{
Region = "string",
BackupId = 0,
Metadatas = new[]
{
new Linode.Inputs.InstanceMetadataArgs
{
UserData = "string",
},
},
BackupsEnabled = false,
BootConfigLabel = "string",
Booted = false,
Alerts = new Linode.Inputs.InstanceAlertsArgs
{
Cpu = 0,
Io = 0,
NetworkIn = 0,
NetworkOut = 0,
TransferQuota = 0,
},
DiskEncryption = "string",
FirewallId = 0,
Image = "string",
Interfaces = new[]
{
new Linode.Inputs.InstanceInterfaceArgs
{
Purpose = "string",
Active = false,
Id = 0,
IpRanges = new[]
{
"string",
},
IpamAddress = "string",
Ipv4 = new Linode.Inputs.InstanceInterfaceIpv4Args
{
Nat11 = "string",
Vpc = "string",
},
Label = "string",
Primary = false,
SubnetId = 0,
VpcId = 0,
},
},
Ipv4s = new[]
{
"string",
},
WatchdogEnabled = false,
AuthorizedUsers = new[]
{
"string",
},
MigrationType = "string",
PlacementGroup = new Linode.Inputs.InstancePlacementGroupArgs
{
Id = 0,
CompliantOnly = false,
Label = "string",
PlacementGroupPolicy = "string",
PlacementGroupType = "string",
},
PlacementGroupExternallyManaged = false,
PrivateIp = false,
AuthorizedKeys = new[]
{
"string",
},
ResizeDisk = false,
RootPass = "string",
SharedIpv4s = new[]
{
"string",
},
StackscriptData =
{
{ "string", "string" },
},
StackscriptId = 0,
SwapSize = 0,
Tags = new[]
{
"string",
},
Type = "string",
Label = "string",
});
example, err := linode.NewInstance(ctx, "instanceResource", &linode.InstanceArgs{
Region: pulumi.String("string"),
BackupId: pulumi.Int(0),
Metadatas: linode.InstanceMetadataArray{
&linode.InstanceMetadataArgs{
UserData: pulumi.String("string"),
},
},
BackupsEnabled: pulumi.Bool(false),
BootConfigLabel: pulumi.String("string"),
Booted: pulumi.Bool(false),
Alerts: &linode.InstanceAlertsArgs{
Cpu: pulumi.Int(0),
Io: pulumi.Int(0),
NetworkIn: pulumi.Int(0),
NetworkOut: pulumi.Int(0),
TransferQuota: pulumi.Int(0),
},
DiskEncryption: pulumi.String("string"),
FirewallId: pulumi.Int(0),
Image: pulumi.String("string"),
Interfaces: linode.InstanceInterfaceArray{
&linode.InstanceInterfaceArgs{
Purpose: pulumi.String("string"),
Active: pulumi.Bool(false),
Id: pulumi.Int(0),
IpRanges: pulumi.StringArray{
pulumi.String("string"),
},
IpamAddress: pulumi.String("string"),
Ipv4: &linode.InstanceInterfaceIpv4Args{
Nat11: pulumi.String("string"),
Vpc: pulumi.String("string"),
},
Label: pulumi.String("string"),
Primary: pulumi.Bool(false),
SubnetId: pulumi.Int(0),
VpcId: pulumi.Int(0),
},
},
Ipv4s: pulumi.StringArray{
pulumi.String("string"),
},
WatchdogEnabled: pulumi.Bool(false),
AuthorizedUsers: pulumi.StringArray{
pulumi.String("string"),
},
MigrationType: pulumi.String("string"),
PlacementGroup: &linode.InstancePlacementGroupArgs{
Id: pulumi.Int(0),
CompliantOnly: pulumi.Bool(false),
Label: pulumi.String("string"),
PlacementGroupPolicy: pulumi.String("string"),
PlacementGroupType: pulumi.String("string"),
},
PlacementGroupExternallyManaged: pulumi.Bool(false),
PrivateIp: pulumi.Bool(false),
AuthorizedKeys: pulumi.StringArray{
pulumi.String("string"),
},
ResizeDisk: pulumi.Bool(false),
RootPass: pulumi.String("string"),
SharedIpv4s: pulumi.StringArray{
pulumi.String("string"),
},
StackscriptData: pulumi.StringMap{
"string": pulumi.String("string"),
},
StackscriptId: pulumi.Int(0),
SwapSize: pulumi.Int(0),
Tags: pulumi.StringArray{
pulumi.String("string"),
},
Type: pulumi.String("string"),
Label: pulumi.String("string"),
})
var instanceResource = new Instance("instanceResource", InstanceArgs.builder()
.region("string")
.backupId(0)
.metadatas(InstanceMetadataArgs.builder()
.userData("string")
.build())
.backupsEnabled(false)
.bootConfigLabel("string")
.booted(false)
.alerts(InstanceAlertsArgs.builder()
.cpu(0)
.io(0)
.networkIn(0)
.networkOut(0)
.transferQuota(0)
.build())
.diskEncryption("string")
.firewallId(0)
.image("string")
.interfaces(InstanceInterfaceArgs.builder()
.purpose("string")
.active(false)
.id(0)
.ipRanges("string")
.ipamAddress("string")
.ipv4(InstanceInterfaceIpv4Args.builder()
.nat11("string")
.vpc("string")
.build())
.label("string")
.primary(false)
.subnetId(0)
.vpcId(0)
.build())
.ipv4s("string")
.watchdogEnabled(false)
.authorizedUsers("string")
.migrationType("string")
.placementGroup(InstancePlacementGroupArgs.builder()
.id(0)
.compliantOnly(false)
.label("string")
.placementGroupPolicy("string")
.placementGroupType("string")
.build())
.placementGroupExternallyManaged(false)
.privateIp(false)
.authorizedKeys("string")
.resizeDisk(false)
.rootPass("string")
.sharedIpv4s("string")
.stackscriptData(Map.of("string", "string"))
.stackscriptId(0)
.swapSize(0)
.tags("string")
.type("string")
.label("string")
.build());
instance_resource = linode.Instance("instanceResource",
region="string",
backup_id=0,
metadatas=[{
"user_data": "string",
}],
backups_enabled=False,
boot_config_label="string",
booted=False,
alerts={
"cpu": 0,
"io": 0,
"network_in": 0,
"network_out": 0,
"transfer_quota": 0,
},
disk_encryption="string",
firewall_id=0,
image="string",
interfaces=[{
"purpose": "string",
"active": False,
"id": 0,
"ip_ranges": ["string"],
"ipam_address": "string",
"ipv4": {
"nat11": "string",
"vpc": "string",
},
"label": "string",
"primary": False,
"subnet_id": 0,
"vpc_id": 0,
}],
ipv4s=["string"],
watchdog_enabled=False,
authorized_users=["string"],
migration_type="string",
placement_group={
"id": 0,
"compliant_only": False,
"label": "string",
"placement_group_policy": "string",
"placement_group_type": "string",
},
placement_group_externally_managed=False,
private_ip=False,
authorized_keys=["string"],
resize_disk=False,
root_pass="string",
shared_ipv4s=["string"],
stackscript_data={
"string": "string",
},
stackscript_id=0,
swap_size=0,
tags=["string"],
type="string",
label="string")
const instanceResource = new linode.Instance("instanceResource", {
region: "string",
backupId: 0,
metadatas: [{
userData: "string",
}],
backupsEnabled: false,
bootConfigLabel: "string",
booted: false,
alerts: {
cpu: 0,
io: 0,
networkIn: 0,
networkOut: 0,
transferQuota: 0,
},
diskEncryption: "string",
firewallId: 0,
image: "string",
interfaces: [{
purpose: "string",
active: false,
id: 0,
ipRanges: ["string"],
ipamAddress: "string",
ipv4: {
nat11: "string",
vpc: "string",
},
label: "string",
primary: false,
subnetId: 0,
vpcId: 0,
}],
ipv4s: ["string"],
watchdogEnabled: false,
authorizedUsers: ["string"],
migrationType: "string",
placementGroup: {
id: 0,
compliantOnly: false,
label: "string",
placementGroupPolicy: "string",
placementGroupType: "string",
},
placementGroupExternallyManaged: false,
privateIp: false,
authorizedKeys: ["string"],
resizeDisk: false,
rootPass: "string",
sharedIpv4s: ["string"],
stackscriptData: {
string: "string",
},
stackscriptId: 0,
swapSize: 0,
tags: ["string"],
type: "string",
label: "string",
});
type: linode:Instance
properties:
alerts:
cpu: 0
io: 0
networkIn: 0
networkOut: 0
transferQuota: 0
authorizedKeys:
- string
authorizedUsers:
- string
backupId: 0
backupsEnabled: false
bootConfigLabel: string
booted: false
diskEncryption: string
firewallId: 0
image: string
interfaces:
- active: false
id: 0
ipRanges:
- string
ipamAddress: string
ipv4:
nat11: string
vpc: string
label: string
primary: false
purpose: string
subnetId: 0
vpcId: 0
ipv4s:
- string
label: string
metadatas:
- userData: string
migrationType: string
placementGroup:
compliantOnly: false
id: 0
label: string
placementGroupPolicy: string
placementGroupType: string
placementGroupExternallyManaged: false
privateIp: false
region: string
resizeDisk: false
rootPass: string
sharedIpv4s:
- string
stackscriptData:
string: string
stackscriptId: 0
swapSize: 0
tags:
- string
type: string
watchdogEnabled: false
Instance 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 Instance resource accepts the following input properties:
- Region string
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - Alerts
Instance
Alerts - Configuration options for alert triggers on this Linode.
- List<string>
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- List<string>
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - Backup
Id int - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- Backups
Enabled bool - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- Boot
Config stringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- Booted bool
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- Configs
List<Instance
Config> - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- Disk
Encryption string - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- Disks
List<Instance
Disk> - Firewall
Id int - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - Group string
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - Image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- Interfaces
List<Instance
Interface> - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- Ipv4s List<string>
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Metadatas
List<Instance
Metadata> - Various fields related to the Linode Metadata service.
- Migration
Type string - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- Placement
Group InstancePlacement Group - Information about the Placement Group this Linode is assigned to.
- Placement
Group boolExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- Private
Ip bool - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- Resize
Disk bool If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- Root
Pass string - The password that will be initially assigned to the 'root' user account.
- List<string>
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- Stackscript
Data Dictionary<string, string> - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- Stackscript
Id int - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- Swap
Size int - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- List<string>
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- Type string
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - Watchdog
Enabled bool - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- Region string
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - Alerts
Instance
Alerts Args - Configuration options for alert triggers on this Linode.
- []string
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- []string
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - Backup
Id int - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- Backups
Enabled bool - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- Boot
Config stringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- Booted bool
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- Configs
[]Instance
Config Type Args - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- Disk
Encryption string - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- Disks
[]Instance
Disk Type Args - Firewall
Id int - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - Group string
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - Image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- Interfaces
[]Instance
Interface Args - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- Ipv4s []string
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Metadatas
[]Instance
Metadata Args - Various fields related to the Linode Metadata service.
- Migration
Type string - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- Placement
Group InstancePlacement Group Args - Information about the Placement Group this Linode is assigned to.
- Placement
Group boolExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- Private
Ip bool - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- Resize
Disk bool If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- Root
Pass string - The password that will be initially assigned to the 'root' user account.
- []string
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- Stackscript
Data map[string]string - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- Stackscript
Id int - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- Swap
Size int - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- []string
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- Type string
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - Watchdog
Enabled bool - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- region String
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - alerts
Instance
Alerts - Configuration options for alert triggers on this Linode.
- List<String>
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- List<String>
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - backup
Id Integer - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- backups
Enabled Boolean - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- boot
Config StringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- booted Boolean
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- configs
List<Instance
Config> - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disk
Encryption String - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- disks
List<Instance
Disk> - firewall
Id Integer - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - group String
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - image String
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- interfaces
List<Instance
Interface> - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- ipv4s List<String>
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- metadatas
List<Instance
Metadata> - Various fields related to the Linode Metadata service.
- migration
Type String - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- placement
Group InstancePlacement Group - Information about the Placement Group this Linode is assigned to.
- placement
Group BooleanExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- private
Ip Boolean - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- resize
Disk Boolean If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- root
Pass String - The password that will be initially assigned to the 'root' user account.
- List<String>
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- stackscript
Data Map<String,String> - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript
Id Integer - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- swap
Size Integer - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- List<String>
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type String
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog
Enabled Boolean - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- region string
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - alerts
Instance
Alerts - Configuration options for alert triggers on this Linode.
- string[]
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- string[]
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - backup
Id number - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- backups
Enabled boolean - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- boot
Config stringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- booted boolean
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- configs
Instance
Config[] - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disk
Encryption string - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- disks
Instance
Disk[] - firewall
Id number - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - group string
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- interfaces
Instance
Interface[] - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- ipv4s string[]
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- metadatas
Instance
Metadata[] - Various fields related to the Linode Metadata service.
- migration
Type string - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- placement
Group InstancePlacement Group - Information about the Placement Group this Linode is assigned to.
- placement
Group booleanExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- private
Ip boolean - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- resize
Disk boolean If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- root
Pass string - The password that will be initially assigned to the 'root' user account.
- string[]
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- stackscript
Data {[key: string]: string} - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript
Id number - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- swap
Size number - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- string[]
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type string
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog
Enabled boolean - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- region str
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - alerts
Instance
Alerts Args - Configuration options for alert triggers on this Linode.
- Sequence[str]
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- Sequence[str]
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - backup_
id int - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- backups_
enabled bool - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- boot_
config_ strlabel - The Label of the Instance Config that should be used to boot the Linode instance.
- booted bool
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- configs
Sequence[Instance
Config Args] - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disk_
encryption str - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- disks
Sequence[Instance
Disk Args] - firewall_
id int - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - group str
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - image str
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- interfaces
Sequence[Instance
Interface Args] - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- ipv4s Sequence[str]
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- label str
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- metadatas
Sequence[Instance
Metadata Args] - Various fields related to the Linode Metadata service.
- migration_
type str - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- placement_
group InstancePlacement Group Args - Information about the Placement Group this Linode is assigned to.
- placement_
group_ boolexternally_ managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- private_
ip bool - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- resize_
disk bool If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- root_
pass str - The password that will be initially assigned to the 'root' user account.
- Sequence[str]
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- stackscript_
data Mapping[str, str] - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript_
id int - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- swap_
size int - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- Sequence[str]
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type str
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog_
enabled bool - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- region String
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - alerts Property Map
- Configuration options for alert triggers on this Linode.
- List<String>
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- List<String>
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - backup
Id Number - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- backups
Enabled Boolean - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- boot
Config StringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- booted Boolean
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- configs List<Property Map>
- Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disk
Encryption String - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- disks List<Property Map>
- firewall
Id Number - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - group String
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - image String
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- interfaces List<Property Map>
- An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- ipv4s List<String>
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- metadatas List<Property Map>
- Various fields related to the Linode Metadata service.
- migration
Type String - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- placement
Group Property Map - Information about the Placement Group this Linode is assigned to.
- placement
Group BooleanExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- private
Ip Boolean - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- resize
Disk Boolean If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- root
Pass String - The password that will be initially assigned to the 'root' user account.
- List<String>
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- stackscript
Data Map<String> - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript
Id Number - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- swap
Size Number - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- List<String>
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type String
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog
Enabled Boolean - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
Outputs
All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:
- Backups
Instance
Backups - Information about this Linode's backups status.
- Capabilities List<string>
- A list of capabilities of this Linode instance.
- Has
User boolData - Whether this Instance was created with user-data.
- Host
Uuid string - The Linode’s host machine, as a UUID.
- Id string
- The provider-assigned unique ID for this managed resource.
- Ip
Address string - A string containing the Linode's public IP address.
- Ipv6 string
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - Lke
Cluster intId - If applicable, the ID of the LKE cluster this instance is a part of.
- Private
Ip stringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- Specs
Instance
Specs - Information about the resources available to this Linode.
- Status string
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...)
- Backups
Instance
Backups - Information about this Linode's backups status.
- Capabilities []string
- A list of capabilities of this Linode instance.
- Has
User boolData - Whether this Instance was created with user-data.
- Host
Uuid string - The Linode’s host machine, as a UUID.
- Id string
- The provider-assigned unique ID for this managed resource.
- Ip
Address string - A string containing the Linode's public IP address.
- Ipv6 string
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - Lke
Cluster intId - If applicable, the ID of the LKE cluster this instance is a part of.
- Private
Ip stringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- Specs
Instance
Specs - Information about the resources available to this Linode.
- Status string
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...)
- backups
Instance
Backups - Information about this Linode's backups status.
- capabilities List<String>
- A list of capabilities of this Linode instance.
- has
User BooleanData - Whether this Instance was created with user-data.
- host
Uuid String - The Linode’s host machine, as a UUID.
- id String
- The provider-assigned unique ID for this managed resource.
- ip
Address String - A string containing the Linode's public IP address.
- ipv6 String
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - lke
Cluster IntegerId - If applicable, the ID of the LKE cluster this instance is a part of.
- private
Ip StringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- specs
Instance
Specs - Information about the resources available to this Linode.
- status String
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...)
- backups
Instance
Backups - Information about this Linode's backups status.
- capabilities string[]
- A list of capabilities of this Linode instance.
- has
User booleanData - Whether this Instance was created with user-data.
- host
Uuid string - The Linode’s host machine, as a UUID.
- id string
- The provider-assigned unique ID for this managed resource.
- ip
Address string - A string containing the Linode's public IP address.
- ipv6 string
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - lke
Cluster numberId - If applicable, the ID of the LKE cluster this instance is a part of.
- private
Ip stringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- specs
Instance
Specs - Information about the resources available to this Linode.
- status string
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...)
- backups
Instance
Backups - Information about this Linode's backups status.
- capabilities Sequence[str]
- A list of capabilities of this Linode instance.
- has_
user_ booldata - Whether this Instance was created with user-data.
- host_
uuid str - The Linode’s host machine, as a UUID.
- id str
- The provider-assigned unique ID for this managed resource.
- ip_
address str - A string containing the Linode's public IP address.
- ipv6 str
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - lke_
cluster_ intid - If applicable, the ID of the LKE cluster this instance is a part of.
- private_
ip_ straddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- specs
Instance
Specs - Information about the resources available to this Linode.
- status str
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...)
- backups Property Map
- Information about this Linode's backups status.
- capabilities List<String>
- A list of capabilities of this Linode instance.
- has
User BooleanData - Whether this Instance was created with user-data.
- host
Uuid String - The Linode’s host machine, as a UUID.
- id String
- The provider-assigned unique ID for this managed resource.
- ip
Address String - A string containing the Linode's public IP address.
- ipv6 String
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - lke
Cluster NumberId - If applicable, the ID of the LKE cluster this instance is a part of.
- private
Ip StringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- specs Property Map
- Information about the resources available to this Linode.
- status String
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...)
Look up Existing Instance Resource
Get an existing Instance 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?: InstanceState, opts?: CustomResourceOptions): Instance
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
alerts: Optional[InstanceAlertsArgs] = None,
authorized_keys: Optional[Sequence[str]] = None,
authorized_users: Optional[Sequence[str]] = None,
backup_id: Optional[int] = None,
backups: Optional[InstanceBackupsArgs] = None,
backups_enabled: Optional[bool] = None,
boot_config_label: Optional[str] = None,
booted: Optional[bool] = None,
capabilities: Optional[Sequence[str]] = None,
configs: Optional[Sequence[InstanceConfigArgs]] = None,
disk_encryption: Optional[str] = None,
disks: Optional[Sequence[InstanceDiskArgs]] = None,
firewall_id: Optional[int] = None,
group: Optional[str] = None,
has_user_data: Optional[bool] = None,
host_uuid: Optional[str] = None,
image: Optional[str] = None,
interfaces: Optional[Sequence[InstanceInterfaceArgs]] = None,
ip_address: Optional[str] = None,
ipv4s: Optional[Sequence[str]] = None,
ipv6: Optional[str] = None,
label: Optional[str] = None,
lke_cluster_id: Optional[int] = None,
metadatas: Optional[Sequence[InstanceMetadataArgs]] = None,
migration_type: Optional[str] = None,
placement_group: Optional[InstancePlacementGroupArgs] = None,
placement_group_externally_managed: Optional[bool] = None,
private_ip: Optional[bool] = None,
private_ip_address: Optional[str] = None,
region: Optional[str] = None,
resize_disk: Optional[bool] = None,
root_pass: Optional[str] = None,
shared_ipv4s: Optional[Sequence[str]] = None,
specs: Optional[InstanceSpecsArgs] = None,
stackscript_data: Optional[Mapping[str, str]] = None,
stackscript_id: Optional[int] = None,
status: Optional[str] = None,
swap_size: Optional[int] = None,
tags: Optional[Sequence[str]] = None,
type: Optional[str] = None,
watchdog_enabled: Optional[bool] = None) -> Instance
func GetInstance(ctx *Context, name string, id IDInput, state *InstanceState, opts ...ResourceOption) (*Instance, error)
public static Instance Get(string name, Input<string> id, InstanceState? state, CustomResourceOptions? opts = null)
public static Instance get(String name, Output<String> id, InstanceState 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.
- Alerts
Instance
Alerts - Configuration options for alert triggers on this Linode.
- List<string>
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- List<string>
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - Backup
Id int - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- Backups
Instance
Backups - Information about this Linode's backups status.
- Backups
Enabled bool - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- Boot
Config stringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- Booted bool
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- Capabilities List<string>
- A list of capabilities of this Linode instance.
- Configs
List<Instance
Config> - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- Disk
Encryption string - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- Disks
List<Instance
Disk> - Firewall
Id int - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - Group string
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - Has
User boolData - Whether this Instance was created with user-data.
- Host
Uuid string - The Linode’s host machine, as a UUID.
- Image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- Interfaces
List<Instance
Interface> - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- Ip
Address string - A string containing the Linode's public IP address.
- Ipv4s List<string>
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Ipv6 string
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Lke
Cluster intId - If applicable, the ID of the LKE cluster this instance is a part of.
- Metadatas
List<Instance
Metadata> - Various fields related to the Linode Metadata service.
- Migration
Type string - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- Placement
Group InstancePlacement Group - Information about the Placement Group this Linode is assigned to.
- Placement
Group boolExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- Private
Ip bool - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- Private
Ip stringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- Region string
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - Resize
Disk bool If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- Root
Pass string - The password that will be initially assigned to the 'root' user account.
- List<string>
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- Specs
Instance
Specs - Information about the resources available to this Linode.
- Stackscript
Data Dictionary<string, string> - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- Stackscript
Id int - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- Status string
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - Swap
Size int - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- List<string>
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- Type string
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - Watchdog
Enabled bool - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- Alerts
Instance
Alerts Args - Configuration options for alert triggers on this Linode.
- []string
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- []string
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - Backup
Id int - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- Backups
Instance
Backups Args - Information about this Linode's backups status.
- Backups
Enabled bool - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- Boot
Config stringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- Booted bool
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- Capabilities []string
- A list of capabilities of this Linode instance.
- Configs
[]Instance
Config Type Args - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- Disk
Encryption string - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- Disks
[]Instance
Disk Type Args - Firewall
Id int - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - Group string
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - Has
User boolData - Whether this Instance was created with user-data.
- Host
Uuid string - The Linode’s host machine, as a UUID.
- Image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- Interfaces
[]Instance
Interface Args - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- Ip
Address string - A string containing the Linode's public IP address.
- Ipv4s []string
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Ipv6 string
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Lke
Cluster intId - If applicable, the ID of the LKE cluster this instance is a part of.
- Metadatas
[]Instance
Metadata Args - Various fields related to the Linode Metadata service.
- Migration
Type string - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- Placement
Group InstancePlacement Group Args - Information about the Placement Group this Linode is assigned to.
- Placement
Group boolExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- Private
Ip bool - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- Private
Ip stringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- Region string
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - Resize
Disk bool If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- Root
Pass string - The password that will be initially assigned to the 'root' user account.
- []string
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- Specs
Instance
Specs Args - Information about the resources available to this Linode.
- Stackscript
Data map[string]string - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- Stackscript
Id int - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- Status string
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - Swap
Size int - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- []string
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- Type string
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - Watchdog
Enabled bool - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- alerts
Instance
Alerts - Configuration options for alert triggers on this Linode.
- List<String>
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- List<String>
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - backup
Id Integer - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- backups
Instance
Backups - Information about this Linode's backups status.
- backups
Enabled Boolean - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- boot
Config StringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- booted Boolean
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- capabilities List<String>
- A list of capabilities of this Linode instance.
- configs
List<Instance
Config> - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disk
Encryption String - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- disks
List<Instance
Disk> - firewall
Id Integer - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - group String
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - has
User BooleanData - Whether this Instance was created with user-data.
- host
Uuid String - The Linode’s host machine, as a UUID.
- image String
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- interfaces
List<Instance
Interface> - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- ip
Address String - A string containing the Linode's public IP address.
- ipv4s List<String>
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- ipv6 String
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- lke
Cluster IntegerId - If applicable, the ID of the LKE cluster this instance is a part of.
- metadatas
List<Instance
Metadata> - Various fields related to the Linode Metadata service.
- migration
Type String - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- placement
Group InstancePlacement Group - Information about the Placement Group this Linode is assigned to.
- placement
Group BooleanExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- private
Ip Boolean - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- private
Ip StringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- region String
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - resize
Disk Boolean If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- root
Pass String - The password that will be initially assigned to the 'root' user account.
- List<String>
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- specs
Instance
Specs - Information about the resources available to this Linode.
- stackscript
Data Map<String,String> - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript
Id Integer - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- status String
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - swap
Size Integer - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- List<String>
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type String
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog
Enabled Boolean - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- alerts
Instance
Alerts - Configuration options for alert triggers on this Linode.
- string[]
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- string[]
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - backup
Id number - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- backups
Instance
Backups - Information about this Linode's backups status.
- backups
Enabled boolean - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- boot
Config stringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- booted boolean
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- capabilities string[]
- A list of capabilities of this Linode instance.
- configs
Instance
Config[] - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disk
Encryption string - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- disks
Instance
Disk[] - firewall
Id number - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - group string
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - has
User booleanData - Whether this Instance was created with user-data.
- host
Uuid string - The Linode’s host machine, as a UUID.
- image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- interfaces
Instance
Interface[] - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- ip
Address string - A string containing the Linode's public IP address.
- ipv4s string[]
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- ipv6 string
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- lke
Cluster numberId - If applicable, the ID of the LKE cluster this instance is a part of.
- metadatas
Instance
Metadata[] - Various fields related to the Linode Metadata service.
- migration
Type string - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- placement
Group InstancePlacement Group - Information about the Placement Group this Linode is assigned to.
- placement
Group booleanExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- private
Ip boolean - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- private
Ip stringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- region string
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - resize
Disk boolean If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- root
Pass string - The password that will be initially assigned to the 'root' user account.
- string[]
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- specs
Instance
Specs - Information about the resources available to this Linode.
- stackscript
Data {[key: string]: string} - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript
Id number - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- status string
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - swap
Size number - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- string[]
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type string
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog
Enabled boolean - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- alerts
Instance
Alerts Args - Configuration options for alert triggers on this Linode.
- Sequence[str]
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- Sequence[str]
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - backup_
id int - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- backups
Instance
Backups Args - Information about this Linode's backups status.
- backups_
enabled bool - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- boot_
config_ strlabel - The Label of the Instance Config that should be used to boot the Linode instance.
- booted bool
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- capabilities Sequence[str]
- A list of capabilities of this Linode instance.
- configs
Sequence[Instance
Config Args] - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disk_
encryption str - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- disks
Sequence[Instance
Disk Args] - firewall_
id int - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - group str
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - has_
user_ booldata - Whether this Instance was created with user-data.
- host_
uuid str - The Linode’s host machine, as a UUID.
- image str
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- interfaces
Sequence[Instance
Interface Args] - An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- ip_
address str - A string containing the Linode's public IP address.
- ipv4s Sequence[str]
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- ipv6 str
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - label str
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- lke_
cluster_ intid - If applicable, the ID of the LKE cluster this instance is a part of.
- metadatas
Sequence[Instance
Metadata Args] - Various fields related to the Linode Metadata service.
- migration_
type str - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- placement_
group InstancePlacement Group Args - Information about the Placement Group this Linode is assigned to.
- placement_
group_ boolexternally_ managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- private_
ip bool - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- private_
ip_ straddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- region str
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - resize_
disk bool If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- root_
pass str - The password that will be initially assigned to the 'root' user account.
- Sequence[str]
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- specs
Instance
Specs Args - Information about the resources available to this Linode.
- stackscript_
data Mapping[str, str] - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript_
id int - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- status str
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - swap_
size int - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- Sequence[str]
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type str
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog_
enabled bool - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- alerts Property Map
- Configuration options for alert triggers on this Linode.
- List<String>
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- List<String>
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - backup
Id Number - A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. See /linode/instances/{linodeId}/backups for a Linode's available backups. This field and the image field are mutually exclusive.
- backups Property Map
- Information about this Linode's backups status.
- backups
Enabled Boolean - If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed.
- boot
Config StringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- booted Boolean
- If true, then the instance is kept or converted into in a running state. If false, the instance will be shutdown. If unspecified, the Linode's power status will not be managed by the Provider.
- capabilities List<String>
- A list of capabilities of this Linode instance.
- configs List<Property Map>
- Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disk
Encryption String - The disk encryption policy for this instance. (
enabled
,disabled
; defaultenabled
in supported regions)- NOTE: Disk encryption may not currently be available to all users.
- disks List<Property Map>
- firewall
Id Number - The ID of the Firewall to attach to the instance upon creation. Changing
firewall_id
forces the creation of a new Linode Instance. - group String
- A deprecated property denoting a group label for this Linode. We recommend using the
tags
attribute instead. - has
User BooleanData - Whether this Instance was created with user-data.
- host
Uuid String - The Linode’s host machine, as a UUID.
- image String
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/. See /images for more information on the Images available for you to use.
- interfaces List<Property Map>
- An array of Network Interfaces for this Linode to be created with. If an explicit config or disk is defined, interfaces must be declared in the config block.
- ip
Address String - A string containing the Linode's public IP address.
- ipv4s List<String>
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- ipv6 String
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- lke
Cluster NumberId - If applicable, the ID of the LKE cluster this instance is a part of.
- metadatas List<Property Map>
- Various fields related to the Linode Metadata service.
- migration
Type String - The type of migration to use when updating the type or region of a Linode. (
cold
,warm
; defaultcold
)interface
- (Optional) A list of network interfaces to be assigned to the Linode on creation. If an explicit config or disk is defined, interfaces must be declared in theconfig
block.
- placement
Group Property Map - Information about the Placement Group this Linode is assigned to.
- placement
Group BooleanExternally Managed - If true, changes to the Linode's assigned Placement Group will be ignored. This is necessary when using this resource in conjunction with the linode.PlacementGroupAssignment resource.
- private
Ip Boolean - If true, the created Linode will have private networking enabled, allowing use of the 192.168.128.0/17 network within the Linode's region. It can be enabled on an existing Linode but it can't be disabled.
- private
Ip StringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- region String
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. Changingregion
will trigger a migration of this Linode. Migration operations are typically long-running operations, so the update timeout should be adjusted accordingly.. - resize
Disk Boolean If true, changes in Linode type will attempt to upsize or downsize implicitly created disks. This must be false if explicit disks are defined. This is an irreversible action as Linode disks cannot be automatically downsized.
alerts.0.cpu
- (Optional) The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.alerts.0.network_in
- (Optional) The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.network_out
- (Optional) The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.alerts.0.transfer_quota
- (Optional) The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.alerts.0.io
- (Optional) The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- root
Pass String - The password that will be initially assigned to the 'root' user account.
- List<String>
A set of IPv4 addresses to be shared with the Instance. These IP addresses can be both private and public, but must be in the same region as the instance.
metadata.0.user_data
- (Optional) The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.placement_group.0.id
- (Optional) The ID of the Placement Group to assign this Linode to.
- specs Property Map
- Information about the resources available to this Linode.
- stackscript
Data Map<String> - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript
Id Number - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- status String
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - swap
Size Number - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- List<String>
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type String
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog
Enabled Boolean - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
Supporting Types
InstanceAlerts, InstanceAlertsArgs
- Cpu int
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- Io int
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- Network
In int - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- Network
Out int - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- Transfer
Quota int - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- Cpu int
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- Io int
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- Network
In int - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- Network
Out int - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- Transfer
Quota int - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- cpu Integer
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- io Integer
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- network
In Integer - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- network
Out Integer - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- transfer
Quota Integer - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- cpu number
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- io number
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- network
In number - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- network
Out number - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- transfer
Quota number - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- cpu int
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- io int
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- network_
in int - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- network_
out int - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- transfer_
quota int - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- cpu Number
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- io Number
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- network
In Number - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- network
Out Number - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- transfer
Quota Number - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
InstanceBackups, InstanceBackupsArgs
- Available bool
- Whether this Backup is available for restoration.
- Enabled bool
- If this Linode has the Backup service enabled.
- Schedule
Instance
Backups Schedule
- Available bool
- Whether this Backup is available for restoration.
- Enabled bool
- If this Linode has the Backup service enabled.
- Schedule
Instance
Backups Schedule
- available Boolean
- Whether this Backup is available for restoration.
- enabled Boolean
- If this Linode has the Backup service enabled.
- schedule
Instance
Backups Schedule
- available boolean
- Whether this Backup is available for restoration.
- enabled boolean
- If this Linode has the Backup service enabled.
- schedule
Instance
Backups Schedule
- available bool
- Whether this Backup is available for restoration.
- enabled bool
- If this Linode has the Backup service enabled.
- schedule
Instance
Backups Schedule
- available Boolean
- Whether this Backup is available for restoration.
- enabled Boolean
- If this Linode has the Backup service enabled.
- schedule Property Map
InstanceBackupsSchedule, InstanceBackupsScheduleArgs
- Day string
- The day of the week that your Linode's weekly Backup is taken. If not set manually, a day will be chosen for you. Backups are taken every day, but backups taken on this day are preferred when selecting backups to retain for a longer period. If not set manually, then when backups are initially enabled, this may come back as "Scheduling" until the day is automatically selected.
- Window string
- The window ('W0'-'W22') in which your backups will be taken, in UTC. A backups window is a two-hour span of time in which the backup may occur. For example, 'W10' indicates that your backups should be taken between 10:00 and 12:00. If you do not choose a backup window, one will be selected for you automatically. If not set manually, when backups are initially enabled this may come back as Scheduling until the window is automatically selected.
- Day string
- The day of the week that your Linode's weekly Backup is taken. If not set manually, a day will be chosen for you. Backups are taken every day, but backups taken on this day are preferred when selecting backups to retain for a longer period. If not set manually, then when backups are initially enabled, this may come back as "Scheduling" until the day is automatically selected.
- Window string
- The window ('W0'-'W22') in which your backups will be taken, in UTC. A backups window is a two-hour span of time in which the backup may occur. For example, 'W10' indicates that your backups should be taken between 10:00 and 12:00. If you do not choose a backup window, one will be selected for you automatically. If not set manually, when backups are initially enabled this may come back as Scheduling until the window is automatically selected.
- day String
- The day of the week that your Linode's weekly Backup is taken. If not set manually, a day will be chosen for you. Backups are taken every day, but backups taken on this day are preferred when selecting backups to retain for a longer period. If not set manually, then when backups are initially enabled, this may come back as "Scheduling" until the day is automatically selected.
- window String
- The window ('W0'-'W22') in which your backups will be taken, in UTC. A backups window is a two-hour span of time in which the backup may occur. For example, 'W10' indicates that your backups should be taken between 10:00 and 12:00. If you do not choose a backup window, one will be selected for you automatically. If not set manually, when backups are initially enabled this may come back as Scheduling until the window is automatically selected.
- day string
- The day of the week that your Linode's weekly Backup is taken. If not set manually, a day will be chosen for you. Backups are taken every day, but backups taken on this day are preferred when selecting backups to retain for a longer period. If not set manually, then when backups are initially enabled, this may come back as "Scheduling" until the day is automatically selected.
- window string
- The window ('W0'-'W22') in which your backups will be taken, in UTC. A backups window is a two-hour span of time in which the backup may occur. For example, 'W10' indicates that your backups should be taken between 10:00 and 12:00. If you do not choose a backup window, one will be selected for you automatically. If not set manually, when backups are initially enabled this may come back as Scheduling until the window is automatically selected.
- day str
- The day of the week that your Linode's weekly Backup is taken. If not set manually, a day will be chosen for you. Backups are taken every day, but backups taken on this day are preferred when selecting backups to retain for a longer period. If not set manually, then when backups are initially enabled, this may come back as "Scheduling" until the day is automatically selected.
- window str
- The window ('W0'-'W22') in which your backups will be taken, in UTC. A backups window is a two-hour span of time in which the backup may occur. For example, 'W10' indicates that your backups should be taken between 10:00 and 12:00. If you do not choose a backup window, one will be selected for you automatically. If not set manually, when backups are initially enabled this may come back as Scheduling until the window is automatically selected.
- day String
- The day of the week that your Linode's weekly Backup is taken. If not set manually, a day will be chosen for you. Backups are taken every day, but backups taken on this day are preferred when selecting backups to retain for a longer period. If not set manually, then when backups are initially enabled, this may come back as "Scheduling" until the day is automatically selected.
- window String
- The window ('W0'-'W22') in which your backups will be taken, in UTC. A backups window is a two-hour span of time in which the backup may occur. For example, 'W10' indicates that your backups should be taken between 10:00 and 12:00. If you do not choose a backup window, one will be selected for you automatically. If not set manually, when backups are initially enabled this may come back as Scheduling until the window is automatically selected.
InstanceConfig, InstanceConfigArgs
- Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Comments string
- Optional field for arbitrary User comments on this Config.
- Devices
Instance
Config Devices - Device sda-sdh can be either a Disk or Volume identified by disk_label or volume_id. Only one type per slot allowed.
- Helpers
Instance
Config Helpers - Helpers enabled when booting to this Linode Config.
- Id int
- The ID of the Placement Group.
- Interfaces
List<Instance
Config Interface> - An array of Network Interfaces for this Linode’s Configuration Profile.
- Kernel string
- A Kernel ID to boot a Linode with. Default is based on image choice. (examples: linode/latest-64bit, linode/grub2, linode/direct-disk)
- Memory
Limit int - Defaults to the total RAM of the Linode
- Root
Device string - The root device to boot. The corresponding disk must be attached.
- Run
Level string - Defines the state of your Linode after booting. Defaults to default.
- Virt
Mode string - Controls the virtualization mode. Defaults to paravirt.
- Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Comments string
- Optional field for arbitrary User comments on this Config.
- Devices
Instance
Config Devices - Device sda-sdh can be either a Disk or Volume identified by disk_label or volume_id. Only one type per slot allowed.
- Helpers
Instance
Config Helpers - Helpers enabled when booting to this Linode Config.
- Id int
- The ID of the Placement Group.
- Interfaces
[]Instance
Config Interface - An array of Network Interfaces for this Linode’s Configuration Profile.
- Kernel string
- A Kernel ID to boot a Linode with. Default is based on image choice. (examples: linode/latest-64bit, linode/grub2, linode/direct-disk)
- Memory
Limit int - Defaults to the total RAM of the Linode
- Root
Device string - The root device to boot. The corresponding disk must be attached.
- Run
Level string - Defines the state of your Linode after booting. Defaults to default.
- Virt
Mode string - Controls the virtualization mode. Defaults to paravirt.
- label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- comments String
- Optional field for arbitrary User comments on this Config.
- devices
Instance
Config Devices - Device sda-sdh can be either a Disk or Volume identified by disk_label or volume_id. Only one type per slot allowed.
- helpers
Instance
Config Helpers - Helpers enabled when booting to this Linode Config.
- id Integer
- The ID of the Placement Group.
- interfaces
List<Instance
Config Interface> - An array of Network Interfaces for this Linode’s Configuration Profile.
- kernel String
- A Kernel ID to boot a Linode with. Default is based on image choice. (examples: linode/latest-64bit, linode/grub2, linode/direct-disk)
- memory
Limit Integer - Defaults to the total RAM of the Linode
- root
Device String - The root device to boot. The corresponding disk must be attached.
- run
Level String - Defines the state of your Linode after booting. Defaults to default.
- virt
Mode String - Controls the virtualization mode. Defaults to paravirt.
- label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- comments string
- Optional field for arbitrary User comments on this Config.
- devices
Instance
Config Devices - Device sda-sdh can be either a Disk or Volume identified by disk_label or volume_id. Only one type per slot allowed.
- helpers
Instance
Config Helpers - Helpers enabled when booting to this Linode Config.
- id number
- The ID of the Placement Group.
- interfaces
Instance
Config Interface[] - An array of Network Interfaces for this Linode’s Configuration Profile.
- kernel string
- A Kernel ID to boot a Linode with. Default is based on image choice. (examples: linode/latest-64bit, linode/grub2, linode/direct-disk)
- memory
Limit number - Defaults to the total RAM of the Linode
- root
Device string - The root device to boot. The corresponding disk must be attached.
- run
Level string - Defines the state of your Linode after booting. Defaults to default.
- virt
Mode string - Controls the virtualization mode. Defaults to paravirt.
- label str
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- comments str
- Optional field for arbitrary User comments on this Config.
- devices
Instance
Config Devices - Device sda-sdh can be either a Disk or Volume identified by disk_label or volume_id. Only one type per slot allowed.
- helpers
Instance
Config Helpers - Helpers enabled when booting to this Linode Config.
- id int
- The ID of the Placement Group.
- interfaces
Sequence[Instance
Config Interface] - An array of Network Interfaces for this Linode’s Configuration Profile.
- kernel str
- A Kernel ID to boot a Linode with. Default is based on image choice. (examples: linode/latest-64bit, linode/grub2, linode/direct-disk)
- memory_
limit int - Defaults to the total RAM of the Linode
- root_
device str - The root device to boot. The corresponding disk must be attached.
- run_
level str - Defines the state of your Linode after booting. Defaults to default.
- virt_
mode str - Controls the virtualization mode. Defaults to paravirt.
- label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- comments String
- Optional field for arbitrary User comments on this Config.
- devices Property Map
- Device sda-sdh can be either a Disk or Volume identified by disk_label or volume_id. Only one type per slot allowed.
- helpers Property Map
- Helpers enabled when booting to this Linode Config.
- id Number
- The ID of the Placement Group.
- interfaces List<Property Map>
- An array of Network Interfaces for this Linode’s Configuration Profile.
- kernel String
- A Kernel ID to boot a Linode with. Default is based on image choice. (examples: linode/latest-64bit, linode/grub2, linode/direct-disk)
- memory
Limit Number - Defaults to the total RAM of the Linode
- root
Device String - The root device to boot. The corresponding disk must be attached.
- run
Level String - Defines the state of your Linode after booting. Defaults to default.
- virt
Mode String - Controls the virtualization mode. Defaults to paravirt.
InstanceConfigDevices, InstanceConfigDevicesArgs
- Sda
Instance
Config Devices Sda - ...
sdh
- (Optional) The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_id
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - Sdb
Instance
Config Devices Sdb - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdc
Instance
Config Devices Sdc - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdd
Instance
Config Devices Sdd - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sde
Instance
Config Devices Sde - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdf
Instance
Config Devices Sdf - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdg
Instance
Config Devices Sdg - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdh
Instance
Config Devices Sdh - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sda
Instance
Config Devices Sda - ...
sdh
- (Optional) The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_id
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - Sdb
Instance
Config Devices Sdb - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdc
Instance
Config Devices Sdc - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdd
Instance
Config Devices Sdd - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sde
Instance
Config Devices Sde - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdf
Instance
Config Devices Sdf - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdg
Instance
Config Devices Sdg - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdh
Instance
Config Devices Sdh - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sda
Instance
Config Devices Sda - ...
sdh
- (Optional) The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_id
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - sdb
Instance
Config Devices Sdb - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdc
Instance
Config Devices Sdc - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdd
Instance
Config Devices Sdd - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sde
Instance
Config Devices Sde - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdf
Instance
Config Devices Sdf - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdg
Instance
Config Devices Sdg - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdh
Instance
Config Devices Sdh - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sda
Instance
Config Devices Sda - ...
sdh
- (Optional) The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_id
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - sdb
Instance
Config Devices Sdb - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdc
Instance
Config Devices Sdc - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdd
Instance
Config Devices Sdd - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sde
Instance
Config Devices Sde - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdf
Instance
Config Devices Sdf - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdg
Instance
Config Devices Sdg - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdh
Instance
Config Devices Sdh - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sda
Instance
Config Devices Sda - ...
sdh
- (Optional) The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_id
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - sdb
Instance
Config Devices Sdb - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdc
Instance
Config Devices Sdc - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdd
Instance
Config Devices Sdd - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sde
Instance
Config Devices Sde - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdf
Instance
Config Devices Sdf - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdg
Instance
Config Devices Sdg - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdh
Instance
Config Devices Sdh - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sda Property Map
- ...
sdh
- (Optional) The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_id
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - sdb Property Map
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdc Property Map
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdd Property Map
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sde Property Map
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdf Property Map
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdg Property Map
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdh Property Map
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
InstanceConfigDevicesSda, InstanceConfigDevicesSdaArgs
InstanceConfigDevicesSdb, InstanceConfigDevicesSdbArgs
InstanceConfigDevicesSdc, InstanceConfigDevicesSdcArgs
InstanceConfigDevicesSdd, InstanceConfigDevicesSddArgs
InstanceConfigDevicesSde, InstanceConfigDevicesSdeArgs
InstanceConfigDevicesSdf, InstanceConfigDevicesSdfArgs
InstanceConfigDevicesSdg, InstanceConfigDevicesSdgArgs
InstanceConfigDevicesSdh, InstanceConfigDevicesSdhArgs
InstanceConfigHelpers, InstanceConfigHelpersArgs
- Devtmpfs
Automount bool - Populates the /dev directory early during boot without udev. Defaults to false.
- Distro bool
- Controls the behavior of the Linode Config's Distribution Helper setting.
- Modules
Dep bool - Creates a modules dependency file for the Kernel you run.
- Network bool
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- Updatedb
Disabled bool - Disables updatedb cron job to avoid disk thrashing.
- Devtmpfs
Automount bool - Populates the /dev directory early during boot without udev. Defaults to false.
- Distro bool
- Controls the behavior of the Linode Config's Distribution Helper setting.
- Modules
Dep bool - Creates a modules dependency file for the Kernel you run.
- Network bool
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- Updatedb
Disabled bool - Disables updatedb cron job to avoid disk thrashing.
- devtmpfs
Automount Boolean - Populates the /dev directory early during boot without udev. Defaults to false.
- distro Boolean
- Controls the behavior of the Linode Config's Distribution Helper setting.
- modules
Dep Boolean - Creates a modules dependency file for the Kernel you run.
- network Boolean
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedb
Disabled Boolean - Disables updatedb cron job to avoid disk thrashing.
- devtmpfs
Automount boolean - Populates the /dev directory early during boot without udev. Defaults to false.
- distro boolean
- Controls the behavior of the Linode Config's Distribution Helper setting.
- modules
Dep boolean - Creates a modules dependency file for the Kernel you run.
- network boolean
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedb
Disabled boolean - Disables updatedb cron job to avoid disk thrashing.
- devtmpfs_
automount bool - Populates the /dev directory early during boot without udev. Defaults to false.
- distro bool
- Controls the behavior of the Linode Config's Distribution Helper setting.
- modules_
dep bool - Creates a modules dependency file for the Kernel you run.
- network bool
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedb_
disabled bool - Disables updatedb cron job to avoid disk thrashing.
- devtmpfs
Automount Boolean - Populates the /dev directory early during boot without udev. Defaults to false.
- distro Boolean
- Controls the behavior of the Linode Config's Distribution Helper setting.
- modules
Dep Boolean - Creates a modules dependency file for the Kernel you run.
- network Boolean
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedb
Disabled Boolean - Disables updatedb cron job to avoid disk thrashing.
InstanceConfigInterface, InstanceConfigInterfaceArgs
- Purpose string
- The type of interface. (
public
,vlan
,vpc
) - Active bool
- Whether this interface is currently booted and active.
- Id int
- The ID of the interface.
- Ip
Ranges List<string> - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- Ipam
Address string - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - Ipv4
Instance
Config Interface Ipv4 - The IPv4 configuration of the VPC interface.This attribute is only allowed for VPC interfaces.
- Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Primary bool
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- Subnet
Id int - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - Vpc
Id int - The ID of VPC which this interface is attached to.
- Purpose string
- The type of interface. (
public
,vlan
,vpc
) - Active bool
- Whether this interface is currently booted and active.
- Id int
- The ID of the interface.
- Ip
Ranges []string - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- Ipam
Address string - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - Ipv4
Instance
Config Interface Ipv4 - The IPv4 configuration of the VPC interface.This attribute is only allowed for VPC interfaces.
- Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Primary bool
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- Subnet
Id int - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - Vpc
Id int - The ID of VPC which this interface is attached to.
- purpose String
- The type of interface. (
public
,vlan
,vpc
) - active Boolean
- Whether this interface is currently booted and active.
- id Integer
- The ID of the interface.
- ip
Ranges List<String> - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam
Address String - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - ipv4
Instance
Config Interface Ipv4 - The IPv4 configuration of the VPC interface.This attribute is only allowed for VPC interfaces.
- label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary Boolean
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- subnet
Id Integer - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - vpc
Id Integer - The ID of VPC which this interface is attached to.
- purpose string
- The type of interface. (
public
,vlan
,vpc
) - active boolean
- Whether this interface is currently booted and active.
- id number
- The ID of the interface.
- ip
Ranges string[] - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam
Address string - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - ipv4
Instance
Config Interface Ipv4 - The IPv4 configuration of the VPC interface.This attribute is only allowed for VPC interfaces.
- label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary boolean
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- subnet
Id number - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - vpc
Id number - The ID of VPC which this interface is attached to.
- purpose str
- The type of interface. (
public
,vlan
,vpc
) - active bool
- Whether this interface is currently booted and active.
- id int
- The ID of the interface.
- ip_
ranges Sequence[str] - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam_
address str - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - ipv4
Instance
Config Interface Ipv4 - The IPv4 configuration of the VPC interface.This attribute is only allowed for VPC interfaces.
- label str
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary bool
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- subnet_
id int - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - vpc_
id int - The ID of VPC which this interface is attached to.
- purpose String
- The type of interface. (
public
,vlan
,vpc
) - active Boolean
- Whether this interface is currently booted and active.
- id Number
- The ID of the interface.
- ip
Ranges List<String> - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam
Address String - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - ipv4 Property Map
- The IPv4 configuration of the VPC interface.This attribute is only allowed for VPC interfaces.
- label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary Boolean
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- subnet
Id Number - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - vpc
Id Number - The ID of VPC which this interface is attached to.
InstanceConfigInterfaceIpv4, InstanceConfigInterfaceIpv4Args
- Nat11 string
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - Vpc string
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- Nat11 string
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - Vpc string
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 String
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc String
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 string
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc string
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 str
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc str
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 String
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc String
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
InstanceDisk, InstanceDiskArgs
- Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Size int
- The size of the Disk in MB.
- List<string>
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- List<string>
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - Filesystem string
- The Disk filesystem can be one of: raw, swap, ext3, ext4, initrd (max 32mb)
- Id int
- The ID of the Placement Group.
- Image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/.
- Read
Only bool - If true, this Disk is read-only.
- Root
Pass string - The password that will be initialially assigned to the 'root' user account.
- Stackscript
Data Dictionary<string, string> - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- Stackscript
Id int - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Size int
- The size of the Disk in MB.
- []string
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- []string
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - Filesystem string
- The Disk filesystem can be one of: raw, swap, ext3, ext4, initrd (max 32mb)
- Id int
- The ID of the Placement Group.
- Image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/.
- Read
Only bool - If true, this Disk is read-only.
- Root
Pass string - The password that will be initialially assigned to the 'root' user account.
- Stackscript
Data map[string]string - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- Stackscript
Id int - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- size Integer
- The size of the Disk in MB.
- List<String>
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- List<String>
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - filesystem String
- The Disk filesystem can be one of: raw, swap, ext3, ext4, initrd (max 32mb)
- id Integer
- The ID of the Placement Group.
- image String
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/.
- read
Only Boolean - If true, this Disk is read-only.
- root
Pass String - The password that will be initialially assigned to the 'root' user account.
- stackscript
Data Map<String,String> - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript
Id Integer - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- size number
- The size of the Disk in MB.
- string[]
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- string[]
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - filesystem string
- The Disk filesystem can be one of: raw, swap, ext3, ext4, initrd (max 32mb)
- id number
- The ID of the Placement Group.
- image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/.
- read
Only boolean - If true, this Disk is read-only.
- root
Pass string - The password that will be initialially assigned to the 'root' user account.
- stackscript
Data {[key: string]: string} - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript
Id number - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- label str
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- size int
- The size of the Disk in MB.
- Sequence[str]
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- Sequence[str]
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - filesystem str
- The Disk filesystem can be one of: raw, swap, ext3, ext4, initrd (max 32mb)
- id int
- The ID of the Placement Group.
- image str
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/.
- read_
only bool - If true, this Disk is read-only.
- root_
pass str - The password that will be initialially assigned to the 'root' user account.
- stackscript_
data Mapping[str, str] - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript_
id int - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
- label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- size Number
- The size of the Disk in MB.
- List<String>
- A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if 'image' is provided.
- List<String>
- A list of Linode usernames. If the usernames have associated SSH keys, the keys will be appended to the
root
user's~/.ssh/authorized_keys
file automatically. Only accepted if 'image' is provided. - filesystem String
- The Disk filesystem can be one of: raw, swap, ext3, ext4, initrd (max 32mb)
- id Number
- The ID of the Placement Group.
- image String
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with private/.
- read
Only Boolean - If true, this Disk is read-only.
- root
Pass String - The password that will be initialially assigned to the 'root' user account.
- stackscript
Data Map<String> - An object containing responses to any User Defined Fields present in the StackScript being deployed to this Linode. Only accepted if 'stackscript_id' is given. The required values depend on the StackScript being deployed.
- stackscript
Id Number - The StackScript to deploy to the newly created Linode. If provided, 'image' must also be provided, and must be an Image that is compatible with this StackScript.
InstanceInterface, InstanceInterfaceArgs
- Purpose string
- The type of interface. (
public
,vlan
,vpc
) - Active bool
- Whether this interface is currently booted and active.
- Id int
- The ID of the Placement Group.
- Ip
Ranges List<string> - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- Ipam
Address string - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - Ipv4
Instance
Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Primary bool
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- Subnet
Id int - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - Vpc
Id int - The ID of VPC which this interface is attached to.
- Purpose string
- The type of interface. (
public
,vlan
,vpc
) - Active bool
- Whether this interface is currently booted and active.
- Id int
- The ID of the Placement Group.
- Ip
Ranges []string - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- Ipam
Address string - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - Ipv4
Instance
Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Primary bool
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- Subnet
Id int - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - Vpc
Id int - The ID of VPC which this interface is attached to.
- purpose String
- The type of interface. (
public
,vlan
,vpc
) - active Boolean
- Whether this interface is currently booted and active.
- id Integer
- The ID of the Placement Group.
- ip
Ranges List<String> - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam
Address String - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - ipv4
Instance
Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary Boolean
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- subnet
Id Integer - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - vpc
Id Integer - The ID of VPC which this interface is attached to.
- purpose string
- The type of interface. (
public
,vlan
,vpc
) - active boolean
- Whether this interface is currently booted and active.
- id number
- The ID of the Placement Group.
- ip
Ranges string[] - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam
Address string - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - ipv4
Instance
Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary boolean
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- subnet
Id number - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - vpc
Id number - The ID of VPC which this interface is attached to.
- purpose str
- The type of interface. (
public
,vlan
,vpc
) - active bool
- Whether this interface is currently booted and active.
- id int
- The ID of the Placement Group.
- ip_
ranges Sequence[str] - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam_
address str - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - ipv4
Instance
Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- label str
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary bool
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- subnet_
id int - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - vpc_
id int - The ID of VPC which this interface is attached to.
- purpose String
- The type of interface. (
public
,vlan
,vpc
) - active Boolean
- Whether this interface is currently booted and active.
- id Number
- The ID of the Placement Group.
- ip
Ranges List<String> - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam
Address String - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - ipv4 Property Map
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary Boolean
Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose.ipv4
- (Optional) The IPv4 configuration of the VPC interface. This field is currently only allowed for interfaces with thevpc
purpose.
The following computed attribute is available in a VPC interface:
- subnet
Id Number - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose. - vpc
Id Number - The ID of VPC which this interface is attached to.
InstanceInterfaceIpv4, InstanceInterfaceIpv4Args
- Nat11 string
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - Vpc string
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- Nat11 string
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - Vpc string
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 String
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc String
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 string
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc string
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 str
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc str
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 String
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc String
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
InstanceMetadata, InstanceMetadataArgs
- User
Data string - The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.
- User
Data string - The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.
- user
Data String - The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.
- user
Data string - The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.
- user_
data str - The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.
- user
Data String - The base64-encoded user-defined data exposed to this instance through the Linode Metadata service. Refer to the base64encode(...) function for information on encoding content for this field.
InstancePlacementGroup, InstancePlacementGroupArgs
- Id int
- The ID of the Placement Group.
- Compliant
Only bool - Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Placement
Group stringPolicy - Whether the Placement Group enforces strict compliance.
- Placement
Group stringType - The placement group type enforced by the Placement Group.
- Id int
- The ID of the Placement Group.
- Compliant
Only bool - Label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- Placement
Group stringPolicy - Whether the Placement Group enforces strict compliance.
- Placement
Group stringType - The placement group type enforced by the Placement Group.
- id Integer
- The ID of the Placement Group.
- compliant
Only Boolean - label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- placement
Group StringPolicy - Whether the Placement Group enforces strict compliance.
- placement
Group StringType - The placement group type enforced by the Placement Group.
- id number
- The ID of the Placement Group.
- compliant
Only boolean - label string
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- placement
Group stringPolicy - Whether the Placement Group enforces strict compliance.
- placement
Group stringType - The placement group type enforced by the Placement Group.
- id int
- The ID of the Placement Group.
- compliant_
only bool - label str
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- placement_
group_ strpolicy - Whether the Placement Group enforces strict compliance.
- placement_
group_ strtype - The placement group type enforced by the Placement Group.
- id Number
- The ID of the Placement Group.
- compliant
Only Boolean - label String
- The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
- placement
Group StringPolicy - Whether the Placement Group enforces strict compliance.
- placement
Group StringType - The placement group type enforced by the Placement Group.
InstanceSpecs, InstanceSpecsArgs
- Disk int
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- Memory int
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- Transfer int
- The amount of network transfer this Linode is allotted each month.
- Vcpus int
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- Disk int
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- Memory int
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- Transfer int
- The amount of network transfer this Linode is allotted each month.
- Vcpus int
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- disk Integer
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- memory Integer
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- transfer Integer
- The amount of network transfer this Linode is allotted each month.
- vcpus Integer
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- disk number
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- memory number
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- transfer number
- The amount of network transfer this Linode is allotted each month.
- vcpus number
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- disk int
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- memory int
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- transfer int
- The amount of network transfer this Linode is allotted each month.
- vcpus int
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- disk Number
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- memory Number
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- transfer Number
- The amount of network transfer this Linode is allotted each month.
- vcpus Number
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
Import
Linodes Instances can be imported using the Linode id
, e.g.
$ pulumi import linode:index/instance:Instance mylinode 1234567
When importing an instance, all disk
and config
values must be represented.
Imported disks must include their label
value. Any disk that is not precisely represented may be removed resulting in data loss.
Imported configs should include all devices
, and must include label
, kernel
, and the root_device
. The instance must include a boot_config_label
referring to the correct configuration profile.
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Linode pulumi/pulumi-linode
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
linode
Terraform Provider.