This page documents the language specification for the linode package. If you're looking for help working with the inputs, outputs, or functions of linode resources in a Pulumi program, please see the resource documentation for examples and API reference.

Pulumi Linode¶

This provider is a derived work of the Terraform Provider distributed under MPL 2.0. If you encounter a bug or missing feature, first check the pulumi/pulumi-linode repo; however, if that doesn’t turn up anything, please consult the source terraform-providers/terraform-provider-linode repo.

class pulumi_linode.AwaitableGetAccountResult(address1=None, address2=None, balance=None, city=None, company=None, country=None, email=None, first_name=None, id=None, last_name=None, phone=None, state=None, zip=None)¶

class pulumi_linode.AwaitableGetDomainRecordResult(domain_id=None, id=None, name=None, port=None, priority=None, protocol=None, service=None, tag=None, target=None, ttl_sec=None, type=None, weight=None)¶

class pulumi_linode.AwaitableGetDomainResult(axfr_ips=None, description=None, domain=None, expire_sec=None, group=None, id=None, master_ips=None, refresh_sec=None, retry_sec=None, soa_email=None, status=None, tags=None, ttl_sec=None, type=None)¶

class pulumi_linode.AwaitableGetImageResult(created=None, created_by=None, deprecated=None, description=None, expiry=None, id=None, is_public=None, label=None, size=None, type=None, vendor=None)¶

class pulumi_linode.AwaitableGetInstanceTypeResult(addons=None, class_=None, disk=None, id=None, label=None, memory=None, network_out=None, price=None, transfer=None, vcpus=None)¶

class pulumi_linode.AwaitableGetNetworkingIpResult(address=None, gateway=None, id=None, linode_id=None, prefix=None, public=None, rdns=None, region=None, subnet_mask=None, type=None)¶

class pulumi_linode.AwaitableGetObjectStorageClusterResult(domain=None, id=None, region=None, static_site_domain=None, status=None)¶

class pulumi_linode.AwaitableGetProfileResult(authorized_keys=None, email=None, email_notifications=None, id=None, ip_whitelist_enabled=None, lish_auth_method=None, referrals=None, restricted=None, timezone=None, two_factor_auth=None, username=None)¶

class pulumi_linode.AwaitableGetRegionResult(country=None, id=None)¶

class pulumi_linode.AwaitableGetSshKeyResult(created=None, id=None, label=None, ssh_key=None)¶

class pulumi_linode.AwaitableGetStackScriptResult(created=None, deployments_active=None, deployments_total=None, description=None, id=None, images=None, is_public=None, label=None, rev_note=None, script=None, updated=None, user_defined_fields=None, user_gravatar_id=None, username=None)¶

class pulumi_linode.AwaitableGetUserResult(email=None, id=None, restricted=None, ssh_keys=None, username=None)¶

class pulumi_linode.AwaitableGetVolumeResult(created=None, filesystem_path=None, id=None, label=None, linode_id=None, region=None, size=None, status=None, tags=None, updated=None)¶

