This package is deprecated. We recommend using the new Equinix package.
equinix-metal.Device
Explore with Pulumi AI
This package is deprecated. We recommend using the new Equinix package.
Provides an Equinix Metal device resource. This can be used to create, modify, and delete devices.
Note: All arguments including the
root_password
anduser_data
will be stored in the raw state as plain-text. Read more about sensitive data in state.
Example Usage
Create a device and add it to cool_
using Pulumi;
using EquinixMetal = Pulumi.EquinixMetal;
class MyStack : Stack
{
public MyStack()
{
var web1 = new EquinixMetal.Device("web1", new EquinixMetal.DeviceArgs
{
Hostname = "tf.coreos2",
Plan = "c3.small.x86",
Metro = "sv",
OperatingSystem = "ubuntu_20_04",
BillingCycle = "hourly",
ProjectId = local.Project_id,
});
}
}
package main
import (
"github.com/pulumi/pulumi-equinix-metal/sdk/v3/go/equinix-metal"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := equinix - metal.NewDevice(ctx, "web1", &equinix-metal.DeviceArgs{
Hostname: pulumi.String("tf.coreos2"),
Plan: pulumi.String("c3.small.x86"),
Metro: pulumi.String("sv"),
OperatingSystem: pulumi.String("ubuntu_20_04"),
BillingCycle: pulumi.String("hourly"),
ProjectId: pulumi.Any(local.Project_id),
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_equinix_metal as equinix_metal
web1 = equinix_metal.Device("web1",
hostname="tf.coreos2",
plan="c3.small.x86",
metro="sv",
operating_system="ubuntu_20_04",
billing_cycle="hourly",
project_id=local["project_id"])
import * as pulumi from "@pulumi/pulumi";
import * as equinix_metal from "@pulumi/equinix-metal";
const web1 = new equinix_metal.Device("web1", {
hostname: "tf.coreos2",
plan: "c3.small.x86",
metro: "sv",
operatingSystem: "ubuntu_20_04",
billingCycle: "hourly",
projectId: local.project_id,
});
Coming soon!
Same as above, but boot via iPXE initially, using the Ignition Provider for provisioning
using Pulumi;
using EquinixMetal = Pulumi.EquinixMetal;
class MyStack : Stack
{
public MyStack()
{
var pxe1 = new EquinixMetal.Device("pxe1", new EquinixMetal.DeviceArgs
{
Hostname = "tf.coreos2-pxe",
Plan = "c3.small.x86",
Metro = "sv",
OperatingSystem = "custom_ipxe",
BillingCycle = "hourly",
ProjectId = local.Project_id,
IpxeScriptUrl = "https://rawgit.com/cloudnativelabs/pxe/master/metal/coreos-stable-metal.ipxe",
AlwaysPxe = false,
UserData = data.Ignition_config.Example.Rendered,
});
}
}
package main
import (
"github.com/pulumi/pulumi-equinix-metal/sdk/v3/go/equinix-metal"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := equinix - metal.NewDevice(ctx, "pxe1", &equinix-metal.DeviceArgs{
Hostname: pulumi.String("tf.coreos2-pxe"),
Plan: pulumi.String("c3.small.x86"),
Metro: pulumi.String("sv"),
OperatingSystem: pulumi.String("custom_ipxe"),
BillingCycle: pulumi.String("hourly"),
ProjectId: pulumi.Any(local.Project_id),
IpxeScriptUrl: pulumi.String("https://rawgit.com/cloudnativelabs/pxe/master/metal/coreos-stable-metal.ipxe"),
AlwaysPxe: pulumi.Bool(false),
UserData: pulumi.Any(data.Ignition_config.Example.Rendered),
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_equinix_metal as equinix_metal
pxe1 = equinix_metal.Device("pxe1",
hostname="tf.coreos2-pxe",
plan="c3.small.x86",
metro="sv",
operating_system="custom_ipxe",
billing_cycle="hourly",
project_id=local["project_id"],
ipxe_script_url="https://rawgit.com/cloudnativelabs/pxe/master/metal/coreos-stable-metal.ipxe",
always_pxe=False,
user_data=data["ignition_config"]["example"]["rendered"])
import * as pulumi from "@pulumi/pulumi";
import * as equinix_metal from "@pulumi/equinix-metal";
const pxe1 = new equinix_metal.Device("pxe1", {
hostname: "tf.coreos2-pxe",
plan: "c3.small.x86",
metro: "sv",
operatingSystem: "custom_ipxe",
billingCycle: "hourly",
projectId: local.project_id,
ipxeScriptUrl: "https://rawgit.com/cloudnativelabs/pxe/master/metal/coreos-stable-metal.ipxe",
alwaysPxe: "false",
userData: data.ignition_config.example.rendered,
});
Coming soon!
Create a device without a public IP address in facility ny5, with only a /30 private IPv4 subnet (4 IP addresses)
using Pulumi;
using EquinixMetal = Pulumi.EquinixMetal;
class MyStack : Stack
{
public MyStack()
{
var web1 = new EquinixMetal.Device("web1", new EquinixMetal.DeviceArgs
{
Hostname = "tf.coreos2",
Plan = "c3.small.x86",
Facilities =
{
"ny5",
},
OperatingSystem = "ubuntu_20_04",
BillingCycle = "hourly",
ProjectId = local.Project_id,
IpAddresses =
{
new EquinixMetal.Inputs.DeviceIpAddressArgs
{
Type = "private_ipv4",
Cidr = 30,
},
},
});
}
}
package main
import (
"github.com/pulumi/pulumi-equinix-metal/sdk/v3/go/equinix-metal"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := equinix - metal.NewDevice(ctx, "web1", &equinix-metal.DeviceArgs{
Hostname: pulumi.String("tf.coreos2"),
Plan: pulumi.String("c3.small.x86"),
Facilities: pulumi.StringArray{
pulumi.String("ny5"),
},
OperatingSystem: pulumi.String("ubuntu_20_04"),
BillingCycle: pulumi.String("hourly"),
ProjectId: pulumi.Any(local.Project_id),
IpAddresses: DeviceIpAddressArray{
&DeviceIpAddressArgs{
Type: pulumi.String("private_ipv4"),
Cidr: pulumi.Int(30),
},
},
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_equinix_metal as equinix_metal
web1 = equinix_metal.Device("web1",
hostname="tf.coreos2",
plan="c3.small.x86",
facilities=["ny5"],
operating_system="ubuntu_20_04",
billing_cycle="hourly",
project_id=local["project_id"],
ip_addresses=[equinix_metal.DeviceIpAddressArgs(
type="private_ipv4",
cidr=30,
)])
import * as pulumi from "@pulumi/pulumi";
import * as equinix_metal from "@pulumi/equinix-metal";
const web1 = new equinix_metal.Device("web1", {
hostname: "tf.coreos2",
plan: "c3.small.x86",
facilities: ["ny5"],
operatingSystem: "ubuntu_20_04",
billingCycle: "hourly",
projectId: local.project_id,
ipAddresses: [{
type: "private_ipv4",
cidr: 30,
}],
});
Coming soon!
Deploy device on next-available reserved hardware and do custom partitioning.
using Pulumi;
using EquinixMetal = Pulumi.EquinixMetal;
class MyStack : Stack
{
public MyStack()
{
var web1 = new EquinixMetal.Device("web1", new EquinixMetal.DeviceArgs
{
Hostname = "tftest",
Plan = "c3.small.x86",
Facilities =
{
"ny5",
},
OperatingSystem = "ubuntu_20_04",
BillingCycle = "hourly",
ProjectId = local.Project_id,
HardwareReservationId = "next-available",
Storage = @"{
""disks"": [
{
""device"": ""/dev/sda"",
""wipeTable"": true,
""partitions"": [
{
""label"": ""BIOS"",
""number"": 1,
""size"": ""4096""
},
{
""label"": ""SWAP"",
""number"": 2,
""size"": ""3993600""
},
{
""label"": ""ROOT"",
""number"": 3,
""size"": ""0""
}
]
}
],
""filesystems"": [
{
""mount"": {
""device"": ""/dev/sda3"",
""format"": ""ext4"",
""point"": ""/"",
""create"": {
""options"": [
""-L"",
""ROOT""
]
}
}
},
{
""mount"": {
""device"": ""/dev/sda2"",
""format"": ""swap"",
""point"": ""none"",
""create"": {
""options"": [
""-L"",
""SWAP""
]
}
}
}
]
}
",
});
}
}
package main
import (
"fmt"
"github.com/pulumi/pulumi-equinix-metal/sdk/v3/go/equinix-metal"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := equinix - metal.NewDevice(ctx, "web1", &equinix-metal.DeviceArgs{
Hostname: pulumi.String("tftest"),
Plan: pulumi.String("c3.small.x86"),
Facilities: pulumi.StringArray{
pulumi.String("ny5"),
},
OperatingSystem: pulumi.String("ubuntu_20_04"),
BillingCycle: pulumi.String("hourly"),
ProjectId: pulumi.Any(local.Project_id),
HardwareReservationId: pulumi.String("next-available"),
Storage: pulumi.String(fmt.Sprintf("%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v%v", "{\n", " \"disks\": [\n", " {\n", " \"device\": \"/dev/sda\",\n", " \"wipeTable\": true,\n", " \"partitions\": [\n", " {\n", " \"label\": \"BIOS\",\n", " \"number\": 1,\n", " \"size\": \"4096\"\n", " },\n", " {\n", " \"label\": \"SWAP\",\n", " \"number\": 2,\n", " \"size\": \"3993600\"\n", " },\n", " {\n", " \"label\": \"ROOT\",\n", " \"number\": 3,\n", " \"size\": \"0\"\n", " }\n", " ]\n", " }\n", " ],\n", " \"filesystems\": [\n", " {\n", " \"mount\": {\n", " \"device\": \"/dev/sda3\",\n", " \"format\": \"ext4\",\n", " \"point\": \"/\",\n", " \"create\": {\n", " \"options\": [\n", " \"-L\",\n", " \"ROOT\"\n", " ]\n", " }\n", " }\n", " },\n", " {\n", " \"mount\": {\n", " \"device\": \"/dev/sda2\",\n", " \"format\": \"swap\",\n", " \"point\": \"none\",\n", " \"create\": {\n", " \"options\": [\n", " \"-L\",\n", " \"SWAP\"\n", " ]\n", " }\n", " }\n", " }\n", " ]\n", "}\n")),
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_equinix_metal as equinix_metal
web1 = equinix_metal.Device("web1",
hostname="tftest",
plan="c3.small.x86",
facilities=["ny5"],
operating_system="ubuntu_20_04",
billing_cycle="hourly",
project_id=local["project_id"],
hardware_reservation_id="next-available",
storage="""{
"disks": [
{
"device": "/dev/sda",
"wipeTable": true,
"partitions": [
{
"label": "BIOS",
"number": 1,
"size": "4096"
},
{
"label": "SWAP",
"number": 2,
"size": "3993600"
},
{
"label": "ROOT",
"number": 3,
"size": "0"
}
]
}
],
"filesystems": [
{
"mount": {
"device": "/dev/sda3",
"format": "ext4",
"point": "/",
"create": {
"options": [
"-L",
"ROOT"
]
}
}
},
{
"mount": {
"device": "/dev/sda2",
"format": "swap",
"point": "none",
"create": {
"options": [
"-L",
"SWAP"
]
}
}
}
]
}
""")
import * as pulumi from "@pulumi/pulumi";
import * as equinix_metal from "@pulumi/equinix-metal";
const web1 = new equinix_metal.Device("web1", {
hostname: "tftest",
plan: "c3.small.x86",
facilities: ["ny5"],
operatingSystem: "ubuntu_20_04",
billingCycle: "hourly",
projectId: local.project_id,
hardwareReservationId: "next-available",
storage: `{
"disks": [
{
"device": "/dev/sda",
"wipeTable": true,
"partitions": [
{
"label": "BIOS",
"number": 1,
"size": "4096"
},
{
"label": "SWAP",
"number": 2,
"size": "3993600"
},
{
"label": "ROOT",
"number": 3,
"size": "0"
}
]
}
],
"filesystems": [
{
"mount": {
"device": "/dev/sda3",
"format": "ext4",
"point": "/",
"create": {
"options": [
"-L",
"ROOT"
]
}
}
},
{
"mount": {
"device": "/dev/sda2",
"format": "swap",
"point": "none",
"create": {
"options": [
"-L",
"SWAP"
]
}
}
}
]
}
`,
});
Coming soon!
Create Device Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Device(name: string, args: DeviceArgs, opts?: CustomResourceOptions);
@overload
def Device(resource_name: str,
args: DeviceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Device(resource_name: str,
opts: Optional[ResourceOptions] = None,
operating_system: Optional[Union[str, OperatingSystem]] = None,
project_id: Optional[str] = None,
plan: Optional[Union[str, Plan]] = None,
metro: Optional[str] = None,
custom_data: Optional[str] = None,
force_detach_volumes: Optional[bool] = None,
hardware_reservation_id: Optional[str] = None,
hostname: Optional[str] = None,
ip_addresses: Optional[Sequence[DeviceIpAddressArgs]] = None,
ipxe_script_url: Optional[str] = None,
always_pxe: Optional[bool] = None,
description: Optional[str] = None,
facilities: Optional[Sequence[Union[str, Facility]]] = None,
billing_cycle: Optional[Union[str, BillingCycle]] = None,
project_ssh_key_ids: Optional[Sequence[str]] = None,
reinstall: Optional[DeviceReinstallArgs] = None,
storage: Optional[str] = None,
tags: Optional[Sequence[str]] = None,
termination_time: Optional[str] = None,
user_data: Optional[str] = None,
wait_for_reservation_deprovision: Optional[bool] = None)
func NewDevice(ctx *Context, name string, args DeviceArgs, opts ...ResourceOption) (*Device, error)
public Device(string name, DeviceArgs args, CustomResourceOptions? opts = null)
public Device(String name, DeviceArgs args)
public Device(String name, DeviceArgs args, CustomResourceOptions options)
type: equinix-metal:Device
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args DeviceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args DeviceArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args DeviceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DeviceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DeviceArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var deviceResource = new EquinixMetal.Device("deviceResource", new()
{
OperatingSystem = "string",
ProjectId = "string",
Plan = "string",
Metro = "string",
CustomData = "string",
ForceDetachVolumes = false,
HardwareReservationId = "string",
Hostname = "string",
IpAddresses = new[]
{
new EquinixMetal.Inputs.DeviceIpAddressArgs
{
Type = "string",
Cidr = 0,
ReservationIds = new[]
{
"string",
},
},
},
IpxeScriptUrl = "string",
AlwaysPxe = false,
Description = "string",
Facilities = new[]
{
"string",
},
BillingCycle = "string",
ProjectSshKeyIds = new[]
{
"string",
},
Reinstall = new EquinixMetal.Inputs.DeviceReinstallArgs
{
DeprovisionFast = false,
Enabled = false,
PreserveData = false,
},
Storage = "string",
Tags = new[]
{
"string",
},
TerminationTime = "string",
UserData = "string",
WaitForReservationDeprovision = false,
});
example, err := equinixmetal.NewDevice(ctx, "deviceResource", &equinixmetal.DeviceArgs{
OperatingSystem: pulumi.String("string"),
ProjectId: pulumi.String("string"),
Plan: pulumi.String("string"),
Metro: pulumi.String("string"),
CustomData: pulumi.String("string"),
ForceDetachVolumes: pulumi.Bool(false),
HardwareReservationId: pulumi.String("string"),
Hostname: pulumi.String("string"),
IpAddresses: equinix.DeviceIpAddressArray{
&equinix.DeviceIpAddressArgs{
Type: pulumi.String("string"),
Cidr: pulumi.Int(0),
ReservationIds: pulumi.StringArray{
pulumi.String("string"),
},
},
},
IpxeScriptUrl: pulumi.String("string"),
AlwaysPxe: pulumi.Bool(false),
Description: pulumi.String("string"),
Facilities: pulumi.StringArray{
pulumi.String("string"),
},
BillingCycle: pulumi.String("string"),
ProjectSshKeyIds: pulumi.StringArray{
pulumi.String("string"),
},
Reinstall: &equinix.DeviceReinstallArgs{
DeprovisionFast: pulumi.Bool(false),
Enabled: pulumi.Bool(false),
PreserveData: pulumi.Bool(false),
},
Storage: pulumi.String("string"),
Tags: pulumi.StringArray{
pulumi.String("string"),
},
TerminationTime: pulumi.String("string"),
UserData: pulumi.String("string"),
WaitForReservationDeprovision: pulumi.Bool(false),
})
var deviceResource = new Device("deviceResource", DeviceArgs.builder()
.operatingSystem("string")
.projectId("string")
.plan("string")
.metro("string")
.customData("string")
.forceDetachVolumes(false)
.hardwareReservationId("string")
.hostname("string")
.ipAddresses(DeviceIpAddressArgs.builder()
.type("string")
.cidr(0)
.reservationIds("string")
.build())
.ipxeScriptUrl("string")
.alwaysPxe(false)
.description("string")
.facilities("string")
.billingCycle("string")
.projectSshKeyIds("string")
.reinstall(DeviceReinstallArgs.builder()
.deprovisionFast(false)
.enabled(false)
.preserveData(false)
.build())
.storage("string")
.tags("string")
.terminationTime("string")
.userData("string")
.waitForReservationDeprovision(false)
.build());
device_resource = equinix_metal.Device("deviceResource",
operating_system="string",
project_id="string",
plan="string",
metro="string",
custom_data="string",
force_detach_volumes=False,
hardware_reservation_id="string",
hostname="string",
ip_addresses=[{
"type": "string",
"cidr": 0,
"reservation_ids": ["string"],
}],
ipxe_script_url="string",
always_pxe=False,
description="string",
facilities=["string"],
billing_cycle="string",
project_ssh_key_ids=["string"],
reinstall={
"deprovision_fast": False,
"enabled": False,
"preserve_data": False,
},
storage="string",
tags=["string"],
termination_time="string",
user_data="string",
wait_for_reservation_deprovision=False)
const deviceResource = new equinix_metal.Device("deviceResource", {
operatingSystem: "string",
projectId: "string",
plan: "string",
metro: "string",
customData: "string",
forceDetachVolumes: false,
hardwareReservationId: "string",
hostname: "string",
ipAddresses: [{
type: "string",
cidr: 0,
reservationIds: ["string"],
}],
ipxeScriptUrl: "string",
alwaysPxe: false,
description: "string",
facilities: ["string"],
billingCycle: "string",
projectSshKeyIds: ["string"],
reinstall: {
deprovisionFast: false,
enabled: false,
preserveData: false,
},
storage: "string",
tags: ["string"],
terminationTime: "string",
userData: "string",
waitForReservationDeprovision: false,
});
type: equinix-metal:Device
properties:
alwaysPxe: false
billingCycle: string
customData: string
description: string
facilities:
- string
forceDetachVolumes: false
hardwareReservationId: string
hostname: string
ipAddresses:
- cidr: 0
reservationIds:
- string
type: string
ipxeScriptUrl: string
metro: string
operatingSystem: string
plan: string
projectId: string
projectSshKeyIds:
- string
reinstall:
deprovisionFast: false
enabled: false
preserveData: false
storage: string
tags:
- string
terminationTime: string
userData: string
waitForReservationDeprovision: false
Device Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Device resource accepts the following input properties:
- Operating
System string | Pulumi.Equinix Metal. Operating System - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- Plan
string | Pulumi.
Equinix Metal. Plan - The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- Project
Id string - The ID of the project in which to create the device
- Always
Pxe bool - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - Billing
Cycle string | Pulumi.Equinix Metal. Billing Cycle - monthly or hourly
- Custom
Data string - A string of the desired Custom Data for the device.
- Description string
- The device description.
- Facilities
List<Union<string, Pulumi.
Equinix Metal. Facility>> - List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - Force
Detach boolVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- Hardware
Reservation stringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- Hostname string
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- Ip
Addresses List<Pulumi.Equinix Metal. Inputs. Device Ip Address> - A list of IP address types for the device (structure is documented below).
- Ipxe
Script stringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- Metro string
- Metro area for the new device. Conflicts with
facilities
. - Project
Ssh List<string>Key Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- Reinstall
Pulumi.
Equinix Metal. Inputs. Device Reinstall - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- Storage string
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- List<string>
- Tags attached to the device
- Termination
Time string - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - User
Data string - A string of the desired User Data for the device.
- Wait
For boolReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- Operating
System string | OperatingSystem - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- Plan string | Plan
- The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- Project
Id string - The ID of the project in which to create the device
- Always
Pxe bool - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - Billing
Cycle string | BillingCycle - monthly or hourly
- Custom
Data string - A string of the desired Custom Data for the device.
- Description string
- The device description.
- Facilities []string
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - Force
Detach boolVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- Hardware
Reservation stringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- Hostname string
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- Ip
Addresses []DeviceIp Address Args - A list of IP address types for the device (structure is documented below).
- Ipxe
Script stringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- Metro string
- Metro area for the new device. Conflicts with
facilities
. - Project
Ssh []stringKey Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- Reinstall
Device
Reinstall Args - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- Storage string
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- []string
- Tags attached to the device
- Termination
Time string - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - User
Data string - A string of the desired User Data for the device.
- Wait
For boolReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- operating
System String | OperatingSystem - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- plan String | Plan
- The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- project
Id String - The ID of the project in which to create the device
- always
Pxe Boolean - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - billing
Cycle String | BillingCycle - monthly or hourly
- custom
Data String - A string of the desired Custom Data for the device.
- description String
- The device description.
- facilities List<Either<String,Facility>>
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - force
Detach BooleanVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- hardware
Reservation StringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- hostname String
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- ip
Addresses List<DeviceIp Address> - A list of IP address types for the device (structure is documented below).
- ipxe
Script StringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- metro String
- Metro area for the new device. Conflicts with
facilities
. - project
Ssh List<String>Key Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- reinstall
Device
Reinstall - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- storage String
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- List<String>
- Tags attached to the device
- termination
Time String - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - user
Data String - A string of the desired User Data for the device.
- wait
For BooleanReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- operating
System string | OperatingSystem - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- plan string | Plan
- The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- project
Id string - The ID of the project in which to create the device
- always
Pxe boolean - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - billing
Cycle string | BillingCycle - monthly or hourly
- custom
Data string - A string of the desired Custom Data for the device.
- description string
- The device description.
- facilities (string | Facility)[]
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - force
Detach booleanVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- hardware
Reservation stringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- hostname string
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- ip
Addresses DeviceIp Address[] - A list of IP address types for the device (structure is documented below).
- ipxe
Script stringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- metro string
- Metro area for the new device. Conflicts with
facilities
. - project
Ssh string[]Key Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- reinstall
Device
Reinstall - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- storage string
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- string[]
- Tags attached to the device
- termination
Time string - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - user
Data string - A string of the desired User Data for the device.
- wait
For booleanReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- operating_
system str | OperatingSystem - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- plan str | Plan
- The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- project_
id str - The ID of the project in which to create the device
- always_
pxe bool - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - billing_
cycle str | BillingCycle - monthly or hourly
- custom_
data str - A string of the desired Custom Data for the device.
- description str
- The device description.
- facilities Sequence[Union[str, Facility]]
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - force_
detach_ boolvolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- hardware_
reservation_ strid - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- hostname str
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- ip_
addresses Sequence[DeviceIp Address Args] - A list of IP address types for the device (structure is documented below).
- ipxe_
script_ strurl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- metro str
- Metro area for the new device. Conflicts with
facilities
. - project_
ssh_ Sequence[str]key_ ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- reinstall
Device
Reinstall Args - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- storage str
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- Sequence[str]
- Tags attached to the device
- termination_
time str - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - user_
data str - A string of the desired User Data for the device.
- wait_
for_ boolreservation_ deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- operating
System String | "alpine_3" | "centos_6" | "centos_7" | "centos_8" | "coreos_alpha" | "coreos_ beta" | "coreos_ stable" | "custom_ ipxe" | "debian_8" | "debian_9" | "debian_10" | "flatcar_ alpha" | "flatcar_ beta" | "flatcar_ edge" | "flatcar_ stable" | "freebsd_10_4" | "freebsd_11_1" | "freebsd_11_2" | "freebsd_12_ testing" | "nixos_18_03" | "nixos_19_03" | "opensuse_42_3" | "rancher" | "rhel_7" | "rhel_8" | "scientific_6" | "suse_ sles12_ sp3" | "ubuntu_14_04" | "ubuntu_16_04" | "ubuntu_17_10" | "ubuntu_18_04" | "ubuntu_20_04" | "ubuntu_20_10" | "vmware_ esxi_6_5" | "vmware_ esxi_6_7" | "vmware_ esxi_7_0" | "windows_2012_ r2" | "windows_2016" | "windows_2019" - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- plan
String | "c2.large.arm" | "c2.medium.x86" | "baremetal_1" | "baremetal_2a" | "baremetal_3" | "x2.xlarge.x86" | "baremetal_1e" | "g2.large.x86" | "m2.xlarge.x86" | "baremetal_2" | "baremetal_0" | "baremetal_
s" | "c3.small.x86" | "c3.medium.x86" | "f3.medium.x86" | "f3.large.x86" | "m3.large.x86" | "s3.xlarge.x86" | "n2.xlarge.x86" - The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- project
Id String - The ID of the project in which to create the device
- always
Pxe Boolean - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - billing
Cycle String | "hourly" | "monthly" - monthly or hourly
- custom
Data String - A string of the desired Custom Data for the device.
- description String
- The device description.
- facilities List<String | "ewr1" | "sjc1" | "dfw1" | "dfw2" | "ams1" | "nrt1" | "sea1" | "lax1" | "ord1" | "atl1" | "iad1" | "sin1" | "hkg1" | "syd1" | "mrs1" | "yyz1" | "fra2" | "am6" | "dc13" | "ch3" | "da3" | "da11" | "la4" | "ny5" | "sg1" | "sv15">
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - force
Detach BooleanVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- hardware
Reservation StringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- hostname String
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- ip
Addresses List<Property Map> - A list of IP address types for the device (structure is documented below).
- ipxe
Script StringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- metro String
- Metro area for the new device. Conflicts with
facilities
. - project
Ssh List<String>Key Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- reinstall Property Map
- Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- storage String
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- List<String>
- Tags attached to the device
- termination
Time String - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - user
Data String - A string of the desired User Data for the device.
- wait
For BooleanReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
Outputs
All input properties are implicitly available as output properties. Additionally, the Device resource produces the following output properties:
- Access
Private stringIpv4 - The ipv4 private IP assigned to the device
- Access
Public stringIpv4 - The ipv4 maintenance IP assigned to the device
- Access
Public stringIpv6 - The ipv6 maintenance IP assigned to the device
- Created string
- The timestamp for when the device was created
- Deployed
Facility string - The facility where the device is deployed.
- Deployed
Hardware stringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - Id string
- The provider-assigned unique ID for this managed resource.
- Locked bool
- Whether the device is locked
- Network
Type string - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- Networks
List<Pulumi.
Equinix Metal. Outputs. Device Network> - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- Ports
List<Pulumi.
Equinix Metal. Outputs. Device Port> - Ports assigned to the device
- Root
Password string - Root password to the server (disabled after 24 hours)
- Ssh
Key List<string>Ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- State string
- The status of the device
- Updated string
- The timestamp for the last time the device was updated
- Access
Private stringIpv4 - The ipv4 private IP assigned to the device
- Access
Public stringIpv4 - The ipv4 maintenance IP assigned to the device
- Access
Public stringIpv6 - The ipv6 maintenance IP assigned to the device
- Created string
- The timestamp for when the device was created
- Deployed
Facility string - The facility where the device is deployed.
- Deployed
Hardware stringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - Id string
- The provider-assigned unique ID for this managed resource.
- Locked bool
- Whether the device is locked
- Network
Type string - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- Networks
[]Device
Network - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- Ports
[]Device
Port - Ports assigned to the device
- Root
Password string - Root password to the server (disabled after 24 hours)
- Ssh
Key []stringIds - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- State string
- The status of the device
- Updated string
- The timestamp for the last time the device was updated
- access
Private StringIpv4 - The ipv4 private IP assigned to the device
- access
Public StringIpv4 - The ipv4 maintenance IP assigned to the device
- access
Public StringIpv6 - The ipv6 maintenance IP assigned to the device
- created String
- The timestamp for when the device was created
- deployed
Facility String - The facility where the device is deployed.
- deployed
Hardware StringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - id String
- The provider-assigned unique ID for this managed resource.
- locked Boolean
- Whether the device is locked
- network
Type String - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- networks
List<Device
Network> - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- ports
List<Device
Port> - Ports assigned to the device
- root
Password String - Root password to the server (disabled after 24 hours)
- ssh
Key List<String>Ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- state String
- The status of the device
- updated String
- The timestamp for the last time the device was updated
- access
Private stringIpv4 - The ipv4 private IP assigned to the device
- access
Public stringIpv4 - The ipv4 maintenance IP assigned to the device
- access
Public stringIpv6 - The ipv6 maintenance IP assigned to the device
- created string
- The timestamp for when the device was created
- deployed
Facility string - The facility where the device is deployed.
- deployed
Hardware stringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - id string
- The provider-assigned unique ID for this managed resource.
- locked boolean
- Whether the device is locked
- network
Type string - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- networks
Device
Network[] - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- ports
Device
Port[] - Ports assigned to the device
- root
Password string - Root password to the server (disabled after 24 hours)
- ssh
Key string[]Ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- state string
- The status of the device
- updated string
- The timestamp for the last time the device was updated
- access_
private_ stripv4 - The ipv4 private IP assigned to the device
- access_
public_ stripv4 - The ipv4 maintenance IP assigned to the device
- access_
public_ stripv6 - The ipv6 maintenance IP assigned to the device
- created str
- The timestamp for when the device was created
- deployed_
facility str - The facility where the device is deployed.
- deployed_
hardware_ strreservation_ id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - id str
- The provider-assigned unique ID for this managed resource.
- locked bool
- Whether the device is locked
- network_
type str - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- networks
Sequence[Device
Network] - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- ports
Sequence[Device
Port] - Ports assigned to the device
- root_
password str - Root password to the server (disabled after 24 hours)
- ssh_
key_ Sequence[str]ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- state str
- The status of the device
- updated str
- The timestamp for the last time the device was updated
- access
Private StringIpv4 - The ipv4 private IP assigned to the device
- access
Public StringIpv4 - The ipv4 maintenance IP assigned to the device
- access
Public StringIpv6 - The ipv6 maintenance IP assigned to the device
- created String
- The timestamp for when the device was created
- deployed
Facility String - The facility where the device is deployed.
- deployed
Hardware StringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - id String
- The provider-assigned unique ID for this managed resource.
- locked Boolean
- Whether the device is locked
- network
Type String - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- networks List<Property Map>
- The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- ports List<Property Map>
- Ports assigned to the device
- root
Password String - Root password to the server (disabled after 24 hours)
- ssh
Key List<String>Ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- state String
- The status of the device
- updated String
- The timestamp for the last time the device was updated
Look up Existing Device Resource
Get an existing Device resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: DeviceState, opts?: CustomResourceOptions): Device
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
access_private_ipv4: Optional[str] = None,
access_public_ipv4: Optional[str] = None,
access_public_ipv6: Optional[str] = None,
always_pxe: Optional[bool] = None,
billing_cycle: Optional[Union[str, BillingCycle]] = None,
created: Optional[str] = None,
custom_data: Optional[str] = None,
deployed_facility: Optional[str] = None,
deployed_hardware_reservation_id: Optional[str] = None,
description: Optional[str] = None,
facilities: Optional[Sequence[Union[str, Facility]]] = None,
force_detach_volumes: Optional[bool] = None,
hardware_reservation_id: Optional[str] = None,
hostname: Optional[str] = None,
ip_addresses: Optional[Sequence[DeviceIpAddressArgs]] = None,
ipxe_script_url: Optional[str] = None,
locked: Optional[bool] = None,
metro: Optional[str] = None,
network_type: Optional[Union[str, NetworkType]] = None,
networks: Optional[Sequence[DeviceNetworkArgs]] = None,
operating_system: Optional[Union[str, OperatingSystem]] = None,
plan: Optional[Union[str, Plan]] = None,
ports: Optional[Sequence[DevicePortArgs]] = None,
project_id: Optional[str] = None,
project_ssh_key_ids: Optional[Sequence[str]] = None,
reinstall: Optional[DeviceReinstallArgs] = None,
root_password: Optional[str] = None,
ssh_key_ids: Optional[Sequence[str]] = None,
state: Optional[str] = None,
storage: Optional[str] = None,
tags: Optional[Sequence[str]] = None,
termination_time: Optional[str] = None,
updated: Optional[str] = None,
user_data: Optional[str] = None,
wait_for_reservation_deprovision: Optional[bool] = None) -> Device
func GetDevice(ctx *Context, name string, id IDInput, state *DeviceState, opts ...ResourceOption) (*Device, error)
public static Device Get(string name, Input<string> id, DeviceState? state, CustomResourceOptions? opts = null)
public static Device get(String name, Output<String> id, DeviceState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Access
Private stringIpv4 - The ipv4 private IP assigned to the device
- Access
Public stringIpv4 - The ipv4 maintenance IP assigned to the device
- Access
Public stringIpv6 - The ipv6 maintenance IP assigned to the device
- Always
Pxe bool - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - Billing
Cycle string | Pulumi.Equinix Metal. Billing Cycle - monthly or hourly
- Created string
- The timestamp for when the device was created
- Custom
Data string - A string of the desired Custom Data for the device.
- Deployed
Facility string - The facility where the device is deployed.
- Deployed
Hardware stringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - Description string
- The device description.
- Facilities
List<Union<string, Pulumi.
Equinix Metal. Facility>> - List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - Force
Detach boolVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- Hardware
Reservation stringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- Hostname string
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- Ip
Addresses List<Pulumi.Equinix Metal. Inputs. Device Ip Address> - A list of IP address types for the device (structure is documented below).
- Ipxe
Script stringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- Locked bool
- Whether the device is locked
- Metro string
- Metro area for the new device. Conflicts with
facilities
. - Network
Type string | Pulumi.Equinix Metal. Network Type - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- Networks
List<Pulumi.
Equinix Metal. Inputs. Device Network> - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- Operating
System string | Pulumi.Equinix Metal. Operating System - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- Plan
string | Pulumi.
Equinix Metal. Plan - The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- Ports
List<Pulumi.
Equinix Metal. Inputs. Device Port> - Ports assigned to the device
- Project
Id string - The ID of the project in which to create the device
- Project
Ssh List<string>Key Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- Reinstall
Pulumi.
Equinix Metal. Inputs. Device Reinstall - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- Root
Password string - Root password to the server (disabled after 24 hours)
- Ssh
Key List<string>Ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- State string
- The status of the device
- Storage string
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- List<string>
- Tags attached to the device
- Termination
Time string - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - Updated string
- The timestamp for the last time the device was updated
- User
Data string - A string of the desired User Data for the device.
- Wait
For boolReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- Access
Private stringIpv4 - The ipv4 private IP assigned to the device
- Access
Public stringIpv4 - The ipv4 maintenance IP assigned to the device
- Access
Public stringIpv6 - The ipv6 maintenance IP assigned to the device
- Always
Pxe bool - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - Billing
Cycle string | BillingCycle - monthly or hourly
- Created string
- The timestamp for when the device was created
- Custom
Data string - A string of the desired Custom Data for the device.
- Deployed
Facility string - The facility where the device is deployed.
- Deployed
Hardware stringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - Description string
- The device description.
- Facilities []string
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - Force
Detach boolVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- Hardware
Reservation stringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- Hostname string
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- Ip
Addresses []DeviceIp Address Args - A list of IP address types for the device (structure is documented below).
- Ipxe
Script stringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- Locked bool
- Whether the device is locked
- Metro string
- Metro area for the new device. Conflicts with
facilities
. - Network
Type string | NetworkType - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- Networks
[]Device
Network Args - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- Operating
System string | OperatingSystem - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- Plan string | Plan
- The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- Ports
[]Device
Port Args - Ports assigned to the device
- Project
Id string - The ID of the project in which to create the device
- Project
Ssh []stringKey Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- Reinstall
Device
Reinstall Args - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- Root
Password string - Root password to the server (disabled after 24 hours)
- Ssh
Key []stringIds - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- State string
- The status of the device
- Storage string
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- []string
- Tags attached to the device
- Termination
Time string - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - Updated string
- The timestamp for the last time the device was updated
- User
Data string - A string of the desired User Data for the device.
- Wait
For boolReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- access
Private StringIpv4 - The ipv4 private IP assigned to the device
- access
Public StringIpv4 - The ipv4 maintenance IP assigned to the device
- access
Public StringIpv6 - The ipv6 maintenance IP assigned to the device
- always
Pxe Boolean - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - billing
Cycle String | BillingCycle - monthly or hourly
- created String
- The timestamp for when the device was created
- custom
Data String - A string of the desired Custom Data for the device.
- deployed
Facility String - The facility where the device is deployed.
- deployed
Hardware StringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - description String
- The device description.
- facilities List<Either<String,Facility>>
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - force
Detach BooleanVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- hardware
Reservation StringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- hostname String
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- ip
Addresses List<DeviceIp Address> - A list of IP address types for the device (structure is documented below).
- ipxe
Script StringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- locked Boolean
- Whether the device is locked
- metro String
- Metro area for the new device. Conflicts with
facilities
. - network
Type String | NetworkType - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- networks
List<Device
Network> - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- operating
System String | OperatingSystem - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- plan String | Plan
- The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- ports
List<Device
Port> - Ports assigned to the device
- project
Id String - The ID of the project in which to create the device
- project
Ssh List<String>Key Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- reinstall
Device
Reinstall - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- root
Password String - Root password to the server (disabled after 24 hours)
- ssh
Key List<String>Ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- state String
- The status of the device
- storage String
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- List<String>
- Tags attached to the device
- termination
Time String - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - updated String
- The timestamp for the last time the device was updated
- user
Data String - A string of the desired User Data for the device.
- wait
For BooleanReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- access
Private stringIpv4 - The ipv4 private IP assigned to the device
- access
Public stringIpv4 - The ipv4 maintenance IP assigned to the device
- access
Public stringIpv6 - The ipv6 maintenance IP assigned to the device
- always
Pxe boolean - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - billing
Cycle string | BillingCycle - monthly or hourly
- created string
- The timestamp for when the device was created
- custom
Data string - A string of the desired Custom Data for the device.
- deployed
Facility string - The facility where the device is deployed.
- deployed
Hardware stringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - description string
- The device description.
- facilities (string | Facility)[]
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - force
Detach booleanVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- hardware
Reservation stringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- hostname string
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- ip
Addresses DeviceIp Address[] - A list of IP address types for the device (structure is documented below).
- ipxe
Script stringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- locked boolean
- Whether the device is locked
- metro string
- Metro area for the new device. Conflicts with
facilities
. - network
Type string | NetworkType - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- networks
Device
Network[] - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- operating
System string | OperatingSystem - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- plan string | Plan
- The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- ports
Device
Port[] - Ports assigned to the device
- project
Id string - The ID of the project in which to create the device
- project
Ssh string[]Key Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- reinstall
Device
Reinstall - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- root
Password string - Root password to the server (disabled after 24 hours)
- ssh
Key string[]Ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- state string
- The status of the device
- storage string
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- string[]
- Tags attached to the device
- termination
Time string - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - updated string
- The timestamp for the last time the device was updated
- user
Data string - A string of the desired User Data for the device.
- wait
For booleanReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- access_
private_ stripv4 - The ipv4 private IP assigned to the device
- access_
public_ stripv4 - The ipv4 maintenance IP assigned to the device
- access_
public_ stripv6 - The ipv6 maintenance IP assigned to the device
- always_
pxe bool - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - billing_
cycle str | BillingCycle - monthly or hourly
- created str
- The timestamp for when the device was created
- custom_
data str - A string of the desired Custom Data for the device.
- deployed_
facility str - The facility where the device is deployed.
- deployed_
hardware_ strreservation_ id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - description str
- The device description.
- facilities Sequence[Union[str, Facility]]
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - force_
detach_ boolvolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- hardware_
reservation_ strid - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- hostname str
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- ip_
addresses Sequence[DeviceIp Address Args] - A list of IP address types for the device (structure is documented below).
- ipxe_
script_ strurl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- locked bool
- Whether the device is locked
- metro str
- Metro area for the new device. Conflicts with
facilities
. - network_
type str | NetworkType - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- networks
Sequence[Device
Network Args] - The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- operating_
system str | OperatingSystem - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- plan str | Plan
- The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- ports
Sequence[Device
Port Args] - Ports assigned to the device
- project_
id str - The ID of the project in which to create the device
- project_
ssh_ Sequence[str]key_ ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- reinstall
Device
Reinstall Args - Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- root_
password str - Root password to the server (disabled after 24 hours)
- ssh_
key_ Sequence[str]ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- state str
- The status of the device
- storage str
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- Sequence[str]
- Tags attached to the device
- termination_
time str - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - updated str
- The timestamp for the last time the device was updated
- user_
data str - A string of the desired User Data for the device.
- wait_
for_ boolreservation_ deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
- access
Private StringIpv4 - The ipv4 private IP assigned to the device
- access
Public StringIpv4 - The ipv4 maintenance IP assigned to the device
- access
Public StringIpv6 - The ipv6 maintenance IP assigned to the device
- always
Pxe Boolean - If true, a device with OS
custom_ipxe
will continue to boot via iPXE on reboots. - billing
Cycle String | "hourly" | "monthly" - monthly or hourly
- created String
- The timestamp for when the device was created
- custom
Data String - A string of the desired Custom Data for the device.
- deployed
Facility String - The facility where the device is deployed.
- deployed
Hardware StringReservation Id - ID of hardware reservation where this device was deployed. It is useful when using the
next-available
hardware reservation. - description String
- The device description.
- facilities List<String | "ewr1" | "sjc1" | "dfw1" | "dfw2" | "ams1" | "nrt1" | "sea1" | "lax1" | "ord1" | "atl1" | "iad1" | "sin1" | "hkg1" | "syd1" | "mrs1" | "yyz1" | "fra2" | "am6" | "dc13" | "ch3" | "da3" | "da11" | "la4" | "ny5" | "sg1" | "sv15">
- List of facility codes with deployment preferences. Equinix Metal API will go through the list and will deploy your device to first facility with free capacity. List items must be facility codes or
any
(a wildcard). To find the facility code, visit Facilities API docs, set your API auth token in the top of the page and see JSON from the API response. Conflicts withmetro
. - force
Detach BooleanVolumes - Delete device even if it has volumes attached. Only applies for destroy action.
- hardware
Reservation StringId - The UUID of the hardware reservation where you want this device deployed, or next-available if you want to pick your next available reservation automatically
- hostname String
- The device hostname used in deployments taking advantage of Layer3 DHCP or metadata service configuration.
- ip
Addresses List<Property Map> - A list of IP address types for the device (structure is documented below).
- ipxe
Script StringUrl - URL pointing to a hosted iPXE script. More information is in the Custom iPXE doc.
- locked Boolean
- Whether the device is locked
- metro String
- Metro area for the new device. Conflicts with
facilities
. - network
Type String | "layer3" | "layer2-individual" | "layer2-bonded" | "hybrid" - Network type of a device, used in Layer 2 networking. Will be one of layer3, hybrid, hybrid-bonded, layer2-individual, layer2-bonded
- networks List<Property Map>
- The device's private and public IP (v4 and v6) network details. When a device is run without any special network configuration, it will have 3 networks:
- Public IPv4 at
metal_device.name.network.0
- IPv6 at
metal_device.name.network.1
- Private IPv4 at
metal_device.name.network.2
Elastic addresses then stack by type - an assigned public IPv4 will go after the management public IPv4 (to index 1), and will then shift the indices of the IPv6 and private IPv4. Assigned private IPv4 will go after the management private IPv4 (to the end of the network list). The fields of the network attributes are:
- Public IPv4 at
- operating
System String | "alpine_3" | "centos_6" | "centos_7" | "centos_8" | "coreos_alpha" | "coreos_ beta" | "coreos_ stable" | "custom_ ipxe" | "debian_8" | "debian_9" | "debian_10" | "flatcar_ alpha" | "flatcar_ beta" | "flatcar_ edge" | "flatcar_ stable" | "freebsd_10_4" | "freebsd_11_1" | "freebsd_11_2" | "freebsd_12_ testing" | "nixos_18_03" | "nixos_19_03" | "opensuse_42_3" | "rancher" | "rhel_7" | "rhel_8" | "scientific_6" | "suse_ sles12_ sp3" | "ubuntu_14_04" | "ubuntu_16_04" | "ubuntu_17_10" | "ubuntu_18_04" | "ubuntu_20_04" | "ubuntu_20_10" | "vmware_ esxi_6_5" | "vmware_ esxi_6_7" | "vmware_ esxi_7_0" | "windows_2012_ r2" | "windows_2016" | "windows_2019" - The operating system slug. To find the slug, or visit Operating Systems API docs, set your API auth token in the top of the page and see JSON from the API response.
- plan
String | "c2.large.arm" | "c2.medium.x86" | "baremetal_1" | "baremetal_2a" | "baremetal_3" | "x2.xlarge.x86" | "baremetal_1e" | "g2.large.x86" | "m2.xlarge.x86" | "baremetal_2" | "baremetal_0" | "baremetal_
s" | "c3.small.x86" | "c3.medium.x86" | "f3.medium.x86" | "f3.large.x86" | "m3.large.x86" | "s3.xlarge.x86" | "n2.xlarge.x86" - The device plan slug. To find the plan slug, visit Device plans API docs, set your auth token in the top of the page and see JSON from the API response.
- ports List<Property Map>
- Ports assigned to the device
- project
Id String - The ID of the project in which to create the device
- project
Ssh List<String>Key Ids - Array of IDs of the project SSH keys which should be added to the device. If you omit this, SSH keys of all the members of the parent project will be added to the device. If you specify this array, only the listed project SSH keys will be added. Project SSH keys can be created with the equinix-metal.ProjectSshKey resource.
- reinstall Property Map
- Whether the device should be reinstalled instead of destroyed when modifying user_data, custom_data, or operating system.
- root
Password String - Root password to the server (disabled after 24 hours)
- ssh
Key List<String>Ids - List of IDs of SSH keys deployed in the device, can be both user and project SSH keys
- state String
- The status of the device
- storage String
- JSON for custom partitioning. Only usable on reserved hardware. More information in in the Custom Partitioning and RAID doc. Please note that the disks.partitions.size attribute must be a string, not an integer. It can be a number string, or size notation string, e.g. "4G" or "8M" (for gigabytes and megabytes).
- List<String>
- Tags attached to the device
- termination
Time String - Timestamp for device termination. For example
2021-09-03T16:32:00+03:00
. If you don't supply timezone info, timestamp is assumed to be in UTC. - updated String
- The timestamp for the last time the device was updated
- user
Data String - A string of the desired User Data for the device.
- wait
For BooleanReservation Deprovision - Only used for devices in reserved hardware. If set, the deletion of this device will block until the hardware reservation is marked provisionable (about 4 minutes in August 2019).
Supporting Types
BillingCycle, BillingCycleArgs
- Hourly
- hourly
- Monthly
- monthly
- Billing
Cycle Hourly - hourly
- Billing
Cycle Monthly - monthly
- Hourly
- hourly
- Monthly
- monthly
- Hourly
- hourly
- Monthly
- monthly
- HOURLY
- hourly
- MONTHLY
- monthly
- "hourly"
- hourly
- "monthly"
- monthly
DeviceIpAddress, DeviceIpAddressArgs
- Type string
- One of [
private_ipv4
,public_ipv4
,public_ipv6
] - Cidr int
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- Reservation
Ids List<string> - List of UUIDs of IP block reservations from which the public IPv4 address should be taken.
- Type string
- One of [
private_ipv4
,public_ipv4
,public_ipv6
] - Cidr int
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- Reservation
Ids []string - List of UUIDs of IP block reservations from which the public IPv4 address should be taken.
- type String
- One of [
private_ipv4
,public_ipv4
,public_ipv6
] - cidr Integer
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- reservation
Ids List<String> - List of UUIDs of IP block reservations from which the public IPv4 address should be taken.
- type string
- One of [
private_ipv4
,public_ipv4
,public_ipv6
] - cidr number
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- reservation
Ids string[] - List of UUIDs of IP block reservations from which the public IPv4 address should be taken.
- type str
- One of [
private_ipv4
,public_ipv4
,public_ipv6
] - cidr int
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- reservation_
ids Sequence[str] - List of UUIDs of IP block reservations from which the public IPv4 address should be taken.
- type String
- One of [
private_ipv4
,public_ipv4
,public_ipv6
] - cidr Number
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- reservation
Ids List<String> - List of UUIDs of IP block reservations from which the public IPv4 address should be taken.
DeviceNetwork, DeviceNetworkArgs
- Address string
- IPv4 or IPv6 address string
- Cidr int
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- Family int
- IP version - "4" or "6"
network_type
Network type of a device, used in Layer 2 networking. Will be one oflayer3
,hybrid
,layer2-individual
andlayer2-bonded
.
- Gateway string
- address of router
- Public bool
- whether the address is routable from the Internet
- Address string
- IPv4 or IPv6 address string
- Cidr int
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- Family int
- IP version - "4" or "6"
network_type
Network type of a device, used in Layer 2 networking. Will be one oflayer3
,hybrid
,layer2-individual
andlayer2-bonded
.
- Gateway string
- address of router
- Public bool
- whether the address is routable from the Internet
- address String
- IPv4 or IPv6 address string
- cidr Integer
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- family Integer
- IP version - "4" or "6"
network_type
Network type of a device, used in Layer 2 networking. Will be one oflayer3
,hybrid
,layer2-individual
andlayer2-bonded
.
- gateway String
- address of router
- public_ Boolean
- whether the address is routable from the Internet
- address string
- IPv4 or IPv6 address string
- cidr number
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- family number
- IP version - "4" or "6"
network_type
Network type of a device, used in Layer 2 networking. Will be one oflayer3
,hybrid
,layer2-individual
andlayer2-bonded
.
- gateway string
- address of router
- public boolean
- whether the address is routable from the Internet
- address str
- IPv4 or IPv6 address string
- cidr int
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- family int
- IP version - "4" or "6"
network_type
Network type of a device, used in Layer 2 networking. Will be one oflayer3
,hybrid
,layer2-individual
andlayer2-bonded
.
- gateway str
- address of router
- public bool
- whether the address is routable from the Internet
- address String
- IPv4 or IPv6 address string
- cidr Number
- CIDR suffix for IP address block to be assigned, i.e. amount of addresses.
- family Number
- IP version - "4" or "6"
network_type
Network type of a device, used in Layer 2 networking. Will be one oflayer3
,hybrid
,layer2-individual
andlayer2-bonded
.
- gateway String
- address of router
- public Boolean
- whether the address is routable from the Internet
DevicePort, DevicePortArgs
DeviceReinstall, DeviceReinstallArgs
- Deprovision
Fast bool - Whether the OS disk should be filled with
00h
bytes before reinstall. Defaults tofalse
. - Enabled bool
- Whether the provider should favour reinstall over destroy and create. Defaults to
false
. - Preserve
Data bool - Whether the non-OS disks should be kept or wiped during reinstall. Defaults to
false
.
- Deprovision
Fast bool - Whether the OS disk should be filled with
00h
bytes before reinstall. Defaults tofalse
. - Enabled bool
- Whether the provider should favour reinstall over destroy and create. Defaults to
false
. - Preserve
Data bool - Whether the non-OS disks should be kept or wiped during reinstall. Defaults to
false
.
- deprovision
Fast Boolean - Whether the OS disk should be filled with
00h
bytes before reinstall. Defaults tofalse
. - enabled Boolean
- Whether the provider should favour reinstall over destroy and create. Defaults to
false
. - preserve
Data Boolean - Whether the non-OS disks should be kept or wiped during reinstall. Defaults to
false
.
- deprovision
Fast boolean - Whether the OS disk should be filled with
00h
bytes before reinstall. Defaults tofalse
. - enabled boolean
- Whether the provider should favour reinstall over destroy and create. Defaults to
false
. - preserve
Data boolean - Whether the non-OS disks should be kept or wiped during reinstall. Defaults to
false
.
- deprovision_
fast bool - Whether the OS disk should be filled with
00h
bytes before reinstall. Defaults tofalse
. - enabled bool
- Whether the provider should favour reinstall over destroy and create. Defaults to
false
. - preserve_
data bool - Whether the non-OS disks should be kept or wiped during reinstall. Defaults to
false
.
- deprovision
Fast Boolean - Whether the OS disk should be filled with
00h
bytes before reinstall. Defaults tofalse
. - enabled Boolean
- Whether the provider should favour reinstall over destroy and create. Defaults to
false
. - preserve
Data Boolean - Whether the non-OS disks should be kept or wiped during reinstall. Defaults to
false
.
Facility, FacilityArgs
- EWR1
- ewr1
- SJC1
- sjc1
- DFW1
- dfw1
- DFW2
- dfw2
- AMS1
- ams1
- NRT1
- nrt1
- SEA1
- sea1
- LAX1
- lax1
- ORD1
- ord1
- ATL1
- atl1
- IAD1
- iad1
- SIN1
- sin1
- HKG1
- hkg1
- SYD1
- syd1
- MRS1
- mrs1
- YYZ1
- yyz1
- FRA2
- fra2
- AM6
- am6
- DC13
- dc13
- CH3
- ch3
- DA3
- da3
- DA11
- da11
- LA4
- la4
- NY5
- ny5
- SG1
- sg1
- SV15
- sv15
- Facility
EWR1 - ewr1
- Facility
SJC1 - sjc1
- Facility
DFW1 - dfw1
- Facility
DFW2 - dfw2
- Facility
AMS1 - ams1
- Facility
NRT1 - nrt1
- Facility
SEA1 - sea1
- Facility
LAX1 - lax1
- Facility
ORD1 - ord1
- Facility
ATL1 - atl1
- Facility
IAD1 - iad1
- Facility
SIN1 - sin1
- Facility
HKG1 - hkg1
- Facility
SYD1 - syd1
- Facility
MRS1 - mrs1
- Facility
YYZ1 - yyz1
- Facility
FRA2 - fra2
- Facility
AM6 - am6
- Facility
DC13 - dc13
- Facility
CH3 - ch3
- Facility
DA3 - da3
- Facility
DA11 - da11
- Facility
LA4 - la4
- Facility
NY5 - ny5
- Facility
SG1 - sg1
- Facility
SV15 - sv15
- EWR1
- ewr1
- SJC1
- sjc1
- DFW1
- dfw1
- DFW2
- dfw2
- AMS1
- ams1
- NRT1
- nrt1
- SEA1
- sea1
- LAX1
- lax1
- ORD1
- ord1
- ATL1
- atl1
- IAD1
- iad1
- SIN1
- sin1
- HKG1
- hkg1
- SYD1
- syd1
- MRS1
- mrs1
- YYZ1
- yyz1
- FRA2
- fra2
- AM6
- am6
- DC13
- dc13
- CH3
- ch3
- DA3
- da3
- DA11
- da11
- LA4
- la4
- NY5
- ny5
- SG1
- sg1
- SV15
- sv15
- EWR1
- ewr1
- SJC1
- sjc1
- DFW1
- dfw1
- DFW2
- dfw2
- AMS1
- ams1
- NRT1
- nrt1
- SEA1
- sea1
- LAX1
- lax1
- ORD1
- ord1
- ATL1
- atl1
- IAD1
- iad1
- SIN1
- sin1
- HKG1
- hkg1
- SYD1
- syd1
- MRS1
- mrs1
- YYZ1
- yyz1
- FRA2
- fra2
- AM6
- am6
- DC13
- dc13
- CH3
- ch3
- DA3
- da3
- DA11
- da11
- LA4
- la4
- NY5
- ny5
- SG1
- sg1
- SV15
- sv15
- EWR1
- ewr1
- SJC1
- sjc1
- DFW1
- dfw1
- DFW2
- dfw2
- AMS1
- ams1
- NRT1
- nrt1
- SEA1
- sea1
- LAX1
- lax1
- ORD1
- ord1
- ATL1
- atl1
- IAD1
- iad1
- SIN1
- sin1
- HKG1
- hkg1
- SYD1
- syd1
- MRS1
- mrs1
- YYZ1
- yyz1
- FRA2
- fra2
- AM6
- am6
- DC13
- dc13
- CH3
- ch3
- DA3
- da3
- DA11
- da11
- LA4
- la4
- NY5
- ny5
- SG1
- sg1
- SV15
- sv15
- "ewr1"
- ewr1
- "sjc1"
- sjc1
- "dfw1"
- dfw1
- "dfw2"
- dfw2
- "ams1"
- ams1
- "nrt1"
- nrt1
- "sea1"
- sea1
- "lax1"
- lax1
- "ord1"
- ord1
- "atl1"
- atl1
- "iad1"
- iad1
- "sin1"
- sin1
- "hkg1"
- hkg1
- "syd1"
- syd1
- "mrs1"
- mrs1
- "yyz1"
- yyz1
- "fra2"
- fra2
- "am6"
- am6
- "dc13"
- dc13
- "ch3"
- ch3
- "da3"
- da3
- "da11"
- da11
- "la4"
- la4
- "ny5"
- ny5
- "sg1"
- sg1
- "sv15"
- sv15
OperatingSystem, OperatingSystemArgs
- Alpine3
- alpine_3
- Cent
OS6 - centos_6
- Cent
OS7 - centos_7
- Cent
OS8 - centos_8
- Core
OSAlpha - coreos_alpha
- Core
OSBeta - coreos_beta
- Core
OSStable - coreos_stable
- Custom
IPXE - custom_ipxe
- Debian8
- debian_8
- Debian9
- debian_9
- Debian10
- debian_10
- Flatcar
Alpha - flatcar_alpha
- Flatcar
Beta - flatcar_beta
- Flatcar
Edge - flatcar_edge
- Flatcar
Stable - flatcar_stable
- Free
BSD10_4 - freebsd_10_4
- Free
BSD11_1 - freebsd_11_1
- Free
BSD11_2 - freebsd_11_2
- Free
BSD12Testing - freebsd_12_testing
- Nix
OS18_03 - nixos_18_03
- Nix
OS19_03 - nixos_19_03
- Open
SUSE42_3 - opensuse_42_3
- Rancher
OS - rancher
- RHEL7
- rhel_7
- RHEL8
- rhel_8
- Scientific
Linux6 - scientific_6
- SLES12SP3
- suse_sles12_sp3
- Ubuntu1404
- ubuntu_14_04
- Ubuntu1604
- ubuntu_16_04
- Ubuntu1710
- ubuntu_17_10
- Ubuntu1804
- ubuntu_18_04
- Ubuntu2004
- ubuntu_20_04
- Ubuntu2010
- ubuntu_20_10
- VMWare
Esxi6_5 - vmware_esxi_6_5
- VMWare
Esxi6_7 - vmware_esxi_6_7
- VMWare
Esxi7_0 - vmware_esxi_7_0
- Windows2012R2
- windows_2012_r2
- Windows2016
- windows_2016
- Windows2019
- windows_2019
- Operating
System Alpine3 - alpine_3
- Operating
System Cent OS6 - centos_6
- Operating
System Cent OS7 - centos_7
- Operating
System Cent OS8 - centos_8
- Operating
System Core OSAlpha - coreos_alpha
- Operating
System Core OSBeta - coreos_beta
- Operating
System Core OSStable - coreos_stable
- Operating
System Custom IPXE - custom_ipxe
- Operating
System Debian8 - debian_8
- Operating
System Debian9 - debian_9
- Operating
System Debian10 - debian_10
- Operating
System Flatcar Alpha - flatcar_alpha
- Operating
System Flatcar Beta - flatcar_beta
- Operating
System Flatcar Edge - flatcar_edge
- Operating
System Flatcar Stable - flatcar_stable
- Operating
System_Free BSD10_4 - freebsd_10_4
- Operating
System_Free BSD11_1 - freebsd_11_1
- Operating
System_Free BSD11_2 - freebsd_11_2
- Operating
System Free BSD12Testing - freebsd_12_testing
- Operating
System_Nix OS18_03 - nixos_18_03
- Operating
System_Nix OS19_03 - nixos_19_03
- Operating
System_Open SUSE42_3 - opensuse_42_3
- Operating
System Rancher OS - rancher
- Operating
System RHEL7 - rhel_7
- Operating
System RHEL8 - rhel_8
- Operating
System Scientific Linux6 - scientific_6
- Operating
System SLES12SP3 - suse_sles12_sp3
- Operating
System Ubuntu1404 - ubuntu_14_04
- Operating
System Ubuntu1604 - ubuntu_16_04
- Operating
System Ubuntu1710 - ubuntu_17_10
- Operating
System Ubuntu1804 - ubuntu_18_04
- Operating
System Ubuntu2004 - ubuntu_20_04
- Operating
System Ubuntu2010 - ubuntu_20_10
- Operating
System_VMWare Esxi6_5 - vmware_esxi_6_5
- Operating
System_VMWare Esxi6_7 - vmware_esxi_6_7
- Operating
System_VMWare Esxi7_0 - vmware_esxi_7_0
- Operating
System Windows2012R2 - windows_2012_r2
- Operating
System Windows2016 - windows_2016
- Operating
System Windows2019 - windows_2019
- Alpine3
- alpine_3
- Cent
OS6 - centos_6
- Cent
OS7 - centos_7
- Cent
OS8 - centos_8
- Core
OSAlpha - coreos_alpha
- Core
OSBeta - coreos_beta
- Core
OSStable - coreos_stable
- Custom
IPXE - custom_ipxe
- Debian8
- debian_8
- Debian9
- debian_9
- Debian10
- debian_10
- Flatcar
Alpha - flatcar_alpha
- Flatcar
Beta - flatcar_beta
- Flatcar
Edge - flatcar_edge
- Flatcar
Stable - flatcar_stable
- Free
BSD10_4 - freebsd_10_4
- Free
BSD11_1 - freebsd_11_1
- Free
BSD11_2 - freebsd_11_2
- Free
BSD12Testing - freebsd_12_testing
- Nix
OS18_03 - nixos_18_03
- Nix
OS19_03 - nixos_19_03
- Open
SUSE42_3 - opensuse_42_3
- Rancher
OS - rancher
- RHEL7
- rhel_7
- RHEL8
- rhel_8
- Scientific
Linux6 - scientific_6
- SLES12SP3
- suse_sles12_sp3
- Ubuntu1404
- ubuntu_14_04
- Ubuntu1604
- ubuntu_16_04
- Ubuntu1710
- ubuntu_17_10
- Ubuntu1804
- ubuntu_18_04
- Ubuntu2004
- ubuntu_20_04
- Ubuntu2010
- ubuntu_20_10
- VMWare
Esxi6_5 - vmware_esxi_6_5
- VMWare
Esxi6_7 - vmware_esxi_6_7
- VMWare
Esxi7_0 - vmware_esxi_7_0
- Windows2012R2
- windows_2012_r2
- Windows2016
- windows_2016
- Windows2019
- windows_2019
- Alpine3
- alpine_3
- Cent
OS6 - centos_6
- Cent
OS7 - centos_7
- Cent
OS8 - centos_8
- Core
OSAlpha - coreos_alpha
- Core
OSBeta - coreos_beta
- Core
OSStable - coreos_stable
- Custom
IPXE - custom_ipxe
- Debian8
- debian_8
- Debian9
- debian_9
- Debian10
- debian_10
- Flatcar
Alpha - flatcar_alpha
- Flatcar
Beta - flatcar_beta
- Flatcar
Edge - flatcar_edge
- Flatcar
Stable - flatcar_stable
- Free
BSD10_4 - freebsd_10_4
- Free
BSD11_1 - freebsd_11_1
- Free
BSD11_2 - freebsd_11_2
- Free
BSD12Testing - freebsd_12_testing
- Nix
OS18_03 - nixos_18_03
- Nix
OS19_03 - nixos_19_03
- Open
SUSE42_3 - opensuse_42_3
- Rancher
OS - rancher
- RHEL7
- rhel_7
- RHEL8
- rhel_8
- Scientific
Linux6 - scientific_6
- SLES12SP3
- suse_sles12_sp3
- Ubuntu1404
- ubuntu_14_04
- Ubuntu1604
- ubuntu_16_04
- Ubuntu1710
- ubuntu_17_10
- Ubuntu1804
- ubuntu_18_04
- Ubuntu2004
- ubuntu_20_04
- Ubuntu2010
- ubuntu_20_10
- VMWare
Esxi6_5 - vmware_esxi_6_5
- VMWare
Esxi6_7 - vmware_esxi_6_7
- VMWare
Esxi7_0 - vmware_esxi_7_0
- Windows2012R2
- windows_2012_r2
- Windows2016
- windows_2016
- Windows2019
- windows_2019
- ALPINE3
- alpine_3
- CENT_OS6
- centos_6
- CENT_OS7
- centos_7
- CENT_OS8
- centos_8
- CORE_OS_ALPHA
- coreos_alpha
- CORE_OS_BETA
- coreos_beta
- CORE_OS_STABLE
- coreos_stable
- CUSTOM_IPXE
- custom_ipxe
- DEBIAN8
- debian_8
- DEBIAN9
- debian_9
- DEBIAN10
- debian_10
- FLATCAR_ALPHA
- flatcar_alpha
- FLATCAR_BETA
- flatcar_beta
- FLATCAR_EDGE
- flatcar_edge
- FLATCAR_STABLE
- flatcar_stable
- FREE_BSD10_4
- freebsd_10_4
- FREE_BSD11_1
- freebsd_11_1
- FREE_BSD11_2
- freebsd_11_2
- FREE_BSD12_TESTING
- freebsd_12_testing
- NIX_OS18_03
- nixos_18_03
- NIX_OS19_03
- nixos_19_03
- OPEN_SUSE42_3
- opensuse_42_3
- RANCHER_OS
- rancher
- RHEL7
- rhel_7
- RHEL8
- rhel_8
- SCIENTIFIC_LINUX6
- scientific_6
- SLES12_SP3
- suse_sles12_sp3
- UBUNTU1404
- ubuntu_14_04
- UBUNTU1604
- ubuntu_16_04
- UBUNTU1710
- ubuntu_17_10
- UBUNTU1804
- ubuntu_18_04
- UBUNTU2004
- ubuntu_20_04
- UBUNTU2010
- ubuntu_20_10
- VM_WARE_ESXI6_5
- vmware_esxi_6_5
- VM_WARE_ESXI6_7
- vmware_esxi_6_7
- VM_WARE_ESXI7_0
- vmware_esxi_7_0
- WINDOWS2012_R2
- windows_2012_r2
- WINDOWS2016
- windows_2016
- WINDOWS2019
- windows_2019
- "alpine_3"
- alpine_3
- "centos_6"
- centos_6
- "centos_7"
- centos_7
- "centos_8"
- centos_8
- "coreos_
alpha" - coreos_alpha
- "coreos_
beta" - coreos_beta
- "coreos_
stable" - coreos_stable
- "custom_
ipxe" - custom_ipxe
- "debian_8"
- debian_8
- "debian_9"
- debian_9
- "debian_10"
- debian_10
- "flatcar_
alpha" - flatcar_alpha
- "flatcar_
beta" - flatcar_beta
- "flatcar_
edge" - flatcar_edge
- "flatcar_
stable" - flatcar_stable
- "freebsd_10_4"
- freebsd_10_4
- "freebsd_11_1"
- freebsd_11_1
- "freebsd_11_2"
- freebsd_11_2
- "freebsd_12_
testing" - freebsd_12_testing
- "nixos_18_03"
- nixos_18_03
- "nixos_19_03"
- nixos_19_03
- "opensuse_42_3"
- opensuse_42_3
- "rancher"
- rancher
- "rhel_7"
- rhel_7
- "rhel_8"
- rhel_8
- "scientific_6"
- scientific_6
- "suse_
sles12_ sp3" - suse_sles12_sp3
- "ubuntu_14_04"
- ubuntu_14_04
- "ubuntu_16_04"
- ubuntu_16_04
- "ubuntu_17_10"
- ubuntu_17_10
- "ubuntu_18_04"
- ubuntu_18_04
- "ubuntu_20_04"
- ubuntu_20_04
- "ubuntu_20_10"
- ubuntu_20_10
- "vmware_
esxi_6_5" - vmware_esxi_6_5
- "vmware_
esxi_6_7" - vmware_esxi_6_7
- "vmware_
esxi_7_0" - vmware_esxi_7_0
- "windows_2012_
r2" - windows_2012_r2
- "windows_2016"
- windows_2016
- "windows_2019"
- windows_2019
Plan, PlanArgs
- C2Large
ARM - c2.large.arm
- C2Medium
X86 - c2.medium.x86
- C1Small
X86 - baremetal_1
- C1Large
ARM - baremetal_2a
- C1XLarge
X86 - baremetal_3
- X2XLarge
X86 - x2.xlarge.x86
- X1Small
X86 - baremetal_1e
- G2Large
X86 - g2.large.x86
- M2XLarge
X86 - m2.xlarge.x86
- M1XLarge
X86 - baremetal_2
- T1Small
X86 - baremetal_0
- S1Large
X86 - baremetal_s
- C3Small
X86 - c3.small.x86
- C3Medium
X86 - c3.medium.x86
- F3Medium
X86 - f3.medium.x86
- F3Large
X86 - f3.large.x86
- M3Large
X86 - m3.large.x86
- S3XLarge
X86 - s3.xlarge.x86
- N2XLarge
X86 - n2.xlarge.x86
- Plan
C2Large ARM - c2.large.arm
- Plan
C2Medium X86 - c2.medium.x86
- Plan
C1Small X86 - baremetal_1
- Plan
C1Large ARM - baremetal_2a
- Plan
C1XLarge X86 - baremetal_3
- Plan
X2XLarge X86 - x2.xlarge.x86
- Plan
X1Small X86 - baremetal_1e
- Plan
G2Large X86 - g2.large.x86
- Plan
M2XLarge X86 - m2.xlarge.x86
- Plan
M1XLarge X86 - baremetal_2
- Plan
T1Small X86 - baremetal_0
- Plan
S1Large X86 - baremetal_s
- Plan
C3Small X86 - c3.small.x86
- Plan
C3Medium X86 - c3.medium.x86
- Plan
F3Medium X86 - f3.medium.x86
- Plan
F3Large X86 - f3.large.x86
- Plan
M3Large X86 - m3.large.x86
- Plan
S3XLarge X86 - s3.xlarge.x86
- Plan
N2XLarge X86 - n2.xlarge.x86
- C2Large
ARM - c2.large.arm
- C2Medium
X86 - c2.medium.x86
- C1Small
X86 - baremetal_1
- C1Large
ARM - baremetal_2a
- C1XLarge
X86 - baremetal_3
- X2XLarge
X86 - x2.xlarge.x86
- X1Small
X86 - baremetal_1e
- G2Large
X86 - g2.large.x86
- M2XLarge
X86 - m2.xlarge.x86
- M1XLarge
X86 - baremetal_2
- T1Small
X86 - baremetal_0
- S1Large
X86 - baremetal_s
- C3Small
X86 - c3.small.x86
- C3Medium
X86 - c3.medium.x86
- F3Medium
X86 - f3.medium.x86
- F3Large
X86 - f3.large.x86
- M3Large
X86 - m3.large.x86
- S3XLarge
X86 - s3.xlarge.x86
- N2XLarge
X86 - n2.xlarge.x86
- C2Large
ARM - c2.large.arm
- C2Medium
X86 - c2.medium.x86
- C1Small
X86 - baremetal_1
- C1Large
ARM - baremetal_2a
- C1XLarge
X86 - baremetal_3
- X2XLarge
X86 - x2.xlarge.x86
- X1Small
X86 - baremetal_1e
- G2Large
X86 - g2.large.x86
- M2XLarge
X86 - m2.xlarge.x86
- M1XLarge
X86 - baremetal_2
- T1Small
X86 - baremetal_0
- S1Large
X86 - baremetal_s
- C3Small
X86 - c3.small.x86
- C3Medium
X86 - c3.medium.x86
- F3Medium
X86 - f3.medium.x86
- F3Large
X86 - f3.large.x86
- M3Large
X86 - m3.large.x86
- S3XLarge
X86 - s3.xlarge.x86
- N2XLarge
X86 - n2.xlarge.x86
- C2_LARGE_ARM
- c2.large.arm
- C2_MEDIUM_X86
- c2.medium.x86
- C1_SMALL_X86
- baremetal_1
- C1_LARGE_ARM
- baremetal_2a
- C1_X_LARGE_X86
- baremetal_3
- X2_X_LARGE_X86
- x2.xlarge.x86
- X1_SMALL_X86
- baremetal_1e
- G2_LARGE_X86
- g2.large.x86
- M2_X_LARGE_X86
- m2.xlarge.x86
- M1_X_LARGE_X86
- baremetal_2
- T1_SMALL_X86
- baremetal_0
- S1_LARGE_X86
- baremetal_s
- C3_SMALL_X86
- c3.small.x86
- C3_MEDIUM_X86
- c3.medium.x86
- F3_MEDIUM_X86
- f3.medium.x86
- F3_LARGE_X86
- f3.large.x86
- M3_LARGE_X86
- m3.large.x86
- S3_X_LARGE_X86
- s3.xlarge.x86
- N2_X_LARGE_X86
- n2.xlarge.x86
- "c2.large.arm"
- c2.large.arm
- "c2.medium.x86"
- c2.medium.x86
- "baremetal_1"
- baremetal_1
- "baremetal_2a"
- baremetal_2a
- "baremetal_3"
- baremetal_3
- "x2.xlarge.x86"
- x2.xlarge.x86
- "baremetal_1e"
- baremetal_1e
- "g2.large.x86"
- g2.large.x86
- "m2.xlarge.x86"
- m2.xlarge.x86
- "baremetal_2"
- baremetal_2
- "baremetal_0"
- baremetal_0
- "baremetal_
s" - baremetal_s
- "c3.small.x86"
- c3.small.x86
- "c3.medium.x86"
- c3.medium.x86
- "f3.medium.x86"
- f3.medium.x86
- "f3.large.x86"
- f3.large.x86
- "m3.large.x86"
- m3.large.x86
- "s3.xlarge.x86"
- s3.xlarge.x86
- "n2.xlarge.x86"
- n2.xlarge.x86
Import
This resource can be imported using an existing device ID
$ pulumi import equinix-metal:index/device:Device metal_device {existing_device_id}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Equinix Metal pulumi/pulumi-equinix-metal
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
metal
Terraform Provider.
This package is deprecated. We recommend using the new Equinix package.