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
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
return await Deployment.RunAsync(() =>
{
var web = new Linode.Instance("web", new()
{
AuthorizedKeys = new[]
{
"ssh-rsa AAAA...Gw== user@example.local",
},
Group = "foo",
Image = "linode/ubuntu18.04",
Label = "simple_instance",
PrivateIp = true,
Region = "us-central",
RootPass = "terr4form-test",
SwapSize = 256,
Tags = new[]
{
"foo",
},
Type = "g6-standard-1",
});
});
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{
AuthorizedKeys: pulumi.StringArray{
pulumi.String("ssh-rsa AAAA...Gw== user@example.local"),
},
Group: pulumi.String("foo"),
Image: pulumi.String("linode/ubuntu18.04"),
Label: pulumi.String("simple_instance"),
PrivateIp: pulumi.Bool(true),
Region: pulumi.String("us-central"),
RootPass: pulumi.String("terr4form-test"),
SwapSize: pulumi.Int(256),
Tags: pulumi.StringArray{
pulumi.String("foo"),
},
Type: pulumi.String("g6-standard-1"),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.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()
.authorizedKeys("ssh-rsa AAAA...Gw== user@example.local")
.group("foo")
.image("linode/ubuntu18.04")
.label("simple_instance")
.privateIp(true)
.region("us-central")
.rootPass("terr4form-test")
.swapSize(256)
.tags("foo")
.type("g6-standard-1")
.build());
}
}
import pulumi
import pulumi_linode as linode
web = linode.Instance("web",
authorized_keys=["ssh-rsa AAAA...Gw== user@example.local"],
group="foo",
image="linode/ubuntu18.04",
label="simple_instance",
private_ip=True,
region="us-central",
root_pass="terr4form-test",
swap_size=256,
tags=["foo"],
type="g6-standard-1")
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
const web = new linode.Instance("web", {
authorizedKeys: ["ssh-rsa AAAA...Gw== user@example.local"],
group: "foo",
image: "linode/ubuntu18.04",
label: "simple_instance",
privateIp: true,
region: "us-central",
rootPass: "terr4form-test",
swapSize: 256,
tags: ["foo"],
type: "g6-standard-1",
});
resources:
web:
type: linode:Instance
properties:
authorizedKeys:
- ssh-rsa AAAA...Gw== user@example.local
group: foo
image: linode/ubuntu18.04
label: simple_instance
privateIp: true
region: us-central
rootPass: terr4form-test
swapSize: 256
tags:
- foo
type: g6-standard-1
Create Instance Resource
new Instance(name: string, args: InstanceArgs, opts?: CustomResourceOptions);
@overload
def Instance(resource_name: 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_enabled: Optional[bool] = None,
boot_config_label: Optional[str] = None,
booted: Optional[bool] = None,
configs: Optional[Sequence[InstanceConfigArgs]] = None,
disks: Optional[Sequence[InstanceDiskArgs]] = None,
group: Optional[str] = None,
image: Optional[str] = None,
interfaces: Optional[Sequence[InstanceInterfaceArgs]] = None,
label: Optional[str] = None,
metadatas: Optional[Sequence[InstanceMetadataArgs]] = None,
private_ip: Optional[bool] = None,
region: Optional[str] = None,
resize_disk: Optional[bool] = None,
root_pass: Optional[str] = None,
shared_ipv4s: Optional[Sequence[str]] = None,
stackscript_data: Optional[Mapping[str, Any]] = None,
stackscript_id: Optional[int] = None,
swap_size: Optional[int] = None,
tags: Optional[Sequence[str]] = None,
type: Optional[str] = None,
watchdog_enabled: Optional[bool] = None)
@overload
def Instance(resource_name: str,
args: InstanceArgs,
opts: Optional[ResourceOptions] = 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.
- 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.
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
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
forces the creation of a new Linode Instance..- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- Configs
List<Instance
Config> Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- Disks
List<Instance
Disk> The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- Group string
The display group of the Linode instance.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- 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.
- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- Stackscript
Data Dictionary<string, object> 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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
forces the creation of a new Linode Instance..- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- []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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- Configs
[]Instance
Config Args Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- Disks
[]Instance
Disk Type Args The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- Group string
The display group of the Linode instance.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- 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.
- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- []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.
- Stackscript
Data map[string]interface{} 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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
forces the creation of a new Linode Instance..- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- configs
List<Instance
Config> Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- disks
List<Instance
Disk> The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- group String
The display group of the Linode instance.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- 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.
- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- stackscript
Data Map<String,Object> 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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
forces the creation of a new Linode Instance..- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- configs
Instance
Config[] Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- disks
Instance
Disk[] The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- group string
The display group of the Linode instance.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- 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.
- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- stackscript
Data {[key: string]: any} 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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
forces the creation of a new Linode Instance..- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- configs
Sequence[Instance
Config Args] Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- disks
Sequence[Instance
Disk Args] The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- group str
The display group of the Linode instance.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- 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.
- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- stackscript_
data Mapping[str, Any] 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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
forces the creation of a new Linode Instance..- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- configs List<Property Map>
Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- disks List<Property Map>
The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- group String
The display group of the Linode instance.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- 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.
- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- stackscript
Data Map<Any> 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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.
- Has
User boolData Whether or not 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.
- 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.- 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.
- Has
User boolData Whether or not 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.
- 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.- 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.
- has
User BooleanData Whether or not 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.
- 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.- 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.
- has
User booleanData Whether or not 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.
- 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.- 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.
- has_
user_ booldata Whether or not 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.
- 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.- 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.
- has
User BooleanData Whether or not 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.
- 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.- 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,
configs: Optional[Sequence[InstanceConfigArgs]] = None,
disks: Optional[Sequence[InstanceDiskArgs]] = 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,
metadatas: Optional[Sequence[InstanceMetadataArgs]] = 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, Any]] = 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- Configs
List<Instance
Config> Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- Disks
List<Instance
Disk> The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- Group string
The display group of the Linode instance.
- Has
User boolData Whether or not 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- Metadatas
List<Instance
Metadata> Various fields related to the Linode Metadata service.
- 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
forces the creation of a new Linode Instance..- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- Specs
Instance
Specs Information about the resources available to this Linode.
- Stackscript
Data Dictionary<string, object> 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- []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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- Configs
[]Instance
Config Args Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- Disks
[]Instance
Disk Type Args The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- Group string
The display group of the Linode instance.
- Has
User boolData Whether or not 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- Metadatas
[]Instance
Metadata Args Various fields related to the Linode Metadata service.
- 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
forces the creation of a new Linode Instance..- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- []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.
- Specs
Instance
Specs Args Information about the resources available to this Linode.
- Stackscript
Data map[string]interface{} 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- configs
List<Instance
Config> Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- disks
List<Instance
Disk> The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- group String
The display group of the Linode instance.
- has
User BooleanData Whether or not 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- metadatas
List<Instance
Metadata> Various fields related to the Linode Metadata service.
- 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
forces the creation of a new Linode Instance..- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- specs
Instance
Specs Information about the resources available to this Linode.
- stackscript
Data Map<String,Object> 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- configs
Instance
Config[] Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- disks
Instance
Disk[] The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- group string
The display group of the Linode instance.
- has
User booleanData Whether or not 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- metadatas
Instance
Metadata[] Various fields related to the Linode Metadata service.
- 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
forces the creation of a new Linode Instance..- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- specs
Instance
Specs Information about the resources available to this Linode.
- stackscript
Data {[key: string]: any} 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- configs
Sequence[Instance
Config Args] Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- disks
Sequence[Instance
Disk Args] The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- group str
The display group of the Linode instance.
- has_
user_ booldata Whether or not 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- metadatas
Sequence[Instance
Metadata Args] Various fields related to the Linode Metadata service.
- 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
forces the creation of a new Linode Instance..- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- specs
Instance
Specs Args Information about the resources available to this Linode.
- stackscript_
data Mapping[str, Any] 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
backup_id
forces the creation of a new Linode Instance.- 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. If there is only one
config
, thelabel
of thatconfig
will be used as theboot_config_label
. This value can not be imported.- 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.
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.
- configs List<Property Map>
Configuration profiles define the VM settings and boot behavior of the Linode Instance.
The embedded config is deprecated and scheduled to be removed in the next major version.Please consider migrating it to linode_instance_config resource.
- disks List<Property Map>
The embedded disk block in linode_instance resource is deprecated and scheduled to be removed in the next major version. Please consider migrating it to be the linode_instance_disk resource.
- group String
The display group of the Linode instance.
- has
User BooleanData Whether or not 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- 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.
- metadatas List<Property Map>
Various fields related to the Linode Metadata service.
- 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
forces the creation of a new Linode Instance..- 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 initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- 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.
- specs Property Map
Information about the resources available to this Linode.
- stackscript
Data Map<Any> 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.- 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 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
- Io int
- Network
In int - Network
Out int - Transfer
Quota int
- Cpu int
- Io int
- Network
In int - Network
Out int - Transfer
Quota int
- cpu Integer
- io Integer
- network
In Integer - network
Out Integer - transfer
Quota Integer
- cpu number
- io number
- network
In number - network
Out number - transfer
Quota number
- cpu int
- io int
- network_
in int - network_
out int - transfer_
quota int
- cpu Number
- io Number
- network
In Number - network
Out Number - transfer
Quota Number
InstanceBackups, InstanceBackupsArgs
- Available bool
- Enabled bool
If this Linode has the Backup service enabled.
- Schedule
Instance
Backups Schedule
- Available bool
- Enabled bool
If this Linode has the Backup service enabled.
- Schedule
Instance
Backups Schedule
- available Boolean
- enabled Boolean
If this Linode has the Backup service enabled.
- schedule
Instance
Backups Schedule
- available boolean
- enabled boolean
If this Linode has the Backup service enabled.
- schedule
Instance
Backups Schedule
- available bool
- enabled bool
If this Linode has the Backup service enabled.
- schedule
Instance
Backups Schedule
- available Boolean
- 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
Arbitrary user comments about this
config
.- Devices
Instance
Config Devices A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted.- Helpers
Instance
Config Helpers Helpers enabled when booting to this Linode Config.
- Interfaces
List<Instance
Config Interface> - Kernel string
A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs).- Memory
Limit int Defaults to the total RAM of the Linode
interface
- (Optional) A list of network interfaces to be assigned to the Linode.
- Root
Device string The root device to boot. The corresponding disk must be attached to a
device
slot. Example:"/dev/sda"
- 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
Arbitrary user comments about this
config
.- Devices
Instance
Config Devices A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted.- Helpers
Instance
Config Helpers Helpers enabled when booting to this Linode Config.
- Interfaces
[]Instance
Config Interface - Kernel string
A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs).- Memory
Limit int Defaults to the total RAM of the Linode
interface
- (Optional) A list of network interfaces to be assigned to the Linode.
- Root
Device string The root device to boot. The corresponding disk must be attached to a
device
slot. Example:"/dev/sda"
- 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
Arbitrary user comments about this
config
.- devices
Instance
Config Devices A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted.- helpers
Instance
Config Helpers Helpers enabled when booting to this Linode Config.
- interfaces
List<Instance
Config Interface> - kernel String
A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs).- memory
Limit Integer Defaults to the total RAM of the Linode
interface
- (Optional) A list of network interfaces to be assigned to the Linode.
- root
Device String The root device to boot. The corresponding disk must be attached to a
device
slot. Example:"/dev/sda"
- 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
Arbitrary user comments about this
config
.- devices
Instance
Config Devices A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted.- helpers
Instance
Config Helpers Helpers enabled when booting to this Linode Config.
- interfaces
Instance
Config Interface[] - kernel string
A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs).- memory
Limit number Defaults to the total RAM of the Linode
interface
- (Optional) A list of network interfaces to be assigned to the Linode.
- root
Device string The root device to boot. The corresponding disk must be attached to a
device
slot. Example:"/dev/sda"
- 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
Arbitrary user comments about this
config
.- devices
Instance
Config Devices A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted.- helpers
Instance
Config Helpers Helpers enabled when booting to this Linode Config.
- interfaces
Sequence[Instance
Config Interface] - kernel str
A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs).- memory_
limit int Defaults to the total RAM of the Linode
interface
- (Optional) A list of network interfaces to be assigned to the Linode.
- root_
device str The root device to boot. The corresponding disk must be attached to a
device
slot. Example:"/dev/sda"
- 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
Arbitrary user comments about this
config
.- devices Property Map
A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted.- helpers Property Map
Helpers enabled when booting to this Linode Config.
- interfaces List<Property Map>
- kernel String
A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs).- memory
Limit Number Defaults to the total RAM of the Linode
interface
- (Optional) A list of network interfaces to be assigned to the Linode.
- root
Device String The root device to boot. The corresponding disk must be attached to a
device
slot. Example:"/dev/sda"
- 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_label
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 - Sdc
Instance
Config Devices Sdc - Sdd
Instance
Config Devices Sdd - Sde
Instance
Config Devices Sde - Sdf
Instance
Config Devices Sdf - Sdg
Instance
Config Devices Sdg - Sdh
Instance
Config Devices Sdh
- 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_label
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 - Sdc
Instance
Config Devices Sdc - Sdd
Instance
Config Devices Sdd - Sde
Instance
Config Devices Sde - Sdf
Instance
Config Devices Sdf - Sdg
Instance
Config Devices Sdg - Sdh
Instance
Config Devices Sdh
- 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_label
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 - sdc
Instance
Config Devices Sdc - sdd
Instance
Config Devices Sdd - sde
Instance
Config Devices Sde - sdf
Instance
Config Devices Sdf - sdg
Instance
Config Devices Sdg - sdh
Instance
Config Devices Sdh
- 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_label
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 - sdc
Instance
Config Devices Sdc - sdd
Instance
Config Devices Sdd - sde
Instance
Config Devices Sde - sdf
Instance
Config Devices Sdf - sdg
Instance
Config Devices Sdg - sdh
Instance
Config Devices Sdh
- 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_label
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 - sdc
Instance
Config Devices Sdc - sdd
Instance
Config Devices Sdd - sde
Instance
Config Devices Sde - sdf
Instance
Config Devices Sdf - sdg
Instance
Config Devices Sdg - sdh
Instance
Config Devices Sdh
- 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_label
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
.- sdb Property Map
- sdc Property Map
- sdd Property Map
- sde Property Map
- sdf Property Map
- sdg Property Map
- sdh Property Map
InstanceConfigDevicesSda, InstanceConfigDevicesSdaArgs
- disk_
id int The Disk ID of the associated
disk_label
, if used.- disk_
label str The
label
of thedisk
to map to thisdevice
slot.- volume_
id int The Volume ID to map to this
device
slot.
InstanceConfigDevicesSdb, InstanceConfigDevicesSdbArgs
- disk_
id int The Disk ID of the associated
disk_label
, if used.- disk_
label str The
label
of thedisk
to map to thisdevice
slot.- volume_
id int The Volume ID to map to this
device
slot.
InstanceConfigDevicesSdc, InstanceConfigDevicesSdcArgs
- disk_
id int The Disk ID of the associated
disk_label
, if used.- disk_
label str The
label
of thedisk
to map to thisdevice
slot.- volume_
id int The Volume ID to map to this
device
slot.
InstanceConfigDevicesSdd, InstanceConfigDevicesSddArgs
- disk_
id int The Disk ID of the associated
disk_label
, if used.- disk_
label str The
label
of thedisk
to map to thisdevice
slot.- volume_
id int The Volume ID to map to this
device
slot.
InstanceConfigDevicesSde, InstanceConfigDevicesSdeArgs
- disk_
id int The Disk ID of the associated
disk_label
, if used.- disk_
label str The
label
of thedisk
to map to thisdevice
slot.- volume_
id int The Volume ID to map to this
device
slot.
InstanceConfigDevicesSdf, InstanceConfigDevicesSdfArgs
- disk_
id int The Disk ID of the associated
disk_label
, if used.- disk_
label str The
label
of thedisk
to map to thisdevice
slot.- volume_
id int The Volume ID to map to this
device
slot.
InstanceConfigDevicesSdg, InstanceConfigDevicesSdgArgs
- disk_
id int The Disk ID of the associated
disk_label
, if used.- disk_
label str The
label
of thedisk
to map to thisdevice
slot.- volume_
id int The Volume ID to map to this
device
slot.
InstanceConfigDevicesSdh, InstanceConfigDevicesSdhArgs
- disk_
id int The Disk ID of the associated
disk_label
, if used.- disk_
label str The
label
of thedisk
to map to thisdevice
slot.- volume_
id int The Volume ID to map to this
device
slot.
InstanceConfigHelpers, InstanceConfigHelpersArgs
- Devtmpfs
Automount bool - 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 - 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 - 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 - 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 - 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 - 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
- Ipam
Address string This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- Label string
The name of this interface. If the interface is a VLAN, a label is required.
- Purpose string
The type of interface. (
public
,vlan
)
- Ipam
Address string This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- Label string
The name of this interface. If the interface is a VLAN, a label is required.
- Purpose string
The type of interface. (
public
,vlan
)
- ipam
Address String This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- label String
The name of this interface. If the interface is a VLAN, a label is required.
- purpose String
The type of interface. (
public
,vlan
)
- ipam
Address string This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- label string
The name of this interface. If the interface is a VLAN, a label is required.
- purpose string
The type of interface. (
public
,vlan
)
- ipam_
address str This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- label str
The name of this interface. If the interface is a VLAN, a label is required.
- purpose str
The type of interface. (
public
,vlan
)
- ipam
Address String This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- label String
The name of this interface. If the interface is a VLAN, a label is required.
- purpose String
The type of interface. (
public
,vlan
)
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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- Filesystem string
The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider).- Id int
The ID of the disk in the Linode API.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- Read
Only bool If true, this Disk is read-only.
- Root
Pass string The initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- Stackscript
Data Dictionary<string, object> 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.
- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- []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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- Filesystem string
The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider).- Id int
The ID of the disk in the Linode API.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- Read
Only bool If true, this Disk is read-only.
- Root
Pass string The initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- Stackscript
Data map[string]interface{} 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.
- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- filesystem String
The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider).- id Integer
The ID of the disk in the Linode API.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- read
Only Boolean If true, this Disk is read-only.
- root
Pass String The initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- stackscript
Data Map<String,Object> 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.
- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- filesystem string
The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider).- id number
The ID of the disk in the Linode API.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- read
Only boolean If true, this Disk is read-only.
- root
Pass string The initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- stackscript
Data {[key: string]: any} 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.
- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- filesystem str
The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider).- id int
The ID of the disk in the Linode API.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- read_
only bool If true, this Disk is read-only.
- root_
pass str The initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- stackscript_
data Mapping[str, Any] 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.
- 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. This value can not be imported. Changing
authorized_keys
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changingauthorized_users
forces the creation of a new Linode Instance.- filesystem String
The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider).- id Number
The ID of the disk in the Linode API.
- 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. Examples arelinode/debian9
,linode/fedora28
,linode/ubuntu16.04lts
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance.- read
Only Boolean If true, this Disk is read-only.
- root
Pass String The initial password for the
root
user account. This value can not be imported. Changingroot_pass
forces the creation of a new Linode Instance. If omitted, a random password will be generated but will not be stored in the state.- stackscript
Data Map<Any> 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. This value can not be imported. Changing
stackscript_data
forces the creation of a new Linode Instance.- 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. This value can not be imported. Changing
stackscript_id
forces the creation of a new Linode Instance.
InstanceInterface, InstanceInterfaceArgs
- Ipam
Address string This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- Label string
The name of this interface. If the interface is a VLAN, a label is required.
- Purpose string
The type of interface. (
public
,vlan
)
- Ipam
Address string This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- Label string
The name of this interface. If the interface is a VLAN, a label is required.
- Purpose string
The type of interface. (
public
,vlan
)
- ipam
Address String This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- label String
The name of this interface. If the interface is a VLAN, a label is required.
- purpose String
The type of interface. (
public
,vlan
)
- ipam
Address string This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- label string
The name of this interface. If the interface is a VLAN, a label is required.
- purpose string
The type of interface. (
public
,vlan
)
- ipam_
address str This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- label str
The name of this interface. If the interface is a VLAN, a label is required.
- purpose str
The type of interface. (
public
,vlan
)
- ipam
Address String This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation.
- label String
The name of this interface. If the interface is a VLAN, a label is required.
- purpose String
The type of interface. (
public
,vlan
)
InstanceMetadata, InstanceMetadataArgs
- User
Data string
- User
Data string
- user
Data String
- user
Data string
- user_
data str
- user
Data String
InstanceSpecs, InstanceSpecsArgs
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. The Linode Guide, Import Existing Infrastructure to Terraform, offers resource importing examples for Instances and other Linode resource types.
Package Details
- Repository
- Linode pulumi/pulumi-linode
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
linode
Terraform Provider.