class pulumi_linode.Domain(resource_name, opts=None, axfr_ips=None, description=None, domain=None, expire_sec=None, group=None, master_ips=None, refresh_sec=None, retry_sec=None, soa_email=None, status=None, tags=None, ttl_sec=None, type=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode Domain resource. This can be used to create, modify, and delete Linode Domains through Linode’s managed DNS service. For more information, see DNS Manager and the Linode APIv4 docs.

import pulumi
import pulumi_linode as linode

foobar_domain = linode.Domain("foobarDomain",
    domain="foobar.example",
    soa_email="example@foobar.example",
    tags=[
        "foo",
        "bar",
    ],
    type="master")
foobar_domain_record = linode.DomainRecord("foobarDomainRecord",
    domain_id=foobar_domain.id,
    name="www",
    record_type="CNAME",
    target="foobar.example")

This resource exports no additional attributes, however status may reflect degraded states.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
axfr_ips (pulumi.Input[list]) – The list of IPs that may perform a zone transfer for this Domain. This is potentially dangerous, and should be set to an empty list unless you intend to use it.
description (pulumi.Input[str]) – A description for this Domain. This is for display purposes only.
domain (pulumi.Input[str]) – The domain this Domain represents. These must be unique in our system; you cannot have two Domains representing the same domain.
expire_sec (pulumi.Input[float]) – The amount of time in seconds that may pass before this Domain is no longer authoritative. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
group (pulumi.Input[str]) – The group this Domain belongs to. This is for display purposes only.
master_ips (pulumi.Input[list]) – The IP addresses representing the master DNS for this Domain.
refresh_sec (pulumi.Input[float]) – The amount of time in seconds before this Domain should be refreshed. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
retry_sec (pulumi.Input[float]) – The interval, in seconds, at which a failed refresh should be retried. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
soa_email (pulumi.Input[str]) – Start of Authority email address. This is required for master Domains.
status (pulumi.Input[str]) – Used to control whether this Domain is currently being rendered (defaults to “active”).
tags (pulumi.Input[list]) – A list of tags applied to this object. Tags are for organizational purposes only.
ttl_sec (pulumi.Input[float]) – ‘Time to Live’ - the amount of time in seconds that this Domain’s records may be cached by resolvers or other domain servers. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
type (pulumi.Input[str]) – If this Domain represents the authoritative source of information for the domain it describes, or if it is a read-only copy of a master (also called a slave).

axfr_ips: pulumi.Output[list] = None¶: The list of IPs that may perform a zone transfer for this Domain. This is potentially dangerous, and should be set to an empty list unless you intend to use it.

description: pulumi.Output[str] = None¶: A description for this Domain. This is for display purposes only.

domain: pulumi.Output[str] = None¶: The domain this Domain represents. These must be unique in our system; you cannot have two Domains representing the same domain.

expire_sec: pulumi.Output[float] = None¶: The amount of time in seconds that may pass before this Domain is no longer authoritative. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.

group: pulumi.Output[str] = None¶: The group this Domain belongs to. This is for display purposes only.

master_ips: pulumi.Output[list] = None¶: The IP addresses representing the master DNS for this Domain.

refresh_sec: pulumi.Output[float] = None¶: The amount of time in seconds before this Domain should be refreshed. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.

retry_sec: pulumi.Output[float] = None¶: The interval, in seconds, at which a failed refresh should be retried. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.

soa_email: pulumi.Output[str] = None¶: Start of Authority email address. This is required for master Domains.

status: pulumi.Output[str] = None¶: Used to control whether this Domain is currently being rendered (defaults to “active”).

tags: pulumi.Output[list] = None¶: A list of tags applied to this object. Tags are for organizational purposes only.

ttl_sec: pulumi.Output[float] = None¶: ‘Time to Live’ - the amount of time in seconds that this Domain’s records may be cached by resolvers or other domain servers. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.

type: pulumi.Output[str] = None¶: If this Domain represents the authoritative source of information for the domain it describes, or if it is a read-only copy of a master (also called a slave).

static get(resource_name, id, opts=None, axfr_ips=None, description=None, domain=None, expire_sec=None, group=None, master_ips=None, refresh_sec=None, retry_sec=None, soa_email=None, status=None, tags=None, ttl_sec=None, type=None)¶

Get an existing Domain resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
axfr_ips (pulumi.Input[list]) – The list of IPs that may perform a zone transfer for this Domain. This is potentially dangerous, and should be set to an empty list unless you intend to use it.
description (pulumi.Input[str]) – A description for this Domain. This is for display purposes only.
domain (pulumi.Input[str]) – The domain this Domain represents. These must be unique in our system; you cannot have two Domains representing the same domain.
expire_sec (pulumi.Input[float]) – The amount of time in seconds that may pass before this Domain is no longer authoritative. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
group (pulumi.Input[str]) – The group this Domain belongs to. This is for display purposes only.
master_ips (pulumi.Input[list]) – The IP addresses representing the master DNS for this Domain.
refresh_sec (pulumi.Input[float]) – The amount of time in seconds before this Domain should be refreshed. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
retry_sec (pulumi.Input[float]) – The interval, in seconds, at which a failed refresh should be retried. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
soa_email (pulumi.Input[str]) – Start of Authority email address. This is required for master Domains.
status (pulumi.Input[str]) – Used to control whether this Domain is currently being rendered (defaults to “active”).
tags (pulumi.Input[list]) – A list of tags applied to this object. Tags are for organizational purposes only.
ttl_sec (pulumi.Input[float]) – ‘Time to Live’ - the amount of time in seconds that this Domain’s records may be cached by resolvers or other domain servers. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
type (pulumi.Input[str]) – If this Domain represents the authoritative source of information for the domain it describes, or if it is a read-only copy of a master (also called a slave).

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.DomainRecord(resource_name, opts=None, domain_id=None, name=None, port=None, priority=None, protocol=None, record_type=None, service=None, tag=None, target=None, ttl_sec=None, weight=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode Domain Record resource. This can be used to create, modify, and delete Linodes Domain Records. For more information, see DNS Manager and the Linode APIv4 docs.

import pulumi
import pulumi_linode as linode

foobar_domain = linode.Domain("foobarDomain",
    domain="foobar.example",
    soa_email="example@foobar.example",
    type="master")
foobar_domain_record = linode.DomainRecord("foobarDomainRecord",
    domain_id=foobar_domain.id,
    name="www",
    record_type="CNAME",
    target="foobar.example")

This resource exports no additional attributes.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
domain_id (pulumi.Input[float]) – The ID of the Domain to access. Changing ``domain_id`` forces the creation of a new Linode Domain Record..
name (pulumi.Input[str]) – The name of this Record. Setting this is invalid for SRV records as it is generated by the API. This field’s actual usage depends on the type of record this represents. For A and AAAA records, this is the subdomain being associated with an IP address.
port (pulumi.Input[float]) – The port this Record points to.
priority (pulumi.Input[float]) – The priority of the target host. Lower values are preferred.
protocol (pulumi.Input[str]) – The protocol this Record’s service communicates with. Only valid for SRV records.
record_type (pulumi.Input[str]) – The type of Record this is in the DNS system. For example, A records associate a domain name with an IPv4 address, and AAAA records associate a domain name with an IPv6 address. Changing ``record_type`` forces the creation of a new Linode Domain Record..
service (pulumi.Input[str]) – The service this Record identified. Only valid for SRV records.
tag (pulumi.Input[str]) – The tag portion of a CAA record. It is invalid to set this on other record types.
target (pulumi.Input[str]) – The target for this Record. This field’s actual usage depends on the type of record this represents. For A and AAAA records, this is the address the named Domain should resolve to.
ttl_sec (pulumi.Input[float]) – ‘Time to Live’ - the amount of time in seconds that this Domain’s records may be cached by resolvers or other domain servers. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
weight (pulumi.Input[float]) – The relative weight of this Record. Higher values are preferred.

domain_id: pulumi.Output[float] = None¶: The ID of the Domain to access. Changing ``domain_id`` forces the creation of a new Linode Domain Record..

name: pulumi.Output[str] = None¶: The name of this Record. Setting this is invalid for SRV records as it is generated by the API. This field’s actual usage depends on the type of record this represents. For A and AAAA records, this is the subdomain being associated with an IP address.

port: pulumi.Output[float] = None¶: The port this Record points to.

priority: pulumi.Output[float] = None¶: The priority of the target host. Lower values are preferred.

protocol: pulumi.Output[str] = None¶: The protocol this Record’s service communicates with. Only valid for SRV records.

record_type: pulumi.Output[str] = None¶: The type of Record this is in the DNS system. For example, A records associate a domain name with an IPv4 address, and AAAA records associate a domain name with an IPv6 address. Changing ``record_type`` forces the creation of a new Linode Domain Record..

service: pulumi.Output[str] = None¶: The service this Record identified. Only valid for SRV records.

tag: pulumi.Output[str] = None¶: The tag portion of a CAA record. It is invalid to set this on other record types.

target: pulumi.Output[str] = None¶: The target for this Record. This field’s actual usage depends on the type of record this represents. For A and AAAA records, this is the address the named Domain should resolve to.

ttl_sec: pulumi.Output[float] = None¶: ‘Time to Live’ - the amount of time in seconds that this Domain’s records may be cached by resolvers or other domain servers. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.

weight: pulumi.Output[float] = None¶: The relative weight of this Record. Higher values are preferred.

static get(resource_name, id, opts=None, domain_id=None, name=None, port=None, priority=None, protocol=None, record_type=None, service=None, tag=None, target=None, ttl_sec=None, weight=None)¶

Get an existing DomainRecord resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
domain_id (pulumi.Input[float]) – The ID of the Domain to access. Changing ``domain_id`` forces the creation of a new Linode Domain Record..
name (pulumi.Input[str]) – The name of this Record. Setting this is invalid for SRV records as it is generated by the API. This field’s actual usage depends on the type of record this represents. For A and AAAA records, this is the subdomain being associated with an IP address.
port (pulumi.Input[float]) – The port this Record points to.
priority (pulumi.Input[float]) – The priority of the target host. Lower values are preferred.
protocol (pulumi.Input[str]) – The protocol this Record’s service communicates with. Only valid for SRV records.
record_type (pulumi.Input[str]) – The type of Record this is in the DNS system. For example, A records associate a domain name with an IPv4 address, and AAAA records associate a domain name with an IPv6 address. Changing ``record_type`` forces the creation of a new Linode Domain Record..
service (pulumi.Input[str]) – The service this Record identified. Only valid for SRV records.
tag (pulumi.Input[str]) – The tag portion of a CAA record. It is invalid to set this on other record types.
target (pulumi.Input[str]) – The target for this Record. This field’s actual usage depends on the type of record this represents. For A and AAAA records, this is the address the named Domain should resolve to.
ttl_sec (pulumi.Input[float]) – ‘Time to Live’ - the amount of time in seconds that this Domain’s records may be cached by resolvers or other domain servers. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.
weight (pulumi.Input[float]) – The relative weight of this Record. Higher values are preferred.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.Firewall(resource_name, opts=None, disabled=None, inbounds=None, label=None, linodes=None, outbounds=None, tags=None, __props__=None, __name__=None, __opts__=None)¶

NOTICE: The Firewall feature is currently available through early access.

Manages a Linode Firewall.

import pulumi
import pulumi_linode as linode

my_instance = linode.Instance("myInstance",
    label="my_instance",
    image="linode/ubuntu18.04",
    region="us-east",
    type="g6-standard-1",
    root_pass="bogusPassword$",
    swap_size=256)
my_firewall = linode.Firewall("myFirewall",
    label="my_firewall",
    tags=["test"],
    inbound=[{
        "protocol": "TCP",
        "ports": ["80"],
        "addresses": ["0.0.0.0/0"],
    }],
    outbound=[{
        "protocol": "TCP",
        "ports": ["80"],
        "addresses": ["0.0.0.0/0"],
    }],
    linodes=[my_instance.id])

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
disabled (pulumi.Input[bool]) – If true, the Firewall’s rules are not enforced (defaults to false).
inbounds (pulumi.Input[list]) – A firewall rule that specifies what inbound network traffic is allowed.
label (pulumi.Input[str]) – This Firewall’s unique label.
linodes (pulumi.Input[list]) – A list of IDs of Linodes this Firewall should govern it’s network traffic for.
outbounds (pulumi.Input[list]) – A firewall rule that specifies what outbound network traffic is allowed.
tags (pulumi.Input[list]) – A list of tags applied to the Kubernetes cluster. Tags are for organizational purposes only.

The inbounds object supports the following:

addresses (pulumi.Input[list]) - A list of IP addresses, CIDR blocks, or 0.0.0.0/0 (to whitelist all) this rule applies to.
ports (pulumi.Input[list]) - A list of ports and/or port ranges (i.e. “443” or “80-90”).
protocol (pulumi.Input[str]) - The network protocol this rule controls.

The outbounds object supports the following:

addresses (pulumi.Input[list]) - A list of IP addresses, CIDR blocks, or 0.0.0.0/0 (to whitelist all) this rule applies to.
ports (pulumi.Input[list]) - A list of ports and/or port ranges (i.e. “443” or “80-90”).
protocol (pulumi.Input[str]) - The network protocol this rule controls.

devices: pulumi.Output[list] = None¶

The devices associated with this firewall.

entityId (float) - The ID of the underlying entity this device references (i.e. the Linode’s ID).
id (float) - The ID of the Firewall Device.
label (str) - This Firewall’s unique label.
type (str) - The type of Firewall Device.
url (str)

disabled: pulumi.Output[bool] = None¶: If true, the Firewall’s rules are not enforced (defaults to false).

inbounds: pulumi.Output[list] = None¶

A firewall rule that specifies what inbound network traffic is allowed.

addresses (list) - A list of IP addresses, CIDR blocks, or 0.0.0.0/0 (to whitelist all) this rule applies to.
ports (list) - A list of ports and/or port ranges (i.e. “443” or “80-90”).
protocol (str) - The network protocol this rule controls.

label: pulumi.Output[str] = None¶: This Firewall’s unique label.

linodes: pulumi.Output[list] = None¶: A list of IDs of Linodes this Firewall should govern it’s network traffic for.

outbounds: pulumi.Output[list] = None¶

A firewall rule that specifies what outbound network traffic is allowed.

addresses (list) - A list of IP addresses, CIDR blocks, or 0.0.0.0/0 (to whitelist all) this rule applies to.
ports (list) - A list of ports and/or port ranges (i.e. “443” or “80-90”).
protocol (str) - The network protocol this rule controls.

status: pulumi.Output[str] = None¶: The status of the Firewall.

tags: pulumi.Output[list] = None¶: A list of tags applied to the Kubernetes cluster. Tags are for organizational purposes only.

static get(resource_name, id, opts=None, devices=None, disabled=None, inbounds=None, label=None, linodes=None, outbounds=None, status=None, tags=None)¶

Get an existing Firewall resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
devices (pulumi.Input[list]) – The devices associated with this firewall.
disabled (pulumi.Input[bool]) – If true, the Firewall’s rules are not enforced (defaults to false).
inbounds (pulumi.Input[list]) – A firewall rule that specifies what inbound network traffic is allowed.
label (pulumi.Input[str]) – This Firewall’s unique label.
linodes (pulumi.Input[list]) – A list of IDs of Linodes this Firewall should govern it’s network traffic for.
outbounds (pulumi.Input[list]) – A firewall rule that specifies what outbound network traffic is allowed.
status (pulumi.Input[str]) – The status of the Firewall.
tags (pulumi.Input[list]) – A list of tags applied to the Kubernetes cluster. Tags are for organizational purposes only.

The devices object supports the following:

entityId (pulumi.Input[float]) - The ID of the underlying entity this device references (i.e. the Linode’s ID).
id (pulumi.Input[float]) - The ID of the Firewall Device.
label (pulumi.Input[str]) - This Firewall’s unique label.
type (pulumi.Input[str]) - The type of Firewall Device.
url (pulumi.Input[str])

The inbounds object supports the following:

addresses (pulumi.Input[list]) - A list of IP addresses, CIDR blocks, or 0.0.0.0/0 (to whitelist all) this rule applies to.
ports (pulumi.Input[list]) - A list of ports and/or port ranges (i.e. “443” or “80-90”).
protocol (pulumi.Input[str]) - The network protocol this rule controls.

The outbounds object supports the following:

addresses (pulumi.Input[list]) - A list of IP addresses, CIDR blocks, or 0.0.0.0/0 (to whitelist all) this rule applies to.
ports (pulumi.Input[list]) - A list of ports and/or port ranges (i.e. “443” or “80-90”).
protocol (pulumi.Input[str]) - The network protocol this rule controls.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.GetAccountResult(address1=None, address2=None, balance=None, city=None, company=None, country=None, email=None, first_name=None, id=None, last_name=None, phone=None, state=None, zip=None)¶

A collection of values returned by getAccount.

id = None¶: The provider-assigned unique ID for this managed resource.

class pulumi_linode.GetDomainRecordResult(domain_id=None, id=None, name=None, port=None, priority=None, protocol=None, service=None, tag=None, target=None, ttl_sec=None, type=None, weight=None)¶: A collection of values returned by getDomainRecord.

class pulumi_linode.GetDomainResult(axfr_ips=None, description=None, domain=None, expire_sec=None, group=None, id=None, master_ips=None, refresh_sec=None, retry_sec=None, soa_email=None, status=None, tags=None, ttl_sec=None, type=None)¶: A collection of values returned by getDomain.

class pulumi_linode.GetImageResult(created=None, created_by=None, deprecated=None, description=None, expiry=None, id=None, is_public=None, label=None, size=None, type=None, vendor=None)¶: A collection of values returned by getImage.

class pulumi_linode.GetInstanceTypeResult(addons=None, class_=None, disk=None, id=None, label=None, memory=None, network_out=None, price=None, transfer=None, vcpus=None)¶: A collection of values returned by getInstanceType.

class pulumi_linode.GetNetworkingIpResult(address=None, gateway=None, id=None, linode_id=None, prefix=None, public=None, rdns=None, region=None, subnet_mask=None, type=None)¶

A collection of values returned by getNetworkingIp.

id = None¶: The provider-assigned unique ID for this managed resource.

class pulumi_linode.GetObjectStorageClusterResult(domain=None, id=None, region=None, static_site_domain=None, status=None)¶: A collection of values returned by getObjectStorageCluster.

class pulumi_linode.GetProfileResult(authorized_keys=None, email=None, email_notifications=None, id=None, ip_whitelist_enabled=None, lish_auth_method=None, referrals=None, restricted=None, timezone=None, two_factor_auth=None, username=None)¶

A collection of values returned by getProfile.

id = None¶: The provider-assigned unique ID for this managed resource.

class pulumi_linode.GetRegionResult(country=None, id=None)¶: A collection of values returned by getRegion.

class pulumi_linode.GetSshKeyResult(created=None, id=None, label=None, ssh_key=None)¶

A collection of values returned by getSshKey.

id = None¶: The provider-assigned unique ID for this managed resource.

class pulumi_linode.GetStackScriptResult(created=None, deployments_active=None, deployments_total=None, description=None, id=None, images=None, is_public=None, label=None, rev_note=None, script=None, updated=None, user_defined_fields=None, user_gravatar_id=None, username=None)¶: A collection of values returned by getStackScript.

class pulumi_linode.GetUserResult(email=None, id=None, restricted=None, ssh_keys=None, username=None)¶

A collection of values returned by getUser.

id = None¶: The provider-assigned unique ID for this managed resource.

class pulumi_linode.GetVolumeResult(created=None, filesystem_path=None, id=None, label=None, linode_id=None, region=None, size=None, status=None, tags=None, updated=None)¶: A collection of values returned by getVolume.

class pulumi_linode.Image(resource_name, opts=None, description=None, disk_id=None, label=None, linode_id=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode Image resource. This can be used to create, modify, and delete Linodes Images. Linode Images are snapshots of a Linode Instance Disk which can then be used to provision more Linode Instances. Images can be used across regions.

For more information, see Linode’s documentation on Images and the Linode APIv4 docs.

import pulumi
import pulumi_linode as linode

foo = linode.Instance("foo",
    region="us-central",
    type="g6-nanode-1")
bar = linode.Image("bar",
    description="Image taken from foo",
    disk_id=foo.disks[0]["id"],
    label="foo-sda-image",
    linode_id=foo.id)
bar_based = linode.Instance("barBased",
    image=bar.id,
    region="eu-west",
    type=foo.type)

This resource exports the following attributes:

id - The unique ID of this Image. The ID of private images begin with private/ followed by the numeric identifier of the private image, for example private/12345.
created - When this Image was created.
created_by - The name of the User who created this Image.
deprecated - Whether or not this Image is deprecated. Will only be True for deprecated public Images.
is_public - True if the Image is public.
size - The minimum size this Image needs to deploy. Size is in MB.
type - How the Image was created. ‘Manual’ Images can be created at any time. ‘Automatic’ images are created automatically from a deleted Linode.
expiry - Only Images created automatically (from a deleted Linode; type=automatic) will expire.
vendor - The upstream distribution vendor. Nil for private Images.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
description (pulumi.Input[str]) – A detailed description of this Image.
disk_id (pulumi.Input[float]) – The ID of the Linode Disk that this Image will be created from.
label (pulumi.Input[str]) – A short description of the Image. Labels cannot contain special characters.
linode_id (pulumi.Input[float]) – The ID of the Linode that this Image will be created from.

created: pulumi.Output[str] = None¶: When this Image was created.

created_by: pulumi.Output[str] = None¶: The name of the User who created this Image.

deprecated: pulumi.Output[bool] = None¶: Whether or not this Image is deprecated. Will only be True for deprecated public Images.

description: pulumi.Output[str] = None¶: A detailed description of this Image.

disk_id: pulumi.Output[float] = None¶: The ID of the Linode Disk that this Image will be created from.

expiry: pulumi.Output[str] = None¶: Only Images created automatically (from a deleted Linode; type=automatic) will expire.

is_public: pulumi.Output[bool] = None¶: True if the Image is public.

label: pulumi.Output[str] = None¶: A short description of the Image. Labels cannot contain special characters.

linode_id: pulumi.Output[float] = None¶: The ID of the Linode that this Image will be created from.

size: pulumi.Output[float] = None¶: The minimum size this Image needs to deploy. Size is in MB.

type: pulumi.Output[str] = None¶: How the Image was created. ‘Manual’ Images can be created at any time. ‘Automatic’ images are created automatically from a deleted Linode.

vendor: pulumi.Output[str] = None¶: The upstream distribution vendor. Nil for private Images.

static get(resource_name, id, opts=None, created=None, created_by=None, deprecated=None, description=None, disk_id=None, expiry=None, is_public=None, label=None, linode_id=None, size=None, type=None, vendor=None)¶

Get an existing Image resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
created (pulumi.Input[str]) – When this Image was created.
created_by (pulumi.Input[str]) – The name of the User who created this Image.
deprecated (pulumi.Input[bool]) – Whether or not this Image is deprecated. Will only be True for deprecated public Images.
description (pulumi.Input[str]) – A detailed description of this Image.
disk_id (pulumi.Input[float]) – The ID of the Linode Disk that this Image will be created from.
expiry (pulumi.Input[str]) – Only Images created automatically (from a deleted Linode; type=automatic) will expire.
is_public (pulumi.Input[bool]) – True if the Image is public.
label (pulumi.Input[str]) – A short description of the Image. Labels cannot contain special characters.
linode_id (pulumi.Input[float]) – The ID of the Linode that this Image will be created from.
size (pulumi.Input[float]) – The minimum size this Image needs to deploy. Size is in MB.
type (pulumi.Input[str]) – How the Image was created. ‘Manual’ Images can be created at any time. ‘Automatic’ images are created automatically from a deleted Linode.
vendor (pulumi.Input[str]) – The upstream distribution vendor. Nil for private Images.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.Instance(resource_name, opts=None, alerts=None, authorized_keys=None, authorized_users=None, backup_id=None, backups_enabled=None, boot_config_label=None, configs=None, disks=None, group=None, image=None, label=None, private_ip=None, region=None, root_pass=None, stackscript_data=None, stackscript_id=None, swap_size=None, tags=None, type=None, watchdog_enabled=None, __props__=None, __name__=None, __opts__=None)¶

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.

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 pulumi
import pulumi_linode as linode

me = linode.get_profile()
web_volume = linode.Volume("webVolume",
    label="web_volume",
    region="us-central",
    size=20)
web = linode.Instance("web",
    boot_config_label="boot_config",
    configs=[{
        "devices": {
            "sda": {
                "diskLabel": "boot",
            },
            "sdb": {
                "volumeId": web_volume.id,
            },
        },
        "kernel": "linode/latest-64bit",
        "label": "boot_config",
        "rootDevice": "/dev/sda",
    }],
    disks=[{
        "authorized_keys": ["ssh-rsa AAAA...Gw== user@example.local"],
        "authorized_users": [me.username],
        "image": "linode/ubuntu18.04",
        "label": "boot",
        "root_pass": "terr4form-test",
        "size": 3000,
    }],
    group="foo",
    label="complex_instance",
    private_ip=True,
    region="us-central",
    tags=["foo"],
    type="g6-nanode-1")

This Linode Instance resource exports the following attributes:

status - The status of the instance, indicating the current readiness state. (running, offline, …)
ip_address - A string containing the Linode’s public IP address.
private_ip_address - 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.
ipv6 - 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.
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.
specs.0.disk - 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.
specs.0.memory - 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.
specs.0.vcpus - 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.
specs.0.transfer - The amount of network transfer this Linode is allotted each month.
backups - Information about this Linode’s backups status.
- enabled - If this Linode has the Backup service enabled.
- schedule
  - day - 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 - 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.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
authorized_keys (pulumi.Input[list]) – A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if image is provided. This value can not be imported. Changing ``authorized_keys`` forces the creation of a new Linode Instance.
authorized_users (pulumi.Input[list]) – 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 (pulumi.Input[float]) – 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 (pulumi.Input[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 (pulumi.Input[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.
configs (pulumi.Input[list]) – Configuration profiles define the VM settings and boot behavior of the Linode Instance.
group (pulumi.Input[str]) – The display group of the Linode instance.
image (pulumi.Input[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. Changing ``image`` forces the creation of a new Linode Instance.
label (pulumi.Input[str]) – The Config’s label for display purposes. Also used by boot_config_label.
private_ip (pulumi.Input[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.
region (pulumi.Input[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..
root_pass (pulumi.Input[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 state.
stackscript_data (pulumi.Input[dict]) – 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 (pulumi.Input[float]) – 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 (pulumi.Input[float]) – 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 (pulumi.Input[list]) – A list of tags applied to this object. Tags are for organizational purposes only.
type (pulumi.Input[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 (pulumi.Input[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.

The alerts object supports the following:

cpu (pulumi.Input[float])
io (pulumi.Input[float])
networkIn (pulumi.Input[float])
networkOut (pulumi.Input[float])
transferQuota (pulumi.Input[float])

The configs object supports the following:

comments (pulumi.Input[str]) - - Arbitrary user comments about this config.
devices (pulumi.Input[dict]) - 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.
- sda (pulumi.Input[dict]) - … 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.
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdb (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdc (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdd (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sde (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdf (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdg (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdh (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
helpers (pulumi.Input[dict]) - Helpers enabled when booting to this Linode Config.
- devtmpfsAutomount (pulumi.Input[bool])
- distro (pulumi.Input[bool]) - Controls the behavior of the Linode Config’s Distribution Helper setting.
- modulesDep (pulumi.Input[bool]) - Creates a modules dependency file for the Kernel you run.
- network (pulumi.Input[bool]) - Controls the behavior of the Linode Config’s Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedbDisabled (pulumi.Input[bool]) - Disables updatedb cron job to avoid disk thrashing.
kernel (pulumi.Input[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.
label (pulumi.Input[str]) - The Config’s label for display purposes. Also used by boot_config_label.
memoryLimit (pulumi.Input[float]) - - Defaults to the total RAM of the Linode
rootDevice (pulumi.Input[str]) - - The root device to boot. The corresponding disk must be attached to a device slot. Example: "/dev/sda"
runLevel (pulumi.Input[str]) - - Defines the state of your Linode after booting. Defaults to "default".
virtMode (pulumi.Input[str]) - - Controls the virtualization mode. Defaults to "paravirt".

The disks object supports the following:

authorized_keys (pulumi.Input[list]) - A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if image is provided. This value can not be imported. Changing ``authorized_keys`` forces the creation of a new Linode Instance.
authorized_users (pulumi.Input[list]) - 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 (pulumi.Input[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 (pulumi.Input[float]) - The ID of the disk in the Linode API.
image (pulumi.Input[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. Changing ``image`` forces the creation of a new Linode Instance.
label (pulumi.Input[str]) - The Config’s label for display purposes. Also used by boot_config_label.
readOnly (pulumi.Input[bool])
root_pass (pulumi.Input[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 state.
size (pulumi.Input[float]) - The size of the Disk in MB.
stackscript_data (pulumi.Input[dict]) - 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 (pulumi.Input[float]) - 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.

authorized_keys: pulumi.Output[list] = None¶: A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if image is provided. This value can not be imported. Changing ``authorized_keys`` forces the creation of a new Linode Instance.

authorized_users: pulumi.Output[list] = None¶: 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: pulumi.Output[float] = None¶: 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: pulumi.Output[dict] = None¶

Information about this Linode’s backups status.

enabled (bool)
schedule (dict)
- day (str)
- window (str)

backups_enabled: pulumi.Output[bool] = None¶: 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: pulumi.Output[str] = None¶: 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.

configs: pulumi.Output[list] = None¶

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

comments (str) - - Arbitrary user comments about this config.
devices (dict) - 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.
- sda (dict) - … 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.
  - disk_id (float) - The Disk ID of the associated disk_label, if used.
  - diskLabel (str) - The label of the disk to map to this device slot.
  - volumeId (float) - The Volume ID to map to this device slot.
- sdb (dict)
  - disk_id (float) - The Disk ID of the associated disk_label, if used.
  - diskLabel (str) - The label of the disk to map to this device slot.
  - volumeId (float) - The Volume ID to map to this device slot.
- sdc (dict)
  - disk_id (float) - The Disk ID of the associated disk_label, if used.
  - diskLabel (str) - The label of the disk to map to this device slot.
  - volumeId (float) - The Volume ID to map to this device slot.
- sdd (dict)
  - disk_id (float) - The Disk ID of the associated disk_label, if used.
  - diskLabel (str) - The label of the disk to map to this device slot.
  - volumeId (float) - The Volume ID to map to this device slot.
- sde (dict)
  - disk_id (float) - The Disk ID of the associated disk_label, if used.
  - diskLabel (str) - The label of the disk to map to this device slot.
  - volumeId (float) - The Volume ID to map to this device slot.
- sdf (dict)
  - disk_id (float) - The Disk ID of the associated disk_label, if used.
  - diskLabel (str) - The label of the disk to map to this device slot.
  - volumeId (float) - The Volume ID to map to this device slot.
- sdg (dict)
  - disk_id (float) - The Disk ID of the associated disk_label, if used.
  - diskLabel (str) - The label of the disk to map to this device slot.
  - volumeId (float) - The Volume ID to map to this device slot.
- sdh (dict)
  - disk_id (float) - The Disk ID of the associated disk_label, if used.
  - diskLabel (str) - The label of the disk to map to this device slot.
  - volumeId (float) - The Volume ID to map to this device slot.
helpers (dict) - Helpers enabled when booting to this Linode Config.
- 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.
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.
label (str) - The Config’s label for display purposes. Also used by boot_config_label.
memoryLimit (float) - - Defaults to the total RAM of the Linode
rootDevice (str) - - The root device to boot. The corresponding disk must be attached to a device slot. Example: "/dev/sda"
runLevel (str) - - Defines the state of your Linode after booting. Defaults to "default".
virtMode (str) - - Controls the virtualization mode. Defaults to "paravirt".

group: pulumi.Output[str] = None¶: The display group of the Linode instance.

image: pulumi.Output[str] = None¶: 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. Changing ``image`` forces the creation of a new Linode Instance.

ip_address: pulumi.Output[str] = None¶: This Linode’s Public IPv4 Address. If there are multiple public IPv4 addresses on this Instance, an arbitrary address will be used for this field.

ipv4s: pulumi.Output[list] = None¶: 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: pulumi.Output[str] = None¶: This Linode’s IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared.

label: pulumi.Output[str] = None¶: The Config’s label for display purposes. Also used by boot_config_label.

private_ip: pulumi.Output[bool] = None¶: 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: pulumi.Output[str] = None¶: This Linode’s Private IPv4 Address. The regional private IP address range is 192.168.128/17 address shared by all Linode Instances in a region.

region: pulumi.Output[str] = None¶: 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..

root_pass: pulumi.Output[str] = None¶: 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 state.

stackscript_data: pulumi.Output[dict] = None¶: 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: pulumi.Output[float] = None¶: 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: pulumi.Output[str] = None¶: The status of the instance, indicating the current readiness state.

swap_size: pulumi.Output[float] = None¶: 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: pulumi.Output[list] = None¶: A list of tags applied to this object. Tags are for organizational purposes only.

type: pulumi.Output[str] = None¶: 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: pulumi.Output[bool] = None¶: 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.

static get(resource_name, id, opts=None, alerts=None, authorized_keys=None, authorized_users=None, backup_id=None, backups=None, backups_enabled=None, boot_config_label=None, configs=None, disks=None, group=None, image=None, ip_address=None, ipv4s=None, ipv6=None, label=None, private_ip=None, private_ip_address=None, region=None, root_pass=None, specs=None, stackscript_data=None, stackscript_id=None, status=None, swap_size=None, tags=None, type=None, watchdog_enabled=None)¶

Get an existing Instance resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
authorized_keys (pulumi.Input[list]) – A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if image is provided. This value can not be imported. Changing ``authorized_keys`` forces the creation of a new Linode Instance.
authorized_users (pulumi.Input[list]) – 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 (pulumi.Input[float]) – 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 (pulumi.Input[dict]) – Information about this Linode’s backups status.
backups_enabled (pulumi.Input[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 (pulumi.Input[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.
configs (pulumi.Input[list]) – Configuration profiles define the VM settings and boot behavior of the Linode Instance.
group (pulumi.Input[str]) – The display group of the Linode instance.
image (pulumi.Input[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. Changing ``image`` forces the creation of a new Linode Instance.
ip_address (pulumi.Input[str]) – This Linode’s Public IPv4 Address. If there are multiple public IPv4 addresses on this Instance, an arbitrary address will be used for this field.
ipv4s (pulumi.Input[list]) – 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 (pulumi.Input[str]) – This Linode’s IPv6 SLAAC addresses. This address is specific to a Linode, and may not be shared.
label (pulumi.Input[str]) – The Config’s label for display purposes. Also used by boot_config_label.
private_ip (pulumi.Input[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 (pulumi.Input[str]) – This Linode’s Private IPv4 Address. The regional private IP address range is 192.168.128/17 address shared by all Linode Instances in a region.
region (pulumi.Input[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..
root_pass (pulumi.Input[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 state.
stackscript_data (pulumi.Input[dict]) – 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 (pulumi.Input[float]) – 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 (pulumi.Input[str]) – The status of the instance, indicating the current readiness state.
swap_size (pulumi.Input[float]) – 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 (pulumi.Input[list]) – A list of tags applied to this object. Tags are for organizational purposes only.
type (pulumi.Input[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 (pulumi.Input[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.

The alerts object supports the following:

cpu (pulumi.Input[float])
io (pulumi.Input[float])
networkIn (pulumi.Input[float])
networkOut (pulumi.Input[float])
transferQuota (pulumi.Input[float])

The backups object supports the following:

enabled (pulumi.Input[bool])
schedule (pulumi.Input[dict])
- day (pulumi.Input[str])
- window (pulumi.Input[str])

The configs object supports the following:

comments (pulumi.Input[str]) - - Arbitrary user comments about this config.
devices (pulumi.Input[dict]) - 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.
- sda (pulumi.Input[dict]) - … 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.
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdb (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdc (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdd (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sde (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdf (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdg (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
- sdh (pulumi.Input[dict])
  - disk_id (pulumi.Input[float]) - The Disk ID of the associated disk_label, if used.
  - diskLabel (pulumi.Input[str]) - The label of the disk to map to this device slot.
  - volumeId (pulumi.Input[float]) - The Volume ID to map to this device slot.
helpers (pulumi.Input[dict]) - Helpers enabled when booting to this Linode Config.
- devtmpfsAutomount (pulumi.Input[bool])
- distro (pulumi.Input[bool]) - Controls the behavior of the Linode Config’s Distribution Helper setting.
- modulesDep (pulumi.Input[bool]) - Creates a modules dependency file for the Kernel you run.
- network (pulumi.Input[bool]) - Controls the behavior of the Linode Config’s Network Helper setting, used to automatically configure additional IP addresses assigned to this instance.
- updatedbDisabled (pulumi.Input[bool]) - Disables updatedb cron job to avoid disk thrashing.
kernel (pulumi.Input[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.
label (pulumi.Input[str]) - The Config’s label for display purposes. Also used by boot_config_label.
memoryLimit (pulumi.Input[float]) - - Defaults to the total RAM of the Linode
rootDevice (pulumi.Input[str]) - - The root device to boot. The corresponding disk must be attached to a device slot. Example: "/dev/sda"
runLevel (pulumi.Input[str]) - - Defines the state of your Linode after booting. Defaults to "default".
virtMode (pulumi.Input[str]) - - Controls the virtualization mode. Defaults to "paravirt".

The disks object supports the following:

authorized_keys (pulumi.Input[list]) - A list of SSH public keys to deploy for the root user on the newly created Linode. Only accepted if image is provided. This value can not be imported. Changing ``authorized_keys`` forces the creation of a new Linode Instance.
authorized_users (pulumi.Input[list]) - 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 (pulumi.Input[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 (pulumi.Input[float]) - The ID of the disk in the Linode API.
image (pulumi.Input[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. Changing ``image`` forces the creation of a new Linode Instance.
label (pulumi.Input[str]) - The Config’s label for display purposes. Also used by boot_config_label.
readOnly (pulumi.Input[bool])
root_pass (pulumi.Input[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 state.
size (pulumi.Input[float]) - The size of the Disk in MB.
stackscript_data (pulumi.Input[dict]) - 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 (pulumi.Input[float]) - 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.

The specs object supports the following:

disk (pulumi.Input[float])
memory (pulumi.Input[float])
transfer (pulumi.Input[float])
vcpus (pulumi.Input[float])

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.LkeCluster(resource_name, opts=None, k8s_version=None, label=None, pools=None, region=None, tags=None, __props__=None, __name__=None, __opts__=None)¶

Manages an LKE cluster.

import pulumi
import pulumi_linode as linode

my_cluster = linode.LkeCluster("my-cluster",
    k8s_version="1.17",
    label="my-cluster",
    pools=[{
        "count": 3,
        "type": "g6-standard-2",
    }],
    region="us-central",
    tags=["prod"])

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
k8s_version (pulumi.Input[str]) – The desired Kubernetes version for this Kubernetes cluster in the format of major.minor (e.g. 1.17), and the latest supported patch version will be deployed.
label (pulumi.Input[str]) – This Kubernetes cluster’s unique label.
pools (pulumi.Input[list]) – Additional nested attributes:
region (pulumi.Input[str]) – This Kubernetes cluster’s location.
tags (pulumi.Input[list]) – An array of tags applied to the Kubernetes cluster. Tags are for organizational purposes only.

The pools object supports the following:

count (pulumi.Input[float]) - The number of nodes in the Node Pool.
id (pulumi.Input[float]) - The ID of the node.
nodes (pulumi.Input[list])
- id (pulumi.Input[str]) - The ID of the node.
- instanceId (pulumi.Input[float]) - The ID of the underlying Linode instance.
- status (pulumi.Input[str]) - The status of the node.
type (pulumi.Input[str]) - A Linode Type for all of the nodes in the Node Pool.

api_endpoints: pulumi.Output[list] = None¶: The endpoints for the Kubernetes API server.

k8s_version: pulumi.Output[str] = None¶: The desired Kubernetes version for this Kubernetes cluster in the format of major.minor (e.g. 1.17), and the latest supported patch version will be deployed.

kubeconfig: pulumi.Output[str] = None¶: The base64 encoded kubeconfig for the Kubernetes cluster.

label: pulumi.Output[str] = None¶: This Kubernetes cluster’s unique label.

pools: pulumi.Output[list] = None¶

Additional nested attributes:

count (float) - The number of nodes in the Node Pool.
id (float) - The ID of the node.
nodes (list)
- id (str) - The ID of the node.
- instanceId (float) - The ID of the underlying Linode instance.
- status (str) - The status of the node.
type (str) - A Linode Type for all of the nodes in the Node Pool.

region: pulumi.Output[str] = None¶: This Kubernetes cluster’s location.

status: pulumi.Output[str] = None¶: The status of the node.

tags: pulumi.Output[list] = None¶: An array of tags applied to the Kubernetes cluster. Tags are for organizational purposes only.

static get(resource_name, id, opts=None, api_endpoints=None, k8s_version=None, kubeconfig=None, label=None, pools=None, region=None, status=None, tags=None)¶

Get an existing LkeCluster resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
api_endpoints (pulumi.Input[list]) – The endpoints for the Kubernetes API server.
k8s_version (pulumi.Input[str]) – The desired Kubernetes version for this Kubernetes cluster in the format of major.minor (e.g. 1.17), and the latest supported patch version will be deployed.
kubeconfig (pulumi.Input[str]) – The base64 encoded kubeconfig for the Kubernetes cluster.
label (pulumi.Input[str]) – This Kubernetes cluster’s unique label.
pools (pulumi.Input[list]) – Additional nested attributes:
region (pulumi.Input[str]) – This Kubernetes cluster’s location.
status (pulumi.Input[str]) – The status of the node.
tags (pulumi.Input[list]) – An array of tags applied to the Kubernetes cluster. Tags are for organizational purposes only.

The pools object supports the following:

count (pulumi.Input[float]) - The number of nodes in the Node Pool.
id (pulumi.Input[float]) - The ID of the node.
nodes (pulumi.Input[list])
- id (pulumi.Input[str]) - The ID of the node.
- instanceId (pulumi.Input[float]) - The ID of the underlying Linode instance.
- status (pulumi.Input[str]) - The status of the node.
type (pulumi.Input[str]) - A Linode Type for all of the nodes in the Node Pool.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.NodeBalancer(resource_name, opts=None, client_conn_throttle=None, label=None, region=None, tags=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode NodeBalancer resource. This can be used to create, modify, and delete Linodes NodeBalancers in Linode’s managed load balancer service. For more information, see Getting Started with NodeBalancers and the Linode APIv4 docs.

import pulumi
import pulumi_linode as linode

foobar = linode.NodeBalancer("foobar",
    client_conn_throttle=20,
    label="mynodebalancer",
    region="us-east",
    tags=["foobar"])

This resource exports the following attributes:

hostname - This NodeBalancer’s hostname, ending with .nodebalancer.linode.com
ipv4 - The Public IPv4 Address of this NodeBalancer
ipv6 - The Public IPv6 Address of this NodeBalancer

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
client_conn_throttle (pulumi.Input[float]) – Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
label (pulumi.Input[str]) – The label of the Linode NodeBalancer
region (pulumi.Input[str]) – The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. Changing ``region`` forces the creation of a new Linode NodeBalancer..
tags (pulumi.Input[list]) – A list of tags applied to this object. Tags are for organizational purposes only.

client_conn_throttle: pulumi.Output[float] = None¶: Throttle connections per second (0-20). Set to 0 (default) to disable throttling.

hostname: pulumi.Output[str] = None¶: This NodeBalancer’s hostname, ending with .nodebalancer.linode.com

ipv4: pulumi.Output[str] = None¶: The Public IPv4 Address of this NodeBalancer

ipv6: pulumi.Output[str] = None¶: The Public IPv6 Address of this NodeBalancer

label: pulumi.Output[str] = None¶: The label of the Linode NodeBalancer

region: pulumi.Output[str] = None¶: The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. Changing ``region`` forces the creation of a new Linode NodeBalancer..

tags: pulumi.Output[list] = None¶: A list of tags applied to this object. Tags are for organizational purposes only.

static get(resource_name, id, opts=None, client_conn_throttle=None, created=None, hostname=None, ipv4=None, ipv6=None, label=None, region=None, tags=None, transfer=None, updated=None)¶

Get an existing NodeBalancer resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
client_conn_throttle (pulumi.Input[float]) – Throttle connections per second (0-20). Set to 0 (default) to disable throttling.
hostname (pulumi.Input[str]) – This NodeBalancer’s hostname, ending with .nodebalancer.linode.com
ipv4 (pulumi.Input[str]) – The Public IPv4 Address of this NodeBalancer
ipv6 (pulumi.Input[str]) – The Public IPv6 Address of this NodeBalancer
label (pulumi.Input[str]) – The label of the Linode NodeBalancer
region (pulumi.Input[str]) – The region where this NodeBalancer will be deployed. Examples are "us-east", "us-west", "ap-south", etc. Changing ``region`` forces the creation of a new Linode NodeBalancer..
tags (pulumi.Input[list]) – A list of tags applied to this object. Tags are for organizational purposes only.

The transfer object supports the following:

in_ (pulumi.Input[float])
out (pulumi.Input[float])
total (pulumi.Input[float])

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.NodeBalancerConfig(resource_name, opts=None, algorithm=None, check=None, check_attempts=None, check_body=None, check_interval=None, check_passive=None, check_path=None, check_timeout=None, cipher_suite=None, nodebalancer_id=None, port=None, protocol=None, ssl_cert=None, ssl_key=None, stickiness=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode NodeBalancer Config resource. This can be used to create, modify, and delete Linodes NodeBalancer Configs. For more information, see Getting Started with NodeBalancers and the Linode APIv4 docs.

import pulumi
import pulumi_linode as linode

foobar = linode.NodeBalancer("foobar",
    client_conn_throttle=20,
    label="mynodebalancer",
    region="us-east")
foofig = linode.NodeBalancerConfig("foofig",
    algorithm="source",
    check="http",
    check_attempts=3,
    check_path="/foo",
    check_timeout=30,
    nodebalancer_id=foobar.id,
    port=8088,
    protocol="http",
    stickiness="http_cookie")

This resource exports the following attributes:

ssl_commonname - The common name for the SSL certification this port is serving if this port is not configured to use SSL.
ssl_fingerprint - The fingerprint for the SSL certification this port is serving if this port is not configured to use SSL.
node_status_up - The number of backends considered to be ‘UP’ and healthy, and that are serving requests.
node_status_down - The number of backends considered to be ‘DOWN’ and unhealthy. These are not in rotation, and not serving requests.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
algorithm (pulumi.Input[str]) – What algorithm this NodeBalancer should use for routing traffic to backends: roundrobin, leastconn, source
check (pulumi.Input[str]) – The type of check to perform against backends to ensure they are serving requests. This is used to determine if backends are up or down. If none no check is performed. connection requires only a connection to the backend to succeed. http and http_body rely on the backend serving HTTP, and that the response returned matches what is expected.
check_attempts (pulumi.Input[float]) – How many times to attempt a check before considering a backend to be down. (1-30)
check_body (pulumi.Input[str]) – This value must be present in the response body of the check in order for it to pass. If this value is not present in the response body of a check request, the backend is considered to be down
check_interval (pulumi.Input[float]) – How often, in seconds, to check that backends are up and serving requests.
check_passive (pulumi.Input[bool]) – If true, any response from this backend with a 5xx status code will be enough for it to be considered unhealthy and taken out of rotation.
check_path (pulumi.Input[str]) – The URL path to check on each backend. If the backend does not respond to this request it is considered to be down.
check_timeout (pulumi.Input[float]) – How long, in seconds, to wait for a check attempt before considering it failed. (1-30)
cipher_suite (pulumi.Input[str]) – What ciphers to use for SSL connections served by this NodeBalancer. legacy is considered insecure and should only be used if necessary.
nodebalancer_id (pulumi.Input[float]) – The ID of the NodeBalancer to access.
port (pulumi.Input[float]) – The TCP port this Config is for. These values must be unique across configs on a single NodeBalancer (you can’t have two configs for port 80, for example). While some ports imply some protocols, no enforcement is done and you may configure your NodeBalancer however is useful to you. For example, while port 443 is generally used for HTTPS, you do not need SSL configured to have a NodeBalancer listening on port 443. (Defaults to 80)
protocol (pulumi.Input[str]) – The protocol this port is configured to serve. If this is set to https you must include an ssl_cert and an ssl_key. (Defaults to “http”)
ssl_cert (pulumi.Input[str]) – The certificate this port is serving. This is not returned. If set, this field will come back as <REDACTED>. Please use the ssl_commonname and ssl_fingerprint to identify the certificate.
ssl_key (pulumi.Input[str]) – The private key corresponding to this port’s certificate. This is not returned. If set, this field will come back as <REDACTED>. Please use the ssl_commonname and ssl_fingerprint to identify the certificate.
stickiness (pulumi.Input[str]) – Controls how session stickiness is handled on this port: ‘none’, ‘table’, ‘http_cookie’

algorithm: pulumi.Output[str] = None¶: What algorithm this NodeBalancer should use for routing traffic to backends: roundrobin, leastconn, source

check: pulumi.Output[str] = None¶: The type of check to perform against backends to ensure they are serving requests. This is used to determine if backends are up or down. If none no check is performed. connection requires only a connection to the backend to succeed. http and http_body rely on the backend serving HTTP, and that the response returned matches what is expected.

check_attempts: pulumi.Output[float] = None¶: How many times to attempt a check before considering a backend to be down. (1-30)

check_body: pulumi.Output[str] = None¶: This value must be present in the response body of the check in order for it to pass. If this value is not present in the response body of a check request, the backend is considered to be down

check_interval: pulumi.Output[float] = None¶: How often, in seconds, to check that backends are up and serving requests.

check_passive: pulumi.Output[bool] = None¶: If true, any response from this backend with a 5xx status code will be enough for it to be considered unhealthy and taken out of rotation.

check_path: pulumi.Output[str] = None¶: The URL path to check on each backend. If the backend does not respond to this request it is considered to be down.

check_timeout: pulumi.Output[float] = None¶: How long, in seconds, to wait for a check attempt before considering it failed. (1-30)

cipher_suite: pulumi.Output[str] = None¶: What ciphers to use for SSL connections served by this NodeBalancer. legacy is considered insecure and should only be used if necessary.

nodebalancer_id: pulumi.Output[float] = None¶: The ID of the NodeBalancer to access.

port: pulumi.Output[float] = None¶: The TCP port this Config is for. These values must be unique across configs on a single NodeBalancer (you can’t have two configs for port 80, for example). While some ports imply some protocols, no enforcement is done and you may configure your NodeBalancer however is useful to you. For example, while port 443 is generally used for HTTPS, you do not need SSL configured to have a NodeBalancer listening on port 443. (Defaults to 80)

protocol: pulumi.Output[str] = None¶: The protocol this port is configured to serve. If this is set to https you must include an ssl_cert and an ssl_key. (Defaults to “http”)

ssl_cert: pulumi.Output[str] = None¶: The certificate this port is serving. This is not returned. If set, this field will come back as <REDACTED>. Please use the ssl_commonname and ssl_fingerprint to identify the certificate.

ssl_commonname: pulumi.Output[str] = None¶: The common name for the SSL certification this port is serving if this port is not configured to use SSL.

ssl_fingerprint: pulumi.Output[str] = None¶: The fingerprint for the SSL certification this port is serving if this port is not configured to use SSL.

ssl_key: pulumi.Output[str] = None¶: The private key corresponding to this port’s certificate. This is not returned. If set, this field will come back as <REDACTED>. Please use the ssl_commonname and ssl_fingerprint to identify the certificate.

stickiness: pulumi.Output[str] = None¶: Controls how session stickiness is handled on this port: ‘none’, ‘table’, ‘http_cookie’

static get(resource_name, id, opts=None, algorithm=None, check=None, check_attempts=None, check_body=None, check_interval=None, check_passive=None, check_path=None, check_timeout=None, cipher_suite=None, node_status=None, nodebalancer_id=None, port=None, protocol=None, ssl_cert=None, ssl_commonname=None, ssl_fingerprint=None, ssl_key=None, stickiness=None)¶

Get an existing NodeBalancerConfig resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
algorithm (pulumi.Input[str]) – What algorithm this NodeBalancer should use for routing traffic to backends: roundrobin, leastconn, source
check (pulumi.Input[str]) – The type of check to perform against backends to ensure they are serving requests. This is used to determine if backends are up or down. If none no check is performed. connection requires only a connection to the backend to succeed. http and http_body rely on the backend serving HTTP, and that the response returned matches what is expected.
check_attempts (pulumi.Input[float]) – How many times to attempt a check before considering a backend to be down. (1-30)
check_body (pulumi.Input[str]) – This value must be present in the response body of the check in order for it to pass. If this value is not present in the response body of a check request, the backend is considered to be down
check_interval (pulumi.Input[float]) – How often, in seconds, to check that backends are up and serving requests.
check_passive (pulumi.Input[bool]) – If true, any response from this backend with a 5xx status code will be enough for it to be considered unhealthy and taken out of rotation.
check_path (pulumi.Input[str]) – The URL path to check on each backend. If the backend does not respond to this request it is considered to be down.
check_timeout (pulumi.Input[float]) – How long, in seconds, to wait for a check attempt before considering it failed. (1-30)
cipher_suite (pulumi.Input[str]) – What ciphers to use for SSL connections served by this NodeBalancer. legacy is considered insecure and should only be used if necessary.
nodebalancer_id (pulumi.Input[float]) – The ID of the NodeBalancer to access.
port (pulumi.Input[float]) – The TCP port this Config is for. These values must be unique across configs on a single NodeBalancer (you can’t have two configs for port 80, for example). While some ports imply some protocols, no enforcement is done and you may configure your NodeBalancer however is useful to you. For example, while port 443 is generally used for HTTPS, you do not need SSL configured to have a NodeBalancer listening on port 443. (Defaults to 80)
protocol (pulumi.Input[str]) – The protocol this port is configured to serve. If this is set to https you must include an ssl_cert and an ssl_key. (Defaults to “http”)
ssl_cert (pulumi.Input[str]) – The certificate this port is serving. This is not returned. If set, this field will come back as <REDACTED>. Please use the ssl_commonname and ssl_fingerprint to identify the certificate.
ssl_commonname (pulumi.Input[str]) – The common name for the SSL certification this port is serving if this port is not configured to use SSL.
ssl_fingerprint (pulumi.Input[str]) – The fingerprint for the SSL certification this port is serving if this port is not configured to use SSL.
ssl_key (pulumi.Input[str]) – The private key corresponding to this port’s certificate. This is not returned. If set, this field will come back as <REDACTED>. Please use the ssl_commonname and ssl_fingerprint to identify the certificate.
stickiness (pulumi.Input[str]) – Controls how session stickiness is handled on this port: ‘none’, ‘table’, ‘http_cookie’

The node_status object supports the following:

status_down (pulumi.Input[float])
status_up (pulumi.Input[float])

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.NodeBalancerNode(resource_name, opts=None, address=None, config_id=None, label=None, mode=None, nodebalancer_id=None, weight=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode NodeBalancer Node resource. This can be used to create, modify, and delete Linodes NodeBalancer Nodes. For more information, see Getting Started with NodeBalancers and the Linode APIv4 docs.

import pulumi
import pulumi_linode as linode

web = []
for range in [{"value": i} for i in range(0, 3)]:
    web.append(linode.Instance(f"web-{range['value']}",
        authorized_keys=["ssh-rsa AAAA...Gw== user@example.local"],
        image="linode/ubuntu18.04",
        label=f"web-{range['value'] + 1}",
        private_ip=True,
        region="us-east",
        root_pass="test",
        type="g6-standard-1"))
foobar = linode.NodeBalancer("foobar",
    client_conn_throttle=20,
    label="mynodebalancer",
    region="us-east")
foofig = linode.NodeBalancerConfig("foofig",
    algorithm="source",
    check="http",
    check_attempts=3,
    check_path="/foo",
    check_timeout=30,
    nodebalancer_id=foobar.id,
    port=80,
    protocol="http",
    stickiness="http_cookie")
foonode = []
for range in [{"value": i} for i in range(0, 3)]:
    foonode.append(linode.NodeBalancerNode(f"foonode-{range['value']}",
        address=[__item.private_ip_address for __item in web][range["value"]].apply(lambda private_ip_addresses: f"{private_ip_addresses}:80"),
        config_id=foofig.id,
        label="mynodebalancernode",
        nodebalancer_id=foobar.id,
        weight=50))

This resource exports the following attributes:

status - The current status of this node, based on the configured checks of its NodeBalancer Config. (unknown, UP, DOWN).
config_id - The ID of the NodeBalancerConfig this NodeBalancerNode is attached to.
nodebalancer_id - The ID of the NodeBalancer this NodeBalancerNode is attached to.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
address (pulumi.Input[str]) – The private IP Address where this backend can be reached. This must be a private IP address.
config_id (pulumi.Input[float]) – The ID of the NodeBalancerConfig to access.
label (pulumi.Input[str]) – The label of the Linode NodeBalancer Node. This is for display purposes only.
mode (pulumi.Input[str]) – The mode this NodeBalancer should use when sending traffic to this backend. If set to accept this backend is accepting traffic. If set to reject this backend will not receive traffic. If set to drain this backend will not receive new traffic, but connections already pinned to it will continue to be routed to it
nodebalancer_id (pulumi.Input[float]) – The ID of the NodeBalancer to access.
weight (pulumi.Input[float]) – Used when picking a backend to serve a request and is not pinned to a single backend yet. Nodes with a higher weight will receive more traffic. (1-255).

address: pulumi.Output[str] = None¶: The private IP Address where this backend can be reached. This must be a private IP address.

config_id: pulumi.Output[float] = None¶: The ID of the NodeBalancerConfig to access.

label: pulumi.Output[str] = None¶: The label of the Linode NodeBalancer Node. This is for display purposes only.

mode: pulumi.Output[str] = None¶: The mode this NodeBalancer should use when sending traffic to this backend. If set to accept this backend is accepting traffic. If set to reject this backend will not receive traffic. If set to drain this backend will not receive new traffic, but connections already pinned to it will continue to be routed to it

nodebalancer_id: pulumi.Output[float] = None¶: The ID of the NodeBalancer to access.

status: pulumi.Output[str] = None¶: The current status of this node, based on the configured checks of its NodeBalancer Config. (unknown, UP, DOWN)

weight: pulumi.Output[float] = None¶: Used when picking a backend to serve a request and is not pinned to a single backend yet. Nodes with a higher weight will receive more traffic. (1-255).

static get(resource_name, id, opts=None, address=None, config_id=None, label=None, mode=None, nodebalancer_id=None, status=None, weight=None)¶

Get an existing NodeBalancerNode resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
address (pulumi.Input[str]) – The private IP Address where this backend can be reached. This must be a private IP address.
config_id (pulumi.Input[float]) – The ID of the NodeBalancerConfig to access.
label (pulumi.Input[str]) – The label of the Linode NodeBalancer Node. This is for display purposes only.
mode (pulumi.Input[str]) – The mode this NodeBalancer should use when sending traffic to this backend. If set to accept this backend is accepting traffic. If set to reject this backend will not receive traffic. If set to drain this backend will not receive new traffic, but connections already pinned to it will continue to be routed to it
nodebalancer_id (pulumi.Input[float]) – The ID of the NodeBalancer to access.
status (pulumi.Input[str]) – The current status of this node, based on the configured checks of its NodeBalancer Config. (unknown, UP, DOWN)
weight (pulumi.Input[float]) – Used when picking a backend to serve a request and is not pinned to a single backend yet. Nodes with a higher weight will receive more traffic. (1-255).

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.ObjectStorageBucket(resource_name, opts=None, cluster=None, label=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode Object Storage Bucket resource. This can be used to create, modify, and delete Linodes Object Storage Buckets.

import pulumi
import pulumi_linode as linode

primary = linode.get_object_storage_cluster(id="us-east-1")
foobar = linode.ObjectStorageBucket("foobar",
    cluster=primary.id,
    label="%s")

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
cluster (pulumi.Input[str]) – The cluster of the Linode Object Storage Bucket.
label (pulumi.Input[str]) – The label of the Linode Object Storage Bucket.

cluster: pulumi.Output[str] = None¶: The cluster of the Linode Object Storage Bucket.

label: pulumi.Output[str] = None¶: The label of the Linode Object Storage Bucket.

static get(resource_name, id, opts=None, cluster=None, label=None)¶

Get an existing ObjectStorageBucket resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
cluster (pulumi.Input[str]) – The cluster of the Linode Object Storage Bucket.
label (pulumi.Input[str]) – The label of the Linode Object Storage Bucket.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.ObjectStorageKey(resource_name, opts=None, label=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode Object Storage Key resource. This can be used to create, modify, and delete Linodes Object Storage Keys.

import pulumi
import pulumi_linode as linode

foo = linode.ObjectStorageKey("foo", label="image-access")

This resource exports the following attributes:

access_key - This keypair’s access key. This is not secret.
secret_key - This keypair’s secret key.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
label (pulumi.Input[str]) – The label given to this key. For display purposes only.

access_key: pulumi.Output[str] = None¶: This keypair’s access key. This is not secret.

label: pulumi.Output[str] = None¶: The label given to this key. For display purposes only.

secret_key: pulumi.Output[str] = None¶: This keypair’s secret key.

static get(resource_name, id, opts=None, access_key=None, label=None, secret_key=None)¶

Get an existing ObjectStorageKey resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
access_key (pulumi.Input[str]) – This keypair’s access key. This is not secret.
label (pulumi.Input[str]) – The label given to this key. For display purposes only.
secret_key (pulumi.Input[str]) – This keypair’s secret key.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.Provider(resource_name, opts=None, api_version=None, token=None, ua_prefix=None, url=None, __props__=None, __name__=None, __opts__=None)¶

The provider type for the linode package. By default, resources use package-wide configuration settings, however an explicit Provider instance may be created and passed during resource construction to achieve fine-grained programmatic control over provider settings. See the documentation for more information.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
api_version (pulumi.Input[str]) – An HTTP User-Agent Prefix to prepend in API requests.
token (pulumi.Input[str]) – The token that allows you access to your Linode account
ua_prefix (pulumi.Input[str]) – An HTTP User-Agent Prefix to prepend in API requests.
url (pulumi.Input[str]) – The HTTP(S) API address of the Linode API to use.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.Rdns(resource_name, opts=None, address=None, rdns=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode RDNS resource. This can be used to create and modify RDNS records.

Linode RDNS names must have a matching address value in an A or AAAA record. This A or AAAA name must be resolvable at the time the RDNS resource is being associated.

For more information, see the Linode APIv4 docs and the Configure your Linode for Reverse DNS guide.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
address (pulumi.Input[str]) – The Public IPv4 or IPv6 address that will receive the PTR record. A matching A or AAAA record must exist.
rdns (pulumi.Input[str]) – The name of the RDNS address.

address: pulumi.Output[str] = None¶: The Public IPv4 or IPv6 address that will receive the PTR record. A matching A or AAAA record must exist.

rdns: pulumi.Output[str] = None¶: The name of the RDNS address.

static get(resource_name, id, opts=None, address=None, rdns=None)¶

Get an existing Rdns resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
address (pulumi.Input[str]) – The Public IPv4 or IPv6 address that will receive the PTR record. A matching A or AAAA record must exist.
rdns (pulumi.Input[str]) – The name of the RDNS address.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.SshKey(resource_name, opts=None, label=None, ssh_key=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode SSH Key resource. This can be used to create, modify, and delete Linodes SSH Keys. Managed SSH Keys allow instances to be created with a list of Linode usernames, whose SSH keys will be automatically applied to the root account’s ~/.ssh/authorized_keys file. For more information, see the Linode APIv4 docs.

This resource exports the following attributes:

created - The date this SSH Key was created.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
label (pulumi.Input[str]) – A label for the SSH Key.
ssh_key (pulumi.Input[str]) – The public SSH Key, which is used to authenticate to the root user of the Linodes you deploy.

created: pulumi.Output[str] = None¶: The date this key was added.

label: pulumi.Output[str] = None¶: A label for the SSH Key.

ssh_key: pulumi.Output[str] = None¶: The public SSH Key, which is used to authenticate to the root user of the Linodes you deploy.

static get(resource_name, id, opts=None, created=None, label=None, ssh_key=None)¶

Get an existing SshKey resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
created (pulumi.Input[str]) – The date this key was added.
label (pulumi.Input[str]) – A label for the SSH Key.
ssh_key (pulumi.Input[str]) – The public SSH Key, which is used to authenticate to the root user of the Linodes you deploy.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.StackScript(resource_name, opts=None, description=None, images=None, is_public=None, label=None, rev_note=None, script=None, user_defined_fields=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode StackScript resource. This can be used to create, modify, and delete Linode StackScripts. StackScripts are private or public managed scripts which run within an instance during startup. StackScripts can include variables whose values are specified when the Instance is created.

For more information, see Automate Deployment with StackScripts and the Linode APIv4 docs.

import pulumi
import pulumi_linode as linode

foo_stack_script = linode.StackScript("fooStackScript",
    description="Installs a Package",
    images=[
        "linode/ubuntu18.04",
        "linode/ubuntu16.04lts",
    ],
    label="foo",
    rev_note="initial version",
    script="""#!/bin/bash
# <UDF name="package" label="System Package to Install" example="nginx" default="">
apt-get -q update && apt-get -q -y install $$PACKAGE

""")
foo_instance = linode.Instance("fooInstance",
    authorized_keys=["..."],
    image="linode/ubuntu18.04",
    label="foo",
    region="us-east",
    root_pass="...",
    stackscript_data={
        "package": "nginx",
    },
    stackscript_id=linode_stackscript["install-nginx"]["id"],
    type="g6-nanode-1")

This resource exports the following attributes:

deployments_active - Count of currently active, deployed Linodes created from this StackScript.
user_gravatar_id - The Gravatar ID for the User who created the StackScript.
deployments_total - The total number of times this StackScript has been deployed.
username - The User who created the StackScript.
created - The date this StackScript was created.
updated - The date this StackScript was updated.
user_defined_fields - This is a list of fields defined with a special syntax inside this StackScript that allow for supplying customized parameters during deployment.
- label - A human-readable label for the field that will serve as the input prompt for entering the value during deployment.
- name - The name of the field.
- example - An example value for the field.
- one_of - A list of acceptable single values for the field.
- many_of - A list of acceptable values for the field in any quantity, combination or order.
- default - The default value. If not specified, this value will be used.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
description (pulumi.Input[str]) – A description for the StackScript.
images (pulumi.Input[list]) – An array of Image IDs representing the Images that this StackScript is compatible for deploying with.
is_public (pulumi.Input[bool]) – This determines whether other users can use your StackScript. Once a StackScript is made public, it cannot be made private. Changing ``is_public`` forces the creation of a new StackScript
label (pulumi.Input[str]) – The StackScript’s label is for display purposes only.
rev_note (pulumi.Input[str]) – This field allows you to add notes for the set of revisions made to this StackScript.
script (pulumi.Input[str]) – The script to execute when provisioning a new Linode with this StackScript.
user_defined_fields (pulumi.Input[list]) – This is a list of fields defined with a special syntax inside this StackScript that allow for supplying customized parameters during deployment.

The user_defined_fields object supports the following:

default (pulumi.Input[str])
example (pulumi.Input[str])
label (pulumi.Input[str]) - The StackScript’s label is for display purposes only.
manyOf (pulumi.Input[str])
name (pulumi.Input[str])
oneOf (pulumi.Input[str])

created: pulumi.Output[str] = None¶: The date this StackScript was created.

deployments_active: pulumi.Output[float] = None¶: Count of currently active, deployed Linodes created from this StackScript.

deployments_total: pulumi.Output[float] = None¶: The total number of times this StackScript has been deployed.

description: pulumi.Output[str] = None¶: A description for the StackScript.

images: pulumi.Output[list] = None¶: An array of Image IDs representing the Images that this StackScript is compatible for deploying with.

is_public: pulumi.Output[bool] = None¶: This determines whether other users can use your StackScript. Once a StackScript is made public, it cannot be made private. Changing ``is_public`` forces the creation of a new StackScript

label: pulumi.Output[str] = None¶: The StackScript’s label is for display purposes only.

rev_note: pulumi.Output[str] = None¶: This field allows you to add notes for the set of revisions made to this StackScript.

script: pulumi.Output[str] = None¶: The script to execute when provisioning a new Linode with this StackScript.

updated: pulumi.Output[str] = None¶: The date this StackScript was updated.

user_defined_fields: pulumi.Output[list] = None¶

This is a list of fields defined with a special syntax inside this StackScript that allow for supplying customized parameters during deployment.

default (str)
example (str)
label (str) - The StackScript’s label is for display purposes only.
manyOf (str)
name (str)
oneOf (str)

user_gravatar_id: pulumi.Output[str] = None¶: The Gravatar ID for the User who created the StackScript.

username: pulumi.Output[str] = None¶: The User who created the StackScript.

static get(resource_name, id, opts=None, created=None, deployments_active=None, deployments_total=None, description=None, images=None, is_public=None, label=None, rev_note=None, script=None, updated=None, user_defined_fields=None, user_gravatar_id=None, username=None)¶

Get an existing StackScript resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
created (pulumi.Input[str]) – The date this StackScript was created.
deployments_active (pulumi.Input[float]) – Count of currently active, deployed Linodes created from this StackScript.
deployments_total (pulumi.Input[float]) – The total number of times this StackScript has been deployed.
description (pulumi.Input[str]) – A description for the StackScript.
images (pulumi.Input[list]) – An array of Image IDs representing the Images that this StackScript is compatible for deploying with.
is_public (pulumi.Input[bool]) – This determines whether other users can use your StackScript. Once a StackScript is made public, it cannot be made private. Changing ``is_public`` forces the creation of a new StackScript
label (pulumi.Input[str]) – The StackScript’s label is for display purposes only.
rev_note (pulumi.Input[str]) – This field allows you to add notes for the set of revisions made to this StackScript.
script (pulumi.Input[str]) – The script to execute when provisioning a new Linode with this StackScript.
updated (pulumi.Input[str]) – The date this StackScript was updated.
user_defined_fields (pulumi.Input[list]) – This is a list of fields defined with a special syntax inside this StackScript that allow for supplying customized parameters during deployment.
user_gravatar_id (pulumi.Input[str]) – The Gravatar ID for the User who created the StackScript.
username (pulumi.Input[str]) – The User who created the StackScript.

The user_defined_fields object supports the following:

default (pulumi.Input[str])
example (pulumi.Input[str])
label (pulumi.Input[str]) - The StackScript’s label is for display purposes only.
manyOf (pulumi.Input[str])
name (pulumi.Input[str])
oneOf (pulumi.Input[str])

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.Token(resource_name, opts=None, expiry=None, label=None, scopes=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode Token resource. This can be used to create, modify, and delete Linode API Personal Access Tokens. Personal Access Tokens proxy user credentials for Linode API access. This is necessary for tools, to interact with Linode services on a user’s behalf.

It is common for the provider itself to be configured with broadly scoped Personal Access Tokens. Provisioning scripts or tools configured within a Linode Instance should follow the principle of least privilege to afford only the required roles for tools to perform their necessary tasks. The .Token resource allows for the management of Personal Access Tokens with scopes mirroring or narrowing the scope of the parent token.

For more information, see the Linode APIv4 docs.

import pulumi
import pulumi_linode as linode

foo_token = linode.Token("fooToken",
    expiry="2100-01-02T03:04:05Z",
    label="token",
    scopes="linodes:read_only")
foo_instance = linode.Instance("fooInstance")

This resource exports the following attributes:

token - The token used to access the API.
created - The date this Token was created.

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
expiry (pulumi.Input[str]) – When this token will expire. Personal Access Tokens cannot be renewed, so after this time the token will be completely unusable and a new token will need to be generated. Tokens may be created with ‘null’ as their expiry and will never expire unless revoked.
label (pulumi.Input[str]) – A label for the Token.
scopes (pulumi.Input[str]) – The scopes this token was created with. These define what parts of the Account the token can be used to access. Many command-line tools, such as the Linode CLI, require tokens with access to *. Tokens with more restrictive scopes are generally more secure.

created: pulumi.Output[str] = None¶: The date and time this token was created.

expiry: pulumi.Output[str] = None¶: When this token will expire. Personal Access Tokens cannot be renewed, so after this time the token will be completely unusable and a new token will need to be generated. Tokens may be created with ‘null’ as their expiry and will never expire unless revoked.

label: pulumi.Output[str] = None¶: A label for the Token.

scopes: pulumi.Output[str] = None¶: The scopes this token was created with. These define what parts of the Account the token can be used to access. Many command-line tools, such as the Linode CLI, require tokens with access to *. Tokens with more restrictive scopes are generally more secure.

token: pulumi.Output[str] = None¶: The token used to access the API.

static get(resource_name, id, opts=None, created=None, expiry=None, label=None, scopes=None, token=None)¶

Get an existing Token resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
created (pulumi.Input[str]) – The date and time this token was created.
expiry (pulumi.Input[str]) – When this token will expire. Personal Access Tokens cannot be renewed, so after this time the token will be completely unusable and a new token will need to be generated. Tokens may be created with ‘null’ as their expiry and will never expire unless revoked.
label (pulumi.Input[str]) – A label for the Token.
scopes (pulumi.Input[str]) – The scopes this token was created with. These define what parts of the Account the token can be used to access. Many command-line tools, such as the Linode CLI, require tokens with access to *. Tokens with more restrictive scopes are generally more secure.
token (pulumi.Input[str]) – The token used to access the API.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_linode.Volume(resource_name, opts=None, label=None, linode_id=None, region=None, size=None, tags=None, __props__=None, __name__=None, __opts__=None)¶

Provides a Linode Volume resource. This can be used to create, modify, and delete Linodes Block Storage Volumes. Block Storage Volumes are removable storage disks that persist outside the life-cycle of Linode Instances. These volumes can be attached to and detached from Linode instances throughout a region.

For more information, see How to Use Block Storage with Your Linode and the Linode APIv4 docs.

import pulumi
import pulumi_linode as linode

foobaz = linode.Instance("foobaz",
    region="us-west",
    root_pass="3X4mp13",
    tags=["foobaz"],
    type="g6-nanode-1")
foobar = linode.Volume("foobar",
    label="foo-volume",
    linode_id=foobaz.id,
    region=foobaz.region)

This resource exports the following attributes:

status - The label of the Linode Volume.
filesystem_path - The full filesystem path for the Volume based on the Volume’s label. The path is “/dev/disk/by-id/scsi-0LinodeVolume” + the Volume label

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
label (pulumi.Input[str]) – The label of the Linode Volume
linode_id (pulumi.Input[float]) – The ID of a Linode Instance where the the Volume should be attached.
region (pulumi.Input[str]) – The region where this volume will be deployed. Examples are "us-east", "us-west", "ap-south", etc. Changing ``region`` forces the creation of a new Linode Volume..
size (pulumi.Input[float]) – Size of the Volume in GB.
tags (pulumi.Input[list]) – A list of tags applied to this object. Tags are for organizational purposes only.

filesystem_path: pulumi.Output[str] = None¶: The full filesystem path for the Volume based on the Volume’s label. Path is /dev/disk/by-id/scsi-0LinodeVolume + Volume label.

label: pulumi.Output[str] = None¶: The label of the Linode Volume

linode_id: pulumi.Output[float] = None¶: The ID of a Linode Instance where the the Volume should be attached.

region: pulumi.Output[str] = None¶: The region where this volume will be deployed. Examples are "us-east", "us-west", "ap-south", etc. Changing ``region`` forces the creation of a new Linode Volume..

size: pulumi.Output[float] = None¶: Size of the Volume in GB.

status: pulumi.Output[str] = None¶: The status of the volume, indicating the current readiness state.

tags: pulumi.Output[list] = None¶: A list of tags applied to this object. Tags are for organizational purposes only.

static get(resource_name, id, opts=None, filesystem_path=None, label=None, linode_id=None, region=None, size=None, status=None, tags=None)¶

Get an existing Volume resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
filesystem_path (pulumi.Input[str]) – The full filesystem path for the Volume based on the Volume’s label. Path is /dev/disk/by-id/scsi-0LinodeVolume + Volume label.
label (pulumi.Input[str]) – The label of the Linode Volume
linode_id (pulumi.Input[float]) – The ID of a Linode Instance where the the Volume should be attached.
region (pulumi.Input[str]) – The region where this volume will be deployed. Examples are "us-east", "us-west", "ap-south", etc. Changing ``region`` forces the creation of a new Linode Volume..
size (pulumi.Input[float]) – Size of the Volume in GB.
status (pulumi.Input[str]) – The status of the volume, indicating the current readiness state.
tags (pulumi.Input[list]) – A list of tags applied to this object. Tags are for organizational purposes only.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

pulumi_linode.get_account(opts=None)¶

Provides information about a Linode account.

This data source should not be used in conjuction with the LINODE_DEBUG option. See the debugging notes for more details.

import pulumi
import pulumi_linode as linode

account = linode.get_account()

The Linode Account resource exports the following attributes:

email - The email address for this Account, for account management communications, and may be used for other communications as configured.
first_name - The first name of the person associated with this Account.
last_name - The last name of the person associated with this Account.
company - The company name associated with this Account.
address_1 - First line of this Account’s billing address.
address_2 - Second line of this Account’s billing address.
phone - The phone number associated with this Account.
city - The city for this Account’s billing address.
state - If billing address is in the United States, this is the State portion of the Account’s billing address. If the address is outside the US, this is the Province associated with the Account’s billing address.
country - The two-letter country code of this Account’s billing address.
zip - The zip code of this Account’s billing address.
balance - This Account’s balance, in US dollars.

pulumi_linode.get_domain(domain=None, id=None, opts=None)¶

Provides information about a Linode domain.

import pulumi
import pulumi_linode as linode

foo = linode.get_domain(id="1234567")
bar = linode.get_domain(domain="bar.example.com")

The Linode Domain resource exports the following attributes:

id - The unique ID of this Domain.
domain - The domain this Domain represents. These must be unique in our system; you cannot have two Domains representing the same domain
type - If this Domain represents the authoritative source of information for the domain it describes, or if it is a read-only copy of a master (also called a slave)
group - The group this Domain belongs to.
status - Used to control whether this Domain is currently being rendered.
description - A description for this Domain.
master_ips - The IP addresses representing the master DNS for this Domain.
axfr_ips - The list of IPs that may perform a zone transfer for this Domain.
ttl_sec - ‘Time to Live’-the amount of time in seconds that this Domain’s records may be cached by resolvers or other domain servers.
retry_sec - The interval, in seconds, at which a failed refresh should be retried.
expire_sec - The amount of time in seconds that may pass before this Domain is no longer authoritative.
refresh_sec - The amount of time in seconds before this Domain should be refreshed.
soa_email - Start of Authority email address.
tags - An array of tags applied to this object.

Parameters

domain (str) – The unique domain name of the Domain record to query.
id (str) – The unique numeric ID of the Domain record to query.

pulumi_linode.get_domain_record(domain_id=None, id=None, name=None, opts=None)¶

Provides information about a Linode Domain Record.

import pulumi
import pulumi_linode as linode

my_record = linode.get_domain_record(domain_id="3150401",
    id="14950401")
my_www_record = linode.get_domain_record(domain_id="3150401",
    name="www")

The Linode Volume resource exports the following attributes:

id - The unique ID of the Domain Record.
name - The name of the Record.
domain_id - The associated domain’s unique ID.
type - The type of Record this is in the DNS system.
ttl_sec - The amount of time in seconds that this Domain’s records may be cached by resolvers or other domain servers.
target - The target for this Record. This field’s actual usage depends on the type of record this represents. For A and AAAA records, this is the address the named Domain should resolve to.
priority - The priority of the target host. Lower values are preferred.
weight - The relative weight of this Record. Higher values are preferred.
port - The port this Record points to.
protocol - The protocol this Record’s service communicates with. Only valid for SRV records.
service - The service this Record identified. Only valid for SRV records.
tag - The tag portion of a CAA record.

pulumi_linode.get_image(id=None, opts=None)¶

Provides information about a Linode image

import pulumi
import pulumi_linode as linode

k8_master = linode.get_image(id="linode/debian8")

The Linode Image resource exports the following attributes:

label - A short description of the Image.
created - When this Image was created.
created_by - The name of the User who created this Image, or “linode” for official Images.
deprecated - Whether or not this Image is deprecated. Will only be true for deprecated public Images.
description - A detailed description of this Image.
is_public - True if the Image is public.
size - The minimum size this Image needs to deploy. Size is in MB. example: 2500
type - How the Image was created. Manual Images can be created at any time. image”Automatic” Images are created automatically from a deleted Linode.
vendor - The upstream distribution vendor. None for private Images.

Parameters: id (str) – The unique ID of this Image. The ID of private images begin with private/ followed by the numeric identifier of the private image, for example private/12345.

pulumi_linode.get_instance_type(id=None, label=None, opts=None)¶

Provides information about a Linode instance type

import pulumi
import pulumi_linode as linode

default = linode.get_instance_type(id="g6-standard-2")

The Linode Instance Type resource exports the following attributes:

id - The ID representing the Linode Type
label - The Linode Type’s label is for display purposes only
class - The class of the Linode Type
disk - The Disk size, in MB, of the Linode Type
price.0.hourly - Cost (in US dollars) per hour.
price.0.monthly - Cost (in US dollars) per month.
addons.0.backups.0.price.0.hourly - The cost (in US dollars) per hour to add Backups service.
addons.0.backups.0.price.0.monthly - The cost (in US dollars) per month to add Backups service.

Parameters: id (str) – Label used to identify instance type

pulumi_linode.get_networking_ip(address=None, opts=None)¶

Provides information about a Linode Networking IP Address

import pulumi
import pulumi_linode as linode

ns1_linode_com = linode.get_networking_ip(address="162.159.27.72")

The Linode Network IP Address resource exports the following attributes:

address - The IP address.
gateway - The default gateway for this address.
subnet_mask - The mask that separates host bits from network bits for this address.
prefix - The number of bits set in the subnet mask.
type - The type of address this is (ipv4, ipv6, ipv6/pool, ipv6/range).
public - Whether this is a public or private IP address.
rdns - The reverse DNS assigned to this address. For public IPv4 addresses, this will be set to a default value provided by Linode if not explicitly set.
linode_id - The ID of the Linode this address currently belongs to.
region - The Region this IP address resides in.

Parameters: address (str) – The IP Address to access. The address must be associated with the account and a resource that the user has access to view.

pulumi_linode.get_object_storage_cluster(domain=None, id=None, region=None, static_site_domain=None, status=None, opts=None)¶

Provides information about a Linode Object Storage Cluster

import pulumi
import pulumi_linode as linode

primary = linode.get_object_storage_cluster(id="us-east-1")

The Linode Object Storage Cluster resource exports the following attributes:

domain - The base URL for this cluster.
status - This cluster’s status.
region - The region this cluster is located in.
static_site_domain - The base URL for this cluster used when hosting static sites.

Parameters: id (str) – The unique ID of this cluster.

pulumi_linode.get_profile(opts=None)¶

Provides information about a Linode profile.

import pulumi
import pulumi_linode as linode

profile = linode.get_profile()

The Linode Profile resource exports the following attributes:

email - The profile email address. This address will be used for communication with Linode as necessary.
timezone - The profile’s preferred timezone. This is not used by the API, and is for the benefit of clients only. All times the API returns are in UTC.
email_notifications - If true, email notifications will be sent about account activity. If false, when false business-critical communications may still be sent through email.
username - The username for logging in to Linode services.
ip_whitelist_enabled - If true, logins for the user will only be allowed from whitelisted IPs. This setting is currently deprecated, and cannot be enabled.
lish_auth_method - The methods of authentication allowed when connecting via Lish. ‘keys_only’ is the most secure with the intent to use Lish, and ‘disabled’ is recommended for users that will not use Lish at all.
authorized_keys - The list of SSH Keys authorized to use Lish for this user. This value is ignored if lish_auth_method is ‘disabled’.
two_factor_auth - If true, logins from untrusted computers will require Two Factor Authentication.
restricted - If true, the user has restrictions on what can be accessed on the Account.
referrals - Credit Card information associated with this Account.
referrals.0.total - The number of users who have signed up with the referral code.
referrals.0.credit - The amount of account credit in US Dollars issued to the account through the referral program.
referrals.0.completed - The number of completed signups with the referral code.
referrals.0.pending - The number of pending signups for the referral code. To receive credit the signups must be completed.
referrals.0.code - The Profile referral code. If new accounts use this when signing up for Linode, referring account will receive credit.
referrals.0.url - The referral URL.

pulumi_linode.get_region(country=None, id=None, opts=None)¶

.getRegion provides details about a specific Linode region. See all regions here.

import pulumi
import pulumi_linode as linode

region = linode.get_region(id="us-east")

pulumi_linode.get_ssh_key(label=None, opts=None)¶

.SshKey provides access to a specifically labeled SSH Key in the Profile of the User identified by the access token.

import pulumi
import pulumi_linode as linode

foo = linode.get_ssh_key(label="foo")

pulumi_linode.get_stack_script(id=None, user_defined_fields=None, opts=None)¶

Provides details about a specific Linode StackScript.

import pulumi

This resource exports the following attributes:

label - The StackScript’s label is for display purposes only.
script - The script to execute when provisioning a new Linode with this StackScript.
description - A description for the StackScript.
rev_note - This field allows you to add notes for the set of revisions made to this StackScript.
is_public - This determines whether other users can use your StackScript. Once a StackScript is made public, it cannot be made private.
images - An array of Image IDs representing the Images that this StackScript is compatible for deploying with.
deployments_active - Count of currently active, deployed Linodes created from this StackScript.
user_gravatar_id - The Gravatar ID for the User who created the StackScript.
deployments_total - The total number of times this StackScript has been deployed.
username - The User who created the StackScript.
created - The date this StackScript was created.
updated - The date this StackScript was updated.
user_defined_fields - This is a list of fields defined with a special syntax inside this StackScript that allow for supplying customized parameters during deployment.
- label - A human-readable label for the field that will serve as the input prompt for entering the value during deployment.
- name - The name of the field.
- example - An example value for the field.
- one_of - A list of acceptable single values for the field.
- many_of - A list of acceptable values for the field in any quantity, combination or order.
- default - The default value. If not specified, this value will be used.

Parameters: id (float) – The unique numeric ID of the StackScript to query.

The user_defined_fields object supports the following:

default (str)
example (str)
label (str)
manyOf (str)
name (str)
oneOf (str)

pulumi_linode.get_user(username=None, opts=None)¶

Provides information about a Linode user

import pulumi
import pulumi_linode as linode

foo = linode.get_user(username="foo")

The Linode User resource exports the following attributes:

ssh_keys - A list of SSH Key labels added by this User. These are the keys that will be deployed if this User is included in the authorized_users field of a create Linode, rebuild Linode, or create Disk request.
email - The email address for this User, for account management communications, and may be used for other communications as configured.
restricted - If true, this User must be granted access to perform actions or access entities on this Account.

Parameters: username (str) – The unique username of this User.

pulumi_linode.get_volume(id=None, opts=None)¶

Provides information about a Linode Volume.

import pulumi
import pulumi_linode as linode

foo = linode.get_volume(id="1234567")

The Linode Volume resource exports the following attributes:

id - The unique ID of this Volume.
created - When this Volume was created.
status - The current status of the Volume. Can be one of “creating”, “active”, “resizing”, or “contact_support”.
label - This Volume’s label is for display purposes only.
tags - An array of tags applied to this object.
size - The Volume’s size, in GiB.
region - The datacenter in which this Volume is located.
updated - When this Volume was last updated.
linode_id - If a Volume is attached to a specific Linode, the ID of that Linode will be displayed here. If the Volume is unattached, this value will be null.
filesystem_path - The full filesystem path for the Volume based on the Volume’s label. Path is /dev/disk/by-id/scsi-0LinodeVolume + Volume label.

The Pulumi Platform

Get Started

Migrate to Pulumi

Solutions for All Teams and Engineers

Any Code

Any Cloud

Pulumi Linode¶

On This Page