Equnix Metal
Loading...

About Equinix Metal Servers

COMMAND LINE

Copy to clipboard

About Equinix Metal Servers

Equinix Metal™ offers a variety of servers to meet a wide range of needs. A quick reference for hardware specs is on the Server Specs page.

Server Naming Convention

Equinix Metal servers have a name that follows a formula to help you understand its purpose and broad specifications: class + generation + size + architecture. By piecing these features together, servers get names such as c3.medium.x86, indicating a medium sized, compute-class server, in its 3rd generation, with an x86 processor.

Classes

Classes are groupings derived from common use cases. Equinix Metal organizes servers into the following classes:

  • Compute (c) - Compute focused, with a modest RAM footprint.
  • Memory (m) - Memory heavy, with a generous RAM to core ratio.
  • Network (n) - Focused on network use cases, such as ingress or load balancing.
  • Storage (s) - Scale out boxes for storage scenarios.
  • GPU (g) - GPU-focused with generous RAM.
  • Tiny (t) - Smaller servers, aimed at development or test environments, controller nodes, etc.
  • Accelerator (x) - FPGA and other specialty accelerator focused servers.

Generations

Generations are updated when Equinix Metal significantly upgrades or changes server components. Usually a new generation is released around a major processor refresh, but often it also relates to the underlying hardware configuration or chassis. A 2nd generation system is not necessarily outdated, it is just the second iteration of a particular configuration.

Sizes

The server size is a label for the total amount of resources across CPU, memory, and disk. Generally, the larger the server size the more resources it has and the more expensive it is. Equinix Metal server sizes currently include small, medium, large, and xlarge.

Architecture

The architecture is the server's processor. x86 indicates the server has a x86 processor and arm is used for our ARM processor servers.

Servers in the API

Information about Equinix Metal servers in the API can be found in the plans and devices endpoints.

Plans

The plans API endpoints generally return information about what types of servers your organization, project, and user account can provision.

Sending a GET request to the /plans endpoint will return a list of servers that your user account is able to provision with lots of information about each, including name, a description, and which data centers the servers are available in.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/plans

Sending a GET request to the /projects/{id}/plans endpoint, where the id is the Project ID, will return a list of servers that are available to that project.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/projects/{id}/plans

Ans sending a GET request to the /organizations/{id}/plans endpoint, where the id is the Organization ID, will return a list servers that available to your organization.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/organizations/{id}/plans

Devices

The devices API endpoints are the endpoints that provision and manage servers.

For example, to retrieve information about all the servers that you have provisioned in a project, send a GET request to the /projects/{id}/devices endpoint.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/projects/{id}/devices

You can provision servers with a POST to the /projects/{id}/devices endpoint. And a more in-depth explanation of on-demand server provisioning is on the On-Demand Servers page.

There are many more features that the Equinix Metal API offers for server management and configuration, please see the API reference.

Frequently
asked questions

Slack

Still stuck?

Join us on Slack

Get support from our team and community members.

Frequently asked questions

What 3rd party Managed Services?

Neutra trust fund narwhal, palo santo bicycle rights live-edge stumptown health goth portland selfies kinfolk woke. ssss Echo park irony artisan vaporware typewriter. Next level pinterest drinking vinegar lyft mumblecore af small batch heirloom VHS. Fixie banh mi asymmetrical trust fund.

What 3rd party Managed Services?

Neutra trust fund narwhal, palo santo bicycle rights live-edge stumptown health goth portland selfies kinfolk woke. ssss Echo park irony artisan vaporware typewriter. Next level pinterest drinking vinegar lyft mumblecore af small batch heirloom VHS. Fixie banh mi asymmetrical trust fund.

What 3rd party Managed Services?

Neutra trust fund narwhal, palo santo bicycle rights live-edge stumptown health goth portland selfies kinfolk woke. ssss Echo park irony artisan vaporware typewriter. Next level pinterest drinking vinegar lyft mumblecore af small batch heirloom VHS. Fixie banh mi asymmetrical trust fund.

Copied code to clipboard