1. Packages
  2. Linode
  3. API Docs
  4. Instance
Linode v4.7.0 published on Friday, Sep 29, 2023 by Pulumi

linode.Instance

Explore with Pulumi AI

linode logo
Linode v4.7.0 published on Friday, Sep 29, 2023 by Pulumi

    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. Changing region forces the creation of a new Linode Instance..

    Alerts InstanceAlerts

    Configuration options for alert triggers on this Linode.

    AuthorizedKeys 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.

    AuthorizedUsers 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. Changing authorized_users forces the creation of a new Linode Instance.

    BackupId 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.

    BackupsEnabled 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.

    BootConfigLabel string

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    Configs List<InstanceConfig>

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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<InstanceDisk>

    Deprecated:

    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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    Interfaces List<InstanceInterface>

    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<InstanceMetadata>

    Various fields related to the Linode Metadata service.

    PrivateIp 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.

    ResizeDisk 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.

    RootPass string

    The initial password for the root user account. This value can not be imported. Changing root_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.

    SharedIpv4s 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.

    StackscriptData 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.

    StackscriptId 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.

    SwapSize 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.

    Tags 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.


    WatchdogEnabled 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. Changing region forces the creation of a new Linode Instance..

    Alerts InstanceAlertsArgs

    Configuration options for alert triggers on this Linode.

    AuthorizedKeys []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.

    AuthorizedUsers []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. Changing authorized_users forces the creation of a new Linode Instance.

    BackupId 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.

    BackupsEnabled 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.

    BootConfigLabel string

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    Configs []InstanceConfigArgs

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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 []InstanceDiskTypeArgs

    Deprecated:

    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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    Interfaces []InstanceInterfaceArgs

    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 []InstanceMetadataArgs

    Various fields related to the Linode Metadata service.

    PrivateIp 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.

    ResizeDisk 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.

    RootPass string

    The initial password for the root user account. This value can not be imported. Changing root_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.

    SharedIpv4s []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.

    StackscriptData 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.

    StackscriptId 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.

    SwapSize 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.

    Tags []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.


    WatchdogEnabled 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. Changing region forces the creation of a new Linode Instance..

    alerts InstanceAlerts

    Configuration options for alert triggers on this Linode.

    authorizedKeys 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.

    authorizedUsers 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. Changing authorized_users forces the creation of a new Linode Instance.

    backupId 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.

    backupsEnabled 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.

    bootConfigLabel String

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    configs List<InstanceConfig>

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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<InstanceDisk>

    Deprecated:

    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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    interfaces List<InstanceInterface>

    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<InstanceMetadata>

    Various fields related to the Linode Metadata service.

    privateIp 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.

    resizeDisk 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.

    rootPass String

    The initial password for the root user account. This value can not be imported. Changing root_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.

    sharedIpv4s 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.

    stackscriptData 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.

    stackscriptId 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.

    swapSize 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.

    tags 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.


    watchdogEnabled 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. Changing region forces the creation of a new Linode Instance..

    alerts InstanceAlerts

    Configuration options for alert triggers on this Linode.

    authorizedKeys 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.

    authorizedUsers 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. Changing authorized_users forces the creation of a new Linode Instance.

    backupId 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.

    backupsEnabled 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.

    bootConfigLabel string

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    configs InstanceConfig[]

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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 InstanceDisk[]

    Deprecated:

    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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    interfaces InstanceInterface[]

    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 InstanceMetadata[]

    Various fields related to the Linode Metadata service.

    privateIp 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.

    resizeDisk 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.

    rootPass string

    The initial password for the root user account. This value can not be imported. Changing root_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.

    sharedIpv4s 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.

    stackscriptData {[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.

    stackscriptId 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.

    swapSize 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.

    tags 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.


    watchdogEnabled 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. Changing region forces the creation of a new Linode Instance..

    alerts InstanceAlertsArgs

    Configuration options for alert triggers on this Linode.

    authorized_keys 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.

    authorized_users 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. Changing authorized_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_label str

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    configs Sequence[InstanceConfigArgs]

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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[InstanceDiskArgs]

    Deprecated:

    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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    interfaces Sequence[InstanceInterfaceArgs]

    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[InstanceMetadataArgs]

    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. Changing root_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.

    shared_ipv4s 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.

    tags 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. Changing region forces the creation of a new Linode Instance..

    alerts Property Map

    Configuration options for alert triggers on this Linode.

    authorizedKeys 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.

    authorizedUsers 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. Changing authorized_users forces the creation of a new Linode Instance.

    backupId 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.

    backupsEnabled 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.

    bootConfigLabel String

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    configs List<Property Map>

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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>

    Deprecated:

    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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image 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.

    privateIp 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.

    resizeDisk 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.

    rootPass String

    The initial password for the root user account. This value can not be imported. Changing root_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.

    sharedIpv4s 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.

    stackscriptData 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.

    stackscriptId 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.

    swapSize 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.

    tags 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.


    watchdogEnabled 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 InstanceBackups

    Information about this Linode's backups status.

    HasUserData bool

    Whether or not this Instance was created with user-data.

    HostUuid string

    The Linode’s host machine, as a UUID.

    Id string

    The provider-assigned unique ID for this managed resource.

    IpAddress 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.

    PrivateIpAddress string

    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 InstanceSpecs

    Information about the resources available to this Linode.

    Status string

    The status of the instance, indicating the current readiness state. (running, offline, ...)

    Backups InstanceBackups

    Information about this Linode's backups status.

    HasUserData bool

    Whether or not this Instance was created with user-data.

    HostUuid string

    The Linode’s host machine, as a UUID.

    Id string

    The provider-assigned unique ID for this managed resource.

    IpAddress 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.

    PrivateIpAddress string

    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 InstanceSpecs

    Information about the resources available to this Linode.

    Status string

    The status of the instance, indicating the current readiness state. (running, offline, ...)

    backups InstanceBackups

    Information about this Linode's backups status.

    hasUserData Boolean

    Whether or not this Instance was created with user-data.

    hostUuid String

    The Linode’s host machine, as a UUID.

    id String

    The provider-assigned unique ID for this managed resource.

    ipAddress 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.

    privateIpAddress String

    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 InstanceSpecs

    Information about the resources available to this Linode.

    status String

    The status of the instance, indicating the current readiness state. (running, offline, ...)

    backups InstanceBackups

    Information about this Linode's backups status.

    hasUserData boolean

    Whether or not this Instance was created with user-data.

    hostUuid string

    The Linode’s host machine, as a UUID.

    id string

    The provider-assigned unique ID for this managed resource.

    ipAddress 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.

    privateIpAddress string

    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 InstanceSpecs

    Information about the resources available to this Linode.

    status string

    The status of the instance, indicating the current readiness state. (running, offline, ...)

    backups InstanceBackups

    Information about this Linode's backups status.

    has_user_data bool

    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_address str

    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 InstanceSpecs

    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.

    hasUserData Boolean

    Whether or not this Instance was created with user-data.

    hostUuid String

    The Linode’s host machine, as a UUID.

    id String

    The provider-assigned unique ID for this managed resource.

    ipAddress 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.

    privateIpAddress String

    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.
    The following state arguments are supported:
    Alerts InstanceAlerts

    Configuration options for alert triggers on this Linode.

    AuthorizedKeys 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.

    AuthorizedUsers 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. Changing authorized_users forces the creation of a new Linode Instance.

    BackupId 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 InstanceBackups

    Information about this Linode's backups status.

    BackupsEnabled 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.

    BootConfigLabel string

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    Configs List<InstanceConfig>

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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<InstanceDisk>

    Deprecated:

    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.

    HasUserData bool

    Whether or not this Instance was created with user-data.

    HostUuid 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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    Interfaces List<InstanceInterface>

    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.

    IpAddress 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<InstanceMetadata>

    Various fields related to the Linode Metadata service.

    PrivateIp 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.

    PrivateIpAddress string

    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. Changing region forces the creation of a new Linode Instance..

    ResizeDisk 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.

    RootPass string

    The initial password for the root user account. This value can not be imported. Changing root_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.

    SharedIpv4s 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 InstanceSpecs

    Information about the resources available to this Linode.

    StackscriptData 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.

    StackscriptId 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, ...)

    SwapSize 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.

    Tags 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.


    WatchdogEnabled 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 InstanceAlertsArgs

    Configuration options for alert triggers on this Linode.

    AuthorizedKeys []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.

    AuthorizedUsers []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. Changing authorized_users forces the creation of a new Linode Instance.

    BackupId 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 InstanceBackupsArgs

    Information about this Linode's backups status.

    BackupsEnabled 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.

    BootConfigLabel string

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    Configs []InstanceConfigArgs

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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 []InstanceDiskTypeArgs

    Deprecated:

    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.

    HasUserData bool

    Whether or not this Instance was created with user-data.

    HostUuid 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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    Interfaces []InstanceInterfaceArgs

    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.

    IpAddress 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 []InstanceMetadataArgs

    Various fields related to the Linode Metadata service.

    PrivateIp 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.

    PrivateIpAddress string

    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. Changing region forces the creation of a new Linode Instance..

    ResizeDisk 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.

    RootPass string

    The initial password for the root user account. This value can not be imported. Changing root_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.

    SharedIpv4s []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 InstanceSpecsArgs

    Information about the resources available to this Linode.

    StackscriptData 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.

    StackscriptId 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, ...)

    SwapSize 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.

    Tags []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.


    WatchdogEnabled 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 InstanceAlerts

    Configuration options for alert triggers on this Linode.

    authorizedKeys 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.

    authorizedUsers 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. Changing authorized_users forces the creation of a new Linode Instance.

    backupId 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 InstanceBackups

    Information about this Linode's backups status.

    backupsEnabled 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.

    bootConfigLabel String

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    configs List<InstanceConfig>

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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<InstanceDisk>

    Deprecated:

    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.

    hasUserData Boolean

    Whether or not this Instance was created with user-data.

    hostUuid 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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    interfaces List<InstanceInterface>

    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.

    ipAddress 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<InstanceMetadata>

    Various fields related to the Linode Metadata service.

    privateIp 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.

    privateIpAddress String

    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. Changing region forces the creation of a new Linode Instance..

    resizeDisk 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.

    rootPass String

    The initial password for the root user account. This value can not be imported. Changing root_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.

    sharedIpv4s 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 InstanceSpecs

    Information about the resources available to this Linode.

    stackscriptData 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.

    stackscriptId 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, ...)

    swapSize 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.

    tags 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.


    watchdogEnabled 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 InstanceAlerts

    Configuration options for alert triggers on this Linode.

    authorizedKeys 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.

    authorizedUsers 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. Changing authorized_users forces the creation of a new Linode Instance.

    backupId 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 InstanceBackups

    Information about this Linode's backups status.

    backupsEnabled 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.

    bootConfigLabel string

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    configs InstanceConfig[]

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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 InstanceDisk[]

    Deprecated:

    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.

    hasUserData boolean

    Whether or not this Instance was created with user-data.

    hostUuid 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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    interfaces InstanceInterface[]

    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.

    ipAddress 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 InstanceMetadata[]

    Various fields related to the Linode Metadata service.

    privateIp 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.

    privateIpAddress string

    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. Changing region forces the creation of a new Linode Instance..

    resizeDisk 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.

    rootPass string

    The initial password for the root user account. This value can not be imported. Changing root_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.

    sharedIpv4s 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 InstanceSpecs

    Information about the resources available to this Linode.

    stackscriptData {[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.

    stackscriptId 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, ...)

    swapSize 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.

    tags 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.


    watchdogEnabled 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 InstanceAlertsArgs

    Configuration options for alert triggers on this Linode.

    authorized_keys 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.

    authorized_users 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. Changing authorized_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 InstanceBackupsArgs

    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_label str

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    configs Sequence[InstanceConfigArgs]

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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[InstanceDiskArgs]

    Deprecated:

    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_data bool

    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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    interfaces Sequence[InstanceInterfaceArgs]

    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[InstanceMetadataArgs]

    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_address str

    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. Changing region 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. Changing root_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.

    shared_ipv4s 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 InstanceSpecsArgs

    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.

    tags 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.

    authorizedKeys 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.

    authorizedUsers 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. Changing authorized_users forces the creation of a new Linode Instance.

    backupId 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.

    backupsEnabled 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.

    bootConfigLabel String

    The Label of the Instance Config that should be used to boot the Linode instance. If there is only one config, the label of that config will be used as the boot_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 the config block.
    configs List<Property Map>

    Configuration profiles define the VM settings and boot behavior of the Linode Instance.

    Deprecated:

    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>

    Deprecated:

    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.

    hasUserData Boolean

    Whether or not this Instance was created with user-data.

    hostUuid 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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image 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.

    ipAddress 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.

    privateIp 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.

    privateIpAddress String

    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. Changing region forces the creation of a new Linode Instance..

    resizeDisk 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.

    rootPass String

    The initial password for the root user account. This value can not be imported. Changing root_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.

    sharedIpv4s 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.

    stackscriptData 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.

    stackscriptId 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, ...)

    swapSize 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.

    tags 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.


    watchdogEnabled 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 Integer
    io Integer
    networkIn Integer
    networkOut Integer
    transferQuota Integer
    cpu number
    io number
    networkIn number
    networkOut number
    transferQuota number
    cpu Number
    io Number
    networkIn Number
    networkOut Number
    transferQuota Number

    InstanceBackups, InstanceBackupsArgs

    Available bool
    Enabled bool

    If this Linode has the Backup service enabled.

    Schedule InstanceBackupsSchedule
    Available bool
    Enabled bool

    If this Linode has the Backup service enabled.

    Schedule InstanceBackupsSchedule
    available Boolean
    enabled Boolean

    If this Linode has the Backup service enabled.

    schedule InstanceBackupsSchedule
    available boolean
    enabled boolean

    If this Linode has the Backup service enabled.

    schedule InstanceBackupsSchedule
    available bool
    enabled bool

    If this Linode has the Backup service enabled.

    schedule InstanceBackupsSchedule
    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 InstanceConfigDevices

    A list of disk or volume attachments for this config. If the boot_config_label omits a devices block, the Linode will not be booted.

    Helpers InstanceConfigHelpers

    Helpers enabled when booting to this Linode Config.

    Interfaces List<InstanceConfigInterface>
    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).

    MemoryLimit int

    Defaults to the total RAM of the Linode

    • interface - (Optional) A list of network interfaces to be assigned to the Linode.
    RootDevice string

    The root device to boot. The corresponding disk must be attached to a device slot. Example: "/dev/sda"

    RunLevel string

    Defines the state of your Linode after booting. Defaults to "default".

    VirtMode 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 InstanceConfigDevices

    A list of disk or volume attachments for this config. If the boot_config_label omits a devices block, the Linode will not be booted.

    Helpers InstanceConfigHelpers

    Helpers enabled when booting to this Linode Config.

    Interfaces []InstanceConfigInterface
    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).

    MemoryLimit int

    Defaults to the total RAM of the Linode

    • interface - (Optional) A list of network interfaces to be assigned to the Linode.
    RootDevice string

    The root device to boot. The corresponding disk must be attached to a device slot. Example: "/dev/sda"

    RunLevel string

    Defines the state of your Linode after booting. Defaults to "default".

    VirtMode 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 InstanceConfigDevices

    A list of disk or volume attachments for this config. If the boot_config_label omits a devices block, the Linode will not be booted.

    helpers InstanceConfigHelpers

    Helpers enabled when booting to this Linode Config.

    interfaces List<InstanceConfigInterface>
    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).

    memoryLimit Integer

    Defaults to the total RAM of the Linode

    • interface - (Optional) A list of network interfaces to be assigned to the Linode.
    rootDevice String

    The root device to boot. The corresponding disk must be attached to a device slot. Example: "/dev/sda"

    runLevel String

    Defines the state of your Linode after booting. Defaults to "default".

    virtMode 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 InstanceConfigDevices

    A list of disk or volume attachments for this config. If the boot_config_label omits a devices block, the Linode will not be booted.

    helpers InstanceConfigHelpers

    Helpers enabled when booting to this Linode Config.

    interfaces InstanceConfigInterface[]
    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).

    memoryLimit number

    Defaults to the total RAM of the Linode

    • interface - (Optional) A list of network interfaces to be assigned to the Linode.
    rootDevice string

    The root device to boot. The corresponding disk must be attached to a device slot. Example: "/dev/sda"

    runLevel string

    Defines the state of your Linode after booting. Defaults to "default".

    virtMode 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 InstanceConfigDevices

    A list of disk or volume attachments for this config. If the boot_config_label omits a devices block, the Linode will not be booted.

    helpers InstanceConfigHelpers

    Helpers enabled when booting to this Linode Config.

    interfaces Sequence[InstanceConfigInterface]
    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 or volume attachments for this config. If the boot_config_label omits a devices 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).

    memoryLimit Number

    Defaults to the total RAM of the Linode

    • interface - (Optional) A list of network interfaces to be assigned to the Linode.
    rootDevice String

    The root device to boot. The corresponding disk must be attached to a device slot. Example: "/dev/sda"

    runLevel String

    Defines the state of your Linode after booting. Defaults to "default".

    virtMode String

    Controls the virtualization mode. Defaults to "paravirt".

    InstanceConfigDevices, InstanceConfigDevicesArgs

    Sda InstanceConfigDevicesSda

    ... 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 by disk_label or volume_id. Only one disk identifier is permitted per slot. Devices mapped from sde through sdh are unavailable in "fullvirt" virt_mode.

    Sdb InstanceConfigDevicesSdb
    Sdc InstanceConfigDevicesSdc
    Sdd InstanceConfigDevicesSdd
    Sde InstanceConfigDevicesSde
    Sdf InstanceConfigDevicesSdf
    Sdg InstanceConfigDevicesSdg
    Sdh InstanceConfigDevicesSdh
    Sda InstanceConfigDevicesSda

    ... 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 by disk_label or volume_id. Only one disk identifier is permitted per slot. Devices mapped from sde through sdh are unavailable in "fullvirt" virt_mode.

    Sdb InstanceConfigDevicesSdb
    Sdc InstanceConfigDevicesSdc
    Sdd InstanceConfigDevicesSdd
    Sde InstanceConfigDevicesSde
    Sdf InstanceConfigDevicesSdf
    Sdg InstanceConfigDevicesSdg
    Sdh InstanceConfigDevicesSdh
    sda InstanceConfigDevicesSda

    ... 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 by disk_label or volume_id. Only one disk identifier is permitted per slot. Devices mapped from sde through sdh are unavailable in "fullvirt" virt_mode.

    sdb InstanceConfigDevicesSdb
    sdc InstanceConfigDevicesSdc
    sdd InstanceConfigDevicesSdd
    sde InstanceConfigDevicesSde
    sdf InstanceConfigDevicesSdf
    sdg InstanceConfigDevicesSdg
    sdh InstanceConfigDevicesSdh
    sda InstanceConfigDevicesSda

    ... 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 by disk_label or volume_id. Only one disk identifier is permitted per slot. Devices mapped from sde through sdh are unavailable in "fullvirt" virt_mode.

    sdb InstanceConfigDevicesSdb
    sdc InstanceConfigDevicesSdc
    sdd InstanceConfigDevicesSdd
    sde InstanceConfigDevicesSde
    sdf InstanceConfigDevicesSdf
    sdg InstanceConfigDevicesSdg
    sdh InstanceConfigDevicesSdh
    sda InstanceConfigDevicesSda

    ... 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 by disk_label or volume_id. Only one disk identifier is permitted per slot. Devices mapped from sde through sdh are unavailable in "fullvirt" virt_mode.

    sdb InstanceConfigDevicesSdb
    sdc InstanceConfigDevicesSdc
    sdd InstanceConfigDevicesSdd
    sde InstanceConfigDevicesSde
    sdf InstanceConfigDevicesSdf
    sdg InstanceConfigDevicesSdg
    sdh InstanceConfigDevicesSdh
    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 by disk_label or volume_id. Only one disk identifier is permitted per slot. Devices mapped from sde through sdh 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

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    diskId Integer

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Integer

    The Volume ID to map to this device slot.

    diskId number

    The Disk ID of the associated disk_label, if used.

    diskLabel string

    The label of the disk to map to this device slot.

    volumeId number

    The Volume ID to map to this device slot.

    disk_id int

    The Disk ID of the associated disk_label, if used.

    disk_label str

    The label of the disk to map to this device slot.

    volume_id int

    The Volume ID to map to this device slot.

    diskId Number

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Number

    The Volume ID to map to this device slot.

    InstanceConfigDevicesSdb, InstanceConfigDevicesSdbArgs

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    diskId Integer

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Integer

    The Volume ID to map to this device slot.

    diskId number

    The Disk ID of the associated disk_label, if used.

    diskLabel string

    The label of the disk to map to this device slot.

    volumeId number

    The Volume ID to map to this device slot.

    disk_id int

    The Disk ID of the associated disk_label, if used.

    disk_label str

    The label of the disk to map to this device slot.

    volume_id int

    The Volume ID to map to this device slot.

    diskId Number

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Number

    The Volume ID to map to this device slot.

    InstanceConfigDevicesSdc, InstanceConfigDevicesSdcArgs

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    diskId Integer

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Integer

    The Volume ID to map to this device slot.

    diskId number

    The Disk ID of the associated disk_label, if used.

    diskLabel string

    The label of the disk to map to this device slot.

    volumeId number

    The Volume ID to map to this device slot.

    disk_id int

    The Disk ID of the associated disk_label, if used.

    disk_label str

    The label of the disk to map to this device slot.

    volume_id int

    The Volume ID to map to this device slot.

    diskId Number

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Number

    The Volume ID to map to this device slot.

    InstanceConfigDevicesSdd, InstanceConfigDevicesSddArgs

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    diskId Integer

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Integer

    The Volume ID to map to this device slot.

    diskId number

    The Disk ID of the associated disk_label, if used.

    diskLabel string

    The label of the disk to map to this device slot.

    volumeId number

    The Volume ID to map to this device slot.

    disk_id int

    The Disk ID of the associated disk_label, if used.

    disk_label str

    The label of the disk to map to this device slot.

    volume_id int

    The Volume ID to map to this device slot.

    diskId Number

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Number

    The Volume ID to map to this device slot.

    InstanceConfigDevicesSde, InstanceConfigDevicesSdeArgs

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    diskId Integer

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Integer

    The Volume ID to map to this device slot.

    diskId number

    The Disk ID of the associated disk_label, if used.

    diskLabel string

    The label of the disk to map to this device slot.

    volumeId number

    The Volume ID to map to this device slot.

    disk_id int

    The Disk ID of the associated disk_label, if used.

    disk_label str

    The label of the disk to map to this device slot.

    volume_id int

    The Volume ID to map to this device slot.

    diskId Number

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Number

    The Volume ID to map to this device slot.

    InstanceConfigDevicesSdf, InstanceConfigDevicesSdfArgs

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    diskId Integer

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Integer

    The Volume ID to map to this device slot.

    diskId number

    The Disk ID of the associated disk_label, if used.

    diskLabel string

    The label of the disk to map to this device slot.

    volumeId number

    The Volume ID to map to this device slot.

    disk_id int

    The Disk ID of the associated disk_label, if used.

    disk_label str

    The label of the disk to map to this device slot.

    volume_id int

    The Volume ID to map to this device slot.

    diskId Number

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Number

    The Volume ID to map to this device slot.

    InstanceConfigDevicesSdg, InstanceConfigDevicesSdgArgs

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    diskId Integer

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Integer

    The Volume ID to map to this device slot.

    diskId number

    The Disk ID of the associated disk_label, if used.

    diskLabel string

    The label of the disk to map to this device slot.

    volumeId number

    The Volume ID to map to this device slot.

    disk_id int

    The Disk ID of the associated disk_label, if used.

    disk_label str

    The label of the disk to map to this device slot.

    volume_id int

    The Volume ID to map to this device slot.

    diskId Number

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Number

    The Volume ID to map to this device slot.

    InstanceConfigDevicesSdh, InstanceConfigDevicesSdhArgs

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    DiskId int

    The Disk ID of the associated disk_label, if used.

    DiskLabel string

    The label of the disk to map to this device slot.

    VolumeId int

    The Volume ID to map to this device slot.

    diskId Integer

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Integer

    The Volume ID to map to this device slot.

    diskId number

    The Disk ID of the associated disk_label, if used.

    diskLabel string

    The label of the disk to map to this device slot.

    volumeId number

    The Volume ID to map to this device slot.

    disk_id int

    The Disk ID of the associated disk_label, if used.

    disk_label str

    The label of the disk to map to this device slot.

    volume_id int

    The Volume ID to map to this device slot.

    diskId Number

    The Disk ID of the associated disk_label, if used.

    diskLabel String

    The label of the disk to map to this device slot.

    volumeId Number

    The Volume ID to map to this device slot.

    InstanceConfigHelpers, InstanceConfigHelpersArgs

    DevtmpfsAutomount bool
    Distro bool

    Controls the behavior of the Linode Config's Distribution Helper setting.

    ModulesDep 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.

    UpdatedbDisabled bool

    Disables updatedb cron job to avoid disk thrashing.

    DevtmpfsAutomount bool
    Distro bool

    Controls the behavior of the Linode Config's Distribution Helper setting.

    ModulesDep 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.

    UpdatedbDisabled bool

    Disables updatedb cron job to avoid disk thrashing.

    devtmpfsAutomount Boolean
    distro Boolean

    Controls the behavior of the Linode Config's Distribution Helper setting.

    modulesDep 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.

    updatedbDisabled Boolean

    Disables updatedb cron job to avoid disk thrashing.

    devtmpfsAutomount boolean
    distro boolean

    Controls the behavior of the Linode Config's Distribution Helper setting.

    modulesDep 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.

    updatedbDisabled 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.

    devtmpfsAutomount Boolean
    distro Boolean

    Controls the behavior of the Linode Config's Distribution Helper setting.

    modulesDep 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.

    updatedbDisabled Boolean

    Disables updatedb cron job to avoid disk thrashing.

    InstanceConfigInterface, InstanceConfigInterfaceArgs

    IpamAddress 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)

    IpamAddress 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)

    ipamAddress 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)

    ipamAddress 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)

    ipamAddress 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.

    AuthorizedKeys 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.

    AuthorizedUsers 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. Changing authorized_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 config initrd (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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    ReadOnly bool

    If true, this Disk is read-only.

    RootPass string

    The initial password for the root user account. This value can not be imported. Changing root_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.

    StackscriptData 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.

    StackscriptId 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.

    AuthorizedKeys []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.

    AuthorizedUsers []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. Changing authorized_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 config initrd (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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    ReadOnly bool

    If true, this Disk is read-only.

    RootPass string

    The initial password for the root user account. This value can not be imported. Changing root_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.

    StackscriptData 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.

    StackscriptId 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.

    authorizedKeys 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.

    authorizedUsers 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. Changing authorized_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 config initrd (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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    readOnly Boolean

    If true, this Disk is read-only.

    rootPass String

    The initial password for the root user account. This value can not be imported. Changing root_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.

    stackscriptData 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.

    stackscriptId 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.

    authorizedKeys 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.

    authorizedUsers 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. Changing authorized_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 config initrd (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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    readOnly boolean

    If true, this Disk is read-only.

    rootPass string

    The initial password for the root user account. This value can not be imported. Changing root_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.

    stackscriptData {[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.

    stackscriptId 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.

    authorized_keys 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.

    authorized_users 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. Changing authorized_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 config initrd (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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image 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. Changing root_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.

    authorizedKeys 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.

    authorizedUsers 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. Changing authorized_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 config initrd (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 are linode/debian9, linode/fedora28, linode/ubuntu16.04lts, linode/arch, and private/12345. See all images here (Requires a personal access token; docs here). This value can not be imported. Changing image forces the creation of a new Linode Instance.

    readOnly Boolean

    If true, this Disk is read-only.

    rootPass String

    The initial password for the root user account. This value can not be imported. Changing root_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.

    stackscriptData 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.

    stackscriptId 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

    IpamAddress 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)

    IpamAddress 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)

    ipamAddress 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)

    ipamAddress 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)

    ipamAddress 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

    UserData string
    UserData string
    userData String
    userData string
    userData String

    InstanceSpecs, InstanceSpecsArgs

    Disk int
    Memory int
    Transfer int
    Vcpus int
    Disk int
    Memory int
    Transfer int
    Vcpus int
    disk Integer
    memory Integer
    transfer Integer
    vcpus Integer
    disk number
    memory number
    transfer number
    vcpus number
    disk int
    memory int
    transfer int
    vcpus int
    disk Number
    memory Number
    transfer Number
    vcpus Number

    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.

    linode logo
    Linode v4.7.0 published on Friday, Sep 29, 2023 by Pulumi