Linode v4.22.0 published on Tuesday, Jun 25, 2024 by Pulumi
linode.getInstances
Explore with Pulumi AI
Provides information about Linode instances that match a set of filters.
Example Usage
Get information about all Linode instances with a certain label and tag:
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
const my-instances = linode.getInstances({
filters: [
{
name: "label",
values: [
"my-label",
"my-other-label",
],
},
{
name: "tags",
values: ["my-tag"],
},
],
});
export const instanceId = my_instances.then(my_instances => my_instances.instances?.[0]?.id);
import pulumi
import pulumi_linode as linode
my_instances = linode.get_instances(filters=[
linode.GetInstancesFilterArgs(
name="label",
values=[
"my-label",
"my-other-label",
],
),
linode.GetInstancesFilterArgs(
name="tags",
values=["my-tag"],
),
])
pulumi.export("instanceId", my_instances.instances[0].id)
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 {
my_instances, err := linode.GetInstances(ctx, &linode.GetInstancesArgs{
Filters: []linode.GetInstancesFilter{
{
Name: "label",
Values: []string{
"my-label",
"my-other-label",
},
},
{
Name: "tags",
Values: []string{
"my-tag",
},
},
},
}, nil)
if err != nil {
return err
}
ctx.Export("instanceId", my_instances.Instances[0].Id)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
return await Deployment.RunAsync(() =>
{
var my_instances = Linode.GetInstances.Invoke(new()
{
Filters = new[]
{
new Linode.Inputs.GetInstancesFilterInputArgs
{
Name = "label",
Values = new[]
{
"my-label",
"my-other-label",
},
},
new Linode.Inputs.GetInstancesFilterInputArgs
{
Name = "tags",
Values = new[]
{
"my-tag",
},
},
},
});
return new Dictionary<string, object?>
{
["instanceId"] = my_instances.Apply(my_instances => my_instances.Apply(getInstancesResult => getInstancesResult.Instances[0]?.Id)),
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.LinodeFunctions;
import com.pulumi.linode.inputs.GetInstancesArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var my-instances = LinodeFunctions.getInstances(GetInstancesArgs.builder()
.filters(
GetInstancesFilterArgs.builder()
.name("label")
.values(
"my-label",
"my-other-label")
.build(),
GetInstancesFilterArgs.builder()
.name("tags")
.values("my-tag")
.build())
.build());
ctx.export("instanceId", my_instances.instances()[0].id());
}
}
variables:
my-instances:
fn::invoke:
Function: linode:getInstances
Arguments:
filters:
- name: label
values:
- my-label
- my-other-label
- name: tags
values:
- my-tag
outputs:
instanceId: ${["my-instances"].instances[0].id}
Get information about all Linode instances associated with the current token:
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
const all-instances = linode.getInstances({});
export const instanceIds = all_instances.then(all_instances => all_instances.instances.map(__item => __item.id));
import pulumi
import pulumi_linode as linode
all_instances = linode.get_instances()
pulumi.export("instanceIds", [__item.id for __item in all_instances.instances])
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 {
all_instances, err := linode.GetInstances(ctx, nil, nil)
if err != nil {
return err
}
var splat0 []*int
for _, val0 := range all_instances.Instances {
splat0 = append(splat0, val0.Id)
}
ctx.Export("instanceIds", splat0)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
return await Deployment.RunAsync(() =>
{
var all_instances = Linode.GetInstances.Invoke();
return new Dictionary<string, object?>
{
["instanceIds"] = all_instances.Apply(all_instances => all_instances.Apply(getInstancesResult => getInstancesResult.Instances).Select(__item => __item.Id).ToList()),
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.LinodeFunctions;
import com.pulumi.linode.inputs.GetInstancesArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var all-instances = LinodeFunctions.getInstances();
ctx.export("instanceIds", all_instances.instances().stream().map(element -> element.id()).collect(toList()));
}
}
Coming soon!
Filterable Fields
group
id
image
label
region
status
tags
type
watchdog_enabled
Using getInstances
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getInstances(args: GetInstancesArgs, opts?: InvokeOptions): Promise<GetInstancesResult>
function getInstancesOutput(args: GetInstancesOutputArgs, opts?: InvokeOptions): Output<GetInstancesResult>
def get_instances(filters: Optional[Sequence[GetInstancesFilter]] = None,
order: Optional[str] = None,
order_by: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetInstancesResult
def get_instances_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetInstancesFilterArgs]]]] = None,
order: Optional[pulumi.Input[str]] = None,
order_by: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetInstancesResult]
func GetInstances(ctx *Context, args *GetInstancesArgs, opts ...InvokeOption) (*GetInstancesResult, error)
func GetInstancesOutput(ctx *Context, args *GetInstancesOutputArgs, opts ...InvokeOption) GetInstancesResultOutput
> Note: This function is named GetInstances
in the Go SDK.
public static class GetInstances
{
public static Task<GetInstancesResult> InvokeAsync(GetInstancesArgs args, InvokeOptions? opts = null)
public static Output<GetInstancesResult> Invoke(GetInstancesInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetInstancesResult> getInstances(GetInstancesArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: linode:index/getInstances:getInstances
arguments:
# arguments dictionary
The following arguments are supported:
- Filters
List<Get
Instances Filter> - Order string
- The order in which results should be returned. (
asc
,desc
; defaultasc
) - Order
By string - The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
- Filters
[]Get
Instances Filter - Order string
- The order in which results should be returned. (
asc
,desc
; defaultasc
) - Order
By string - The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
- filters
List<Get
Instances Filter> - order String
- The order in which results should be returned. (
asc
,desc
; defaultasc
) - order
By String - The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
- filters
Get
Instances Filter[] - order string
- The order in which results should be returned. (
asc
,desc
; defaultasc
) - order
By string - The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
- filters
Sequence[Get
Instances Filter] - order str
- The order in which results should be returned. (
asc
,desc
; defaultasc
) - order_
by str - The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
- filters List<Property Map>
- order String
- The order in which results should be returned. (
asc
,desc
; defaultasc
) - order
By String - The attribute to order the results by. See the Filterable Fields section for a list of valid fields.
getInstances Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Instances
List<Get
Instances Instance> - Filters
List<Get
Instances Filter> - Order string
- Order
By string
- Id string
- The provider-assigned unique ID for this managed resource.
- Instances
[]Get
Instances Instance - Filters
[]Get
Instances Filter - Order string
- Order
By string
- id String
- The provider-assigned unique ID for this managed resource.
- instances
List<Get
Instances Instance> - filters
List<Get
Instances Filter> - order String
- order
By String
- id string
- The provider-assigned unique ID for this managed resource.
- instances
Get
Instances Instance[] - filters
Get
Instances Filter[] - order string
- order
By string
- id str
- The provider-assigned unique ID for this managed resource.
- instances
Sequence[Get
Instances Instance] - filters
Sequence[Get
Instances Filter] - order str
- order_
by str
- id String
- The provider-assigned unique ID for this managed resource.
- instances List<Property Map>
- filters List<Property Map>
- order String
- order
By String
Supporting Types
GetInstancesFilter
- Name string
- The name of the field to filter by. See the Filterable Fields section for a list of filterable fields.
- Values List<string>
- A list of values for the filter to allow. These values should all be in string form.
- Match
By string - The method to match the field by. (
exact
,regex
,substring
; defaultexact
)
- Name string
- The name of the field to filter by. See the Filterable Fields section for a list of filterable fields.
- Values []string
- A list of values for the filter to allow. These values should all be in string form.
- Match
By string - The method to match the field by. (
exact
,regex
,substring
; defaultexact
)
- name String
- The name of the field to filter by. See the Filterable Fields section for a list of filterable fields.
- values List<String>
- A list of values for the filter to allow. These values should all be in string form.
- match
By String - The method to match the field by. (
exact
,regex
,substring
; defaultexact
)
- name string
- The name of the field to filter by. See the Filterable Fields section for a list of filterable fields.
- values string[]
- A list of values for the filter to allow. These values should all be in string form.
- match
By string - The method to match the field by. (
exact
,regex
,substring
; defaultexact
)
- name str
- The name of the field to filter by. See the Filterable Fields section for a list of filterable fields.
- values Sequence[str]
- A list of values for the filter to allow. These values should all be in string form.
- match_
by str - The method to match the field by. (
exact
,regex
,substring
; defaultexact
)
- name String
- The name of the field to filter by. See the Filterable Fields section for a list of filterable fields.
- values List<String>
- A list of values for the filter to allow. These values should all be in string form.
- match
By String - The method to match the field by. (
exact
,regex
,substring
; defaultexact
)
GetInstancesInstance
- Alerts
Get
Instances Instance Alerts - Backups
List<Get
Instances Instance Backup> - Information about this Linode's backups status.
- Boot
Config stringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- Configs
List<Get
Instances Instance Config> - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- Disks
List<Get
Instances Instance Disk> - Disks associated with this Linode.
- Group string
- The display group of the Linode instance.
- Has
User boolData - Whether this Instance was created with user-data.
- Host
Uuid string - The Linode’s host machine, as a UUID.
- Id int
- The ID of the disk in the Linode API.
- Image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with
private/
. See images for more information on the Images available for you to use. Examples arelinode/debian12
,linode/fedora39
,linode/ubuntu22.04
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance. - Ip
Address string - A string containing the Linode's public IP address.
- Ipv4s List<string>
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Ipv6 string
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Private
Ip stringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- Region string
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. - Specs
List<Get
Instances Instance Spec> - Status string
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - Swap
Size int - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- List<string>
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- Type string
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - Watchdog
Enabled bool - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- Alerts
Get
Instances Instance Alerts - Backups
[]Get
Instances Instance Backup - Information about this Linode's backups status.
- Boot
Config stringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- Configs
[]Get
Instances Instance Config - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- Disks
[]Get
Instances Instance Disk - Disks associated with this Linode.
- Group string
- The display group of the Linode instance.
- Has
User boolData - Whether this Instance was created with user-data.
- Host
Uuid string - The Linode’s host machine, as a UUID.
- Id int
- The ID of the disk in the Linode API.
- Image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with
private/
. See images for more information on the Images available for you to use. Examples arelinode/debian12
,linode/fedora39
,linode/ubuntu22.04
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance. - Ip
Address string - A string containing the Linode's public IP address.
- Ipv4s []string
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Ipv6 string
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Private
Ip stringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- Region string
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. - Specs
[]Get
Instances Instance Spec - Status string
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - Swap
Size int - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- []string
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- Type string
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - Watchdog
Enabled bool - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- alerts
Get
Instances Instance Alerts - backups
List<Get
Instances Instance Backup> - Information about this Linode's backups status.
- boot
Config StringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- configs
List<Get
Instances Instance Config> - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disks
List<Get
Instances Instance Disk> - Disks associated with this Linode.
- group String
- The display group of the Linode instance.
- has
User BooleanData - Whether this Instance was created with user-data.
- host
Uuid String - The Linode’s host machine, as a UUID.
- id Integer
- The ID of the disk in the Linode API.
- image String
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with
private/
. See images for more information on the Images available for you to use. Examples arelinode/debian12
,linode/fedora39
,linode/ubuntu22.04
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance. - ip
Address String - A string containing the Linode's public IP address.
- ipv4s List<String>
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- ipv6 String
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - private
Ip StringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- region String
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. - specs
List<Get
Instances Instance Spec> - status String
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - swap
Size Integer - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- List<String>
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type String
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog
Enabled Boolean - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- alerts
Get
Instances Instance Alerts - backups
Get
Instances Instance Backup[] - Information about this Linode's backups status.
- boot
Config stringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- configs
Get
Instances Instance Config[] - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disks
Get
Instances Instance Disk[] - Disks associated with this Linode.
- group string
- The display group of the Linode instance.
- has
User booleanData - Whether this Instance was created with user-data.
- host
Uuid string - The Linode’s host machine, as a UUID.
- id number
- The ID of the disk in the Linode API.
- image string
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with
private/
. See images for more information on the Images available for you to use. Examples arelinode/debian12
,linode/fedora39
,linode/ubuntu22.04
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance. - ip
Address string - A string containing the Linode's public IP address.
- ipv4s string[]
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- ipv6 string
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - private
Ip stringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- region string
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. - specs
Get
Instances Instance Spec[] - status string
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - swap
Size number - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- string[]
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type string
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog
Enabled boolean - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- alerts
Get
Instances Instance Alerts - backups
Sequence[Get
Instances Instance Backup] - Information about this Linode's backups status.
- boot_
config_ strlabel - The Label of the Instance Config that should be used to boot the Linode instance.
- configs
Sequence[Get
Instances Instance Config] - Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disks
Sequence[Get
Instances Instance Disk] - Disks associated with this Linode.
- group str
- The display group of the Linode instance.
- has_
user_ booldata - Whether this Instance was created with user-data.
- host_
uuid str - The Linode’s host machine, as a UUID.
- id int
- The ID of the disk in the Linode API.
- image str
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with
private/
. See images for more information on the Images available for you to use. Examples arelinode/debian12
,linode/fedora39
,linode/ubuntu22.04
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance. - 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 name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - private_
ip_ straddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- region str
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. - specs
Sequence[Get
Instances Instance Spec] - status str
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - swap_
size int - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- Sequence[str]
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type str
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog_
enabled bool - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
- alerts Property Map
- backups List<Property Map>
- Information about this Linode's backups status.
- boot
Config StringLabel - The Label of the Instance Config that should be used to boot the Linode instance.
- configs List<Property Map>
- Configuration profiles define the VM settings and boot behavior of the Linode Instance.
- disks List<Property Map>
- Disks associated with this Linode.
- group String
- The display group of the Linode instance.
- has
User BooleanData - Whether this Instance was created with user-data.
- host
Uuid String - The Linode’s host machine, as a UUID.
- id Number
- The ID of the disk in the Linode API.
- image String
- An Image ID to deploy the Disk from. Official Linode Images start with linode/, while your Images start with
private/
. See images for more information on the Images available for you to use. Examples arelinode/debian12
,linode/fedora39
,linode/ubuntu22.04
,linode/arch
, andprivate/12345
. See all images here (Requires a personal access token; docs here). This value can not be imported. Changingimage
forces the creation of a new Linode Instance. - ip
Address String - A string containing the Linode's public IP address.
- ipv4s List<String>
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- ipv6 String
- This Linode's IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared. The prefix (
/64
) is included in this attribute. - label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - private
Ip StringAddress - This Linode's Private IPv4 Address, if enabled. The regional private IP address range, 192.168.128.0/17, is shared by all Linode Instances in a region.
- region String
- This is the location where the Linode is deployed. Examples are
"us-east"
,"us-west"
,"ap-south"
, etc. See all regions here. - specs List<Property Map>
- status String
- The status of the instance, indicating the current readiness state. (
running
,offline
, ...) - swap
Size Number - When deploying from an Image, this field is optional with a Linode API default of 512mb, otherwise it is ignored. This is used to set the swap disk size for the newly-created Linode.
- List<String>
- A list of tags applied to this object. Tags are case-insensitive and are for organizational purposes only.
- type String
- The Linode type defines the pricing, CPU, disk, and RAM specs of the instance. Examples are
"g6-nanode-1"
,"g6-standard-2"
,"g6-highmem-16"
,"g6-dedicated-16"
, etc. See all types here. - watchdog
Enabled Boolean - The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
GetInstancesInstanceAlerts
- Cpu int
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- Io int
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- Network
In int - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- Network
Out int - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- Transfer
Quota int - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- Cpu int
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- Io int
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- Network
In int - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- Network
Out int - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- Transfer
Quota int - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- cpu Integer
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- io Integer
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- network
In Integer - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- network
Out Integer - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- transfer
Quota Integer - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- cpu number
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- io number
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- network
In number - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- network
Out number - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- transfer
Quota number - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- cpu int
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- io int
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- network_
in int - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- network_
out int - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- transfer_
quota int - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
- cpu Number
- The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. If this is set to 0, the alert is disabled.
- io Number
- The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0, this alert is disabled.
- network
In Number - The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- network
Out Number - The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0 (zero), the alert is disabled.
- transfer
Quota Number - The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0 (zero), the alert is disabled.
GetInstancesInstanceBackup
- Available bool
- Whether this Backup is available for restoration.
- Enabled bool
- If this Linode has the Backup service enabled.
- Schedules
List<Get
Instances Instance Backup Schedule>
- Available bool
- Whether this Backup is available for restoration.
- Enabled bool
- If this Linode has the Backup service enabled.
- Schedules
[]Get
Instances Instance Backup Schedule
- available Boolean
- Whether this Backup is available for restoration.
- enabled Boolean
- If this Linode has the Backup service enabled.
- schedules
List<Get
Instances Instance Backup Schedule>
- available boolean
- Whether this Backup is available for restoration.
- enabled boolean
- If this Linode has the Backup service enabled.
- schedules
Get
Instances Instance Backup Schedule[]
- available bool
- Whether this Backup is available for restoration.
- enabled bool
- If this Linode has the Backup service enabled.
- schedules
Sequence[Get
Instances Instance Backup Schedule]
- available Boolean
- Whether this Backup is available for restoration.
- enabled Boolean
- If this Linode has the Backup service enabled.
- schedules List<Property Map>
GetInstancesInstanceBackupSchedule
- 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.
GetInstancesInstanceConfig
- Comments string
- Arbitrary user comments about this
config
. - Devices
List<Get
Instances Instance Config Device> - A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted. - Helpers
List<Get
Instances Instance Config Helper> - Helpers enabled when booting to this Linode Config.
- Id int
- The ID of the disk in the Linode API.
- Interfaces
List<Get
Instances Instance Config Interface> - An array of Network Interfaces for this Linode’s Configuration Profile.
- Kernel string
- A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs). - Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Memory
Limit int - Defaults to the total RAM of the Linode
- Root
Device string - The root device to boot.
- Run
Level string - Defines the state of your Linode after booting.
- Virt
Mode string - Controls the virtualization mode.
- Comments string
- Arbitrary user comments about this
config
. - Devices
[]Get
Instances Instance Config Device - A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted. - Helpers
[]Get
Instances Instance Config Helper - Helpers enabled when booting to this Linode Config.
- Id int
- The ID of the disk in the Linode API.
- Interfaces
[]Get
Instances Instance Config Interface - An array of Network Interfaces for this Linode’s Configuration Profile.
- Kernel string
- A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs). - Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Memory
Limit int - Defaults to the total RAM of the Linode
- Root
Device string - The root device to boot.
- Run
Level string - Defines the state of your Linode after booting.
- Virt
Mode string - Controls the virtualization mode.
- comments String
- Arbitrary user comments about this
config
. - devices
List<Get
Instances Instance Config Device> - A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted. - helpers
List<Get
Instances Instance Config Helper> - Helpers enabled when booting to this Linode Config.
- id Integer
- The ID of the disk in the Linode API.
- interfaces
List<Get
Instances Instance Config Interface> - An array of Network Interfaces for this Linode’s Configuration Profile.
- kernel String
- A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs). - label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - memory
Limit Integer - Defaults to the total RAM of the Linode
- root
Device String - The root device to boot.
- run
Level String - Defines the state of your Linode after booting.
- virt
Mode String - Controls the virtualization mode.
- comments string
- Arbitrary user comments about this
config
. - devices
Get
Instances Instance Config Device[] - A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted. - helpers
Get
Instances Instance Config Helper[] - Helpers enabled when booting to this Linode Config.
- id number
- The ID of the disk in the Linode API.
- interfaces
Get
Instances Instance Config Interface[] - An array of Network Interfaces for this Linode’s Configuration Profile.
- kernel string
- A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs). - label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - memory
Limit number - Defaults to the total RAM of the Linode
- root
Device string - The root device to boot.
- run
Level string - Defines the state of your Linode after booting.
- virt
Mode string - Controls the virtualization mode.
- comments str
- Arbitrary user comments about this
config
. - devices
Sequence[Get
Instances Instance Config Device] - A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted. - helpers
Sequence[Get
Instances Instance Config Helper] - Helpers enabled when booting to this Linode Config.
- id int
- The ID of the disk in the Linode API.
- interfaces
Sequence[Get
Instances Instance Config Interface] - An array of Network Interfaces for this Linode’s Configuration Profile.
- kernel str
- A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs). - label str
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - memory_
limit int - Defaults to the total RAM of the Linode
- root_
device str - The root device to boot.
- run_
level str - Defines the state of your Linode after booting.
- virt_
mode str - Controls the virtualization mode.
- comments String
- Arbitrary user comments about this
config
. - devices List<Property Map>
- A list of
disk
orvolume
attachments for thisconfig
. If theboot_config_label
omits adevices
block, the Linode will not be booted. - helpers List<Property Map>
- Helpers enabled when booting to this Linode Config.
- id Number
- The ID of the disk in the Linode API.
- interfaces List<Property Map>
- An array of Network Interfaces for this Linode’s Configuration Profile.
- kernel String
- A Kernel ID to boot a Linode with. Default is based on image choice. Examples are
linode/latest-64bit
,linode/grub2
,linode/direct-disk
, etc. See all kernels here. Note that this is a paginated API endpoint (docs). - label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - memory
Limit Number - Defaults to the total RAM of the Linode
- root
Device String - The root device to boot.
- run
Level String - Defines the state of your Linode after booting.
- virt
Mode String - Controls the virtualization mode.
GetInstancesInstanceConfigDevice
- Sdas
List<Get
Instances Instance Config Device Sda> - ...
sdh
- The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_label
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - Sdbs
List<Get
Instances Instance Config Device Sdb> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdcs
List<Get
Instances Instance Config Device Sdc> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdds
List<Get
Instances Instance Config Device Sdd> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdes
List<Get
Instances Instance Config Device Sde> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdfs
List<Get
Instances Instance Config Device Sdf> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdgs
List<Get
Instances Instance Config Device Sdg> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdhs
List<Get
Instances Instance Config Device Sdh> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdas
[]Get
Instances Instance Config Device Sda - ...
sdh
- The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_label
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - Sdbs
[]Get
Instances Instance Config Device Sdb - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdcs
[]Get
Instances Instance Config Device Sdc - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdds
[]Get
Instances Instance Config Device Sdd - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdes
[]Get
Instances Instance Config Device Sde - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdfs
[]Get
Instances Instance Config Device Sdf - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdgs
[]Get
Instances Instance Config Device Sdg - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- Sdhs
[]Get
Instances Instance Config Device Sdh - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdas
List<Get
Instances Instance Config Device Sda> - ...
sdh
- The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_label
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - sdbs
List<Get
Instances Instance Config Device Sdb> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdcs
List<Get
Instances Instance Config Device Sdc> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdds
List<Get
Instances Instance Config Device Sdd> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdes
List<Get
Instances Instance Config Device Sde> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdfs
List<Get
Instances Instance Config Device Sdf> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdgs
List<Get
Instances Instance Config Device Sdg> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdhs
List<Get
Instances Instance Config Device Sdh> - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdas
Get
Instances Instance Config Device Sda[] - ...
sdh
- The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_label
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - sdbs
Get
Instances Instance Config Device Sdb[] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdcs
Get
Instances Instance Config Device Sdc[] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdds
Get
Instances Instance Config Device Sdd[] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdes
Get
Instances Instance Config Device Sde[] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdfs
Get
Instances Instance Config Device Sdf[] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdgs
Get
Instances Instance Config Device Sdg[] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdhs
Get
Instances Instance Config Device Sdh[] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdas
Sequence[Get
Instances Instance Config Device Sda] - ...
sdh
- The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_label
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - sdbs
Sequence[Get
Instances Instance Config Device Sdb] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdcs
Sequence[Get
Instances Instance Config Device Sdc] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdds
Sequence[Get
Instances Instance Config Device Sdd] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdes
Sequence[Get
Instances Instance Config Device Sde] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdfs
Sequence[Get
Instances Instance Config Device Sdf] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdgs
Sequence[Get
Instances Instance Config Device Sdg] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdhs
Sequence[Get
Instances Instance Config Device Sdh] - Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdas List<Property Map>
- ...
sdh
- The SDA-SDH slots, represent the Linux block device nodes for the first 8 disks attached to the Linode. Each device must be suplied sequentially. The device can be either a Disk or a Volume identified bydisk_label
orvolume_id
. Only one disk identifier is permitted per slot. Devices mapped fromsde
throughsdh
are unavailable in"fullvirt"
virt_mode
. - sdbs List<Property Map>
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdcs List<Property Map>
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdds List<Property Map>
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdes List<Property Map>
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdfs List<Property Map>
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdgs List<Property Map>
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
- sdhs List<Property Map>
- Device can be either a Disk or Volume identified by disk_id or volume_id. Only one type per slot allowed.
GetInstancesInstanceConfigDeviceSda
- disk_
id int - The Disk ID of the associated
disk_label
, if used - disk_
label str - The
label
of thedisk
to map to thisdevice
slot. - volume_
id int - The Volume ID to map to this
device
slot.
GetInstancesInstanceConfigDeviceSdb
- disk_
id int - The Disk ID of the associated
disk_label
, if used - disk_
label str - The
label
of thedisk
to map to thisdevice
slot. - volume_
id int - The Volume ID to map to this
device
slot.
GetInstancesInstanceConfigDeviceSdc
- disk_
id int - The Disk ID of the associated
disk_label
, if used - disk_
label str - The
label
of thedisk
to map to thisdevice
slot. - volume_
id int - The Volume ID to map to this
device
slot.
GetInstancesInstanceConfigDeviceSdd
- disk_
id int - The Disk ID of the associated
disk_label
, if used - disk_
label str - The
label
of thedisk
to map to thisdevice
slot. - volume_
id int - The Volume ID to map to this
device
slot.
GetInstancesInstanceConfigDeviceSde
- disk_
id int - The Disk ID of the associated
disk_label
, if used - disk_
label str - The
label
of thedisk
to map to thisdevice
slot. - volume_
id int - The Volume ID to map to this
device
slot.
GetInstancesInstanceConfigDeviceSdf
- disk_
id int - The Disk ID of the associated
disk_label
, if used - disk_
label str - The
label
of thedisk
to map to thisdevice
slot. - volume_
id int - The Volume ID to map to this
device
slot.
GetInstancesInstanceConfigDeviceSdg
- disk_
id int - The Disk ID of the associated
disk_label
, if used - disk_
label str - The
label
of thedisk
to map to thisdevice
slot. - volume_
id int - The Volume ID to map to this
device
slot.
GetInstancesInstanceConfigDeviceSdh
- disk_
id int - The Disk ID of the associated
disk_label
, if used - disk_
label str - The
label
of thedisk
to map to thisdevice
slot. - volume_
id int - The Volume ID to map to this
device
slot.
GetInstancesInstanceConfigHelper
- Devtmpfs
Automount bool - Populates the /dev directory early during boot without udev. Defaults to false.
- Distro bool
- Controls the behavior of the Linode Config's Distribution Helper setting.
- Modules
Dep bool - Creates a modules dependency file for the Kernel you run.
- Network bool
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- Updatedb
Disabled bool - Disables updatedb cron job to avoid disk thrashing.
- Devtmpfs
Automount bool - Populates the /dev directory early during boot without udev. Defaults to false.
- Distro bool
- Controls the behavior of the Linode Config's Distribution Helper setting.
- Modules
Dep bool - Creates a modules dependency file for the Kernel you run.
- Network bool
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- Updatedb
Disabled bool - Disables updatedb cron job to avoid disk thrashing.
- devtmpfs
Automount Boolean - Populates the /dev directory early during boot without udev. Defaults to false.
- distro Boolean
- Controls the behavior of the Linode Config's Distribution Helper setting.
- modules
Dep Boolean - Creates a modules dependency file for the Kernel you run.
- network Boolean
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedb
Disabled Boolean - Disables updatedb cron job to avoid disk thrashing.
- devtmpfs
Automount boolean - Populates the /dev directory early during boot without udev. Defaults to false.
- distro boolean
- Controls the behavior of the Linode Config's Distribution Helper setting.
- modules
Dep boolean - Creates a modules dependency file for the Kernel you run.
- network boolean
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedb
Disabled boolean - Disables updatedb cron job to avoid disk thrashing.
- devtmpfs_
automount bool - Populates the /dev directory early during boot without udev. Defaults to false.
- distro bool
- Controls the behavior of the Linode Config's Distribution Helper setting.
- modules_
dep bool - Creates a modules dependency file for the Kernel you run.
- network bool
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedb_
disabled bool - Disables updatedb cron job to avoid disk thrashing.
- devtmpfs
Automount Boolean - Populates the /dev directory early during boot without udev. Defaults to false.
- distro Boolean
- Controls the behavior of the Linode Config's Distribution Helper setting.
- modules
Dep Boolean - Creates a modules dependency file for the Kernel you run.
- network Boolean
- Controls the behavior of the Linode Config's Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedb
Disabled Boolean - Disables updatedb cron job to avoid disk thrashing.
GetInstancesInstanceConfigInterface
- Active bool
- Whether this interface is currently booted and active.
- Id int
- The ID of the disk in the Linode API.
- Ipv4
Get
Instances Instance Config Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Purpose string
- The type of interface. (
public
,vlan
,vpc
) - Vpc
Id int - The ID of VPC which this interface is attached to.
- Ip
Ranges List<string> - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- Ipam
Address string - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Primary bool
- Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose. - Subnet
Id int - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose.
- Active bool
- Whether this interface is currently booted and active.
- Id int
- The ID of the disk in the Linode API.
- Ipv4
Get
Instances Instance Config Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- Purpose string
- The type of interface. (
public
,vlan
,vpc
) - Vpc
Id int - The ID of VPC which this interface is attached to.
- Ip
Ranges []string - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- Ipam
Address string - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Primary bool
- Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose. - Subnet
Id int - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose.
- active Boolean
- Whether this interface is currently booted and active.
- id Integer
- The ID of the disk in the Linode API.
- ipv4
Get
Instances Instance Config Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- purpose String
- The type of interface. (
public
,vlan
,vpc
) - vpc
Id Integer - The ID of VPC which this interface is attached to.
- ip
Ranges List<String> - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam
Address String - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary Boolean
- Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose. - subnet
Id Integer - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose.
- active boolean
- Whether this interface is currently booted and active.
- id number
- The ID of the disk in the Linode API.
- ipv4
Get
Instances Instance Config Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- purpose string
- The type of interface. (
public
,vlan
,vpc
) - vpc
Id number - The ID of VPC which this interface is attached to.
- ip
Ranges string[] - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam
Address string - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary boolean
- Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose. - subnet
Id number - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose.
- active bool
- Whether this interface is currently booted and active.
- id int
- The ID of the disk in the Linode API.
- ipv4
Get
Instances Instance Config Interface Ipv4 - This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- purpose str
- The type of interface. (
public
,vlan
,vpc
) - vpc_
id int - The ID of VPC which this interface is attached to.
- ip_
ranges Sequence[str] - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam_
address str - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - label str
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary bool
- Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose. - subnet_
id int - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose.
- active Boolean
- Whether this interface is currently booted and active.
- id Number
- The ID of the disk in the Linode API.
- ipv4 Property Map
- This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
- purpose String
- The type of interface. (
public
,vlan
,vpc
) - vpc
Id Number - The ID of VPC which this interface is attached to.
- ip
Ranges List<String> - IPv4 CIDR VPC Subnet ranges that are routed to this Interface. IPv6 ranges are also available to select participants in the Beta program.
- ipam
Address String - This Network Interface’s private IP address in Classless Inter-Domain Routing (CIDR) notation. (e.g.
10.0.0.1/24
) This field is only allowed for interfaces with thevlan
purpose. - label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - primary Boolean
- Whether the interface is the primary interface that should have the default route for this Linode. This field is only allowed for interfaces with the
public
orvpc
purpose. - subnet
Id Number - The name of the VPC Subnet to join. This field is only allowed and required for interfaces with the
vpc
purpose.
GetInstancesInstanceConfigInterfaceIpv4
- Nat11 string
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - Vpc string
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- Nat11 string
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - Vpc string
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 String
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc String
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 string
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc string
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 str
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc str
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
- nat11 String
- The public IP that will be used for the one-to-one NAT purpose. If this is
any
, the public IPv4 address assigned to this Linode is used on this interface and will be 1:1 NATted with the VPC IPv4 address. - vpc String
- The IP from the VPC subnet to use for this interface. A random address will be assigned if this is not specified in a VPC interface.
GetInstancesInstanceDisk
- Filesystem string
- The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider). - Id int
- The ID of the disk in the Linode API.
- Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Size int
- The size of the Disk in MB.
- Filesystem string
- The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider). - Id int
- The ID of the disk in the Linode API.
- Label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - Size int
- The size of the Disk in MB.
- filesystem String
- The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider). - id Integer
- The ID of the disk in the Linode API.
- label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - size Integer
- The size of the Disk in MB.
- filesystem string
- The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider). - id number
- The ID of the disk in the Linode API.
- label string
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - size number
- The size of the Disk in MB.
- filesystem str
- The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider). - id int
- The ID of the disk in the Linode API.
- label str
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - size int
- The size of the Disk in MB.
- filesystem String
- The Disk filesystem can be one of:
"raw"
,"swap"
,"ext3"
,"ext4"
, or"initrd"
which has a max size of 32mb and can be used in the configinitrd
(not currently supported in this provider). - id Number
- The ID of the disk in the Linode API.
- label String
- The name of the VLAN to join. This field is only allowed and required for interfaces with the
vlan
purpose. - size Number
- The size of the Disk in MB.
GetInstancesInstanceSpec
- Disk int
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- Memory int
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- Transfer int
- The amount of network transfer this Linode is allotted each month.
- Vcpus int
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- Disk int
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- Memory int
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- Transfer int
- The amount of network transfer this Linode is allotted each month.
- Vcpus int
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- disk Integer
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- memory Integer
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- transfer Integer
- The amount of network transfer this Linode is allotted each month.
- vcpus Integer
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- disk number
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- memory number
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- transfer number
- The amount of network transfer this Linode is allotted each month.
- vcpus number
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- disk int
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- memory int
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- transfer int
- The amount of network transfer this Linode is allotted each month.
- vcpus int
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
- disk Number
- The amount of storage space, in GB. this Linode has access to. A typical Linode will divide this space between a primary disk with an image deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image through POST /linode/instances.
- memory Number
- The amount of RAM, in MB, this Linode has access to. Typically a Linode will choose to boot with all of its available RAM, but this can be configured in a Config profile.
- transfer Number
- The amount of network transfer this Linode is allotted each month.
- vcpus Number
- The number of vcpus this Linode has access to. Typically a Linode will choose to boot with all of its available vcpus, but this can be configured in a Config Profile.
Package Details
- Repository
- Linode pulumi/pulumi-linode
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
linode
Terraform Provider.