~> Deprecation Notice Equinix Metal will reach end of life on June 30, 2026. All Metal data sources will be removed in version 5.0.0 of this provider. Use version 4.x of this provider for continued use through sunset. See https://docs.equinix.com/metal/ for more information.

equinix_metal_operating_system (Data Source)

Use this data source to get Equinix Metal Operating System image.

Example Usage

data "equinix_metal_operating_system" "example" {
  distro           = "ubuntu"
  version          = "24.04"
  provisionable_on = "c3.medium.x86"
}

resource "equinix_metal_device" "server" {
  hostname         = "tf.ubuntu"
  plan             = "c3.medium.x86"
  metro            = "ny"
  operating_system = data.equinix_metal_operating_system.example.id
  billing_cycle    = "hourly"
  project_id       = local.project_id
}

Argument Reference

The following arguments are supported:

• distro - (Optional) Name of the OS distribution.
• name - (Optional) Name or part of the name of the distribution. Case insensitive.
• provisionable_on - (Optional) Plan name.
• version - (Optional) Version of the distribution.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

• id - Operating system slug.
• slug - Operating system slug (same as id).