Skip to main content

configs

Overview

Nameconfigs
TypeResource
Idlinode.instances.configs

Fields

NameDatatypeDescription
idintegerThe ID of this Config.
commentsstringOptional field for arbitrary User comments on this Config.
devicesobjectA dictionary of device disks to use as a device map in a Linode's configuration profile.
An empty device disk dictionary or a dictionary with empty values for device slots is allowed.
If no devices are specified, booting from this configuration will hold until a device exists that allows the boot process to start.
helpersobjectHelpers enabled when booting to this Linode Config.
interfacesarrayAn array of Network Interfaces to add to this Linode's Configuration Profile.

Up to three interface objects can be entered in this array. The position in the array determines the interface to which the settings apply:

- First/0: eth0
- Second/1: eth1
- Third/2: eth2

When updating a Linode's interfaces, each interface must be redefined. An empty interfaces array results in a default public interface configuration only.

If no public interface is configured, public IP addresses are still assigned to the Linode but will not be usable without manual configuration.

Note: Changes to Linode interface configurations can be enabled by rebooting the Linode.

Note: Only Next Generation Network (NGN) data centers support VLANs. Use the Regions (/regions) endpoint to view the capabilities of data center regions.
If a VLAN is attached to your Linode and you attempt to migrate or clone it to a non-NGN data center,
the migration or cloning will not initiate. If a Linode cannot be migrated because of an incompatibility,
you will be prompted to select a different data center or contact support.

Note: See the VLANs Overview guide to view additional specifications and limitations.
kernelstringA Kernel ID to boot a Linode with. Defaults to "linode/latest-64bit".
labelstringThe Config's label is for display purposes only.
memory_limitintegerDefaults to the total RAM of the Linode.
root_devicestringThe root device to boot.
If no value or an invalid value is provided, root device will default to /dev/sda.
If the device specified at the root device location is not mounted, the Linode will not boot until a device is mounted.
run_levelstringDefines the state of your Linode after booting. Defaults to default.
virt_modestringControls the virtualization mode. Defaults to paravirt.
paravirt is suitable for most cases. Linodes running in paravirt mode
share some qualities with the host, ultimately making it run faster since
there is less transition between it and the host.
fullvirt affords more customization, but is slower because 100% of the VM
is virtualized.

Methods

NameAccessible byRequired ParamsDescription
getLinodeConfigSELECTconfigId, linodeIdReturns information about a specific Configuration profile.
getLinodeConfigsSELECTlinodeIdLists Configuration profiles associated with a Linode.
addLinodeConfigINSERTlinodeId, data__devices, data__labelAdds a new Configuration profile to a Linode.
deleteLinodeConfigDELETEconfigId, linodeIdDeletes the specified Configuration profile from the specified Linode.
_getLinodeConfigEXECconfigId, linodeIdReturns information about a specific Configuration profile.
_getLinodeConfigsEXEClinodeIdLists Configuration profiles associated with a Linode.
updateLinodeConfigEXECconfigId, linodeIdUpdates a Configuration profile.