Accounts 
Locations 
Deployment Options 
Servers 
Operating Systems 
Networking 
Layer 2 Networking 
Equinix Interconnect 
Storage 
Resilience and Recovery 
CLI and Libraries 
Integrations 
COMMAND LINE
Copy to clipboard
Reserved Hardware¶
Equinix Metal™ Reserved Hardware gives you the ability to reserve specific servers for a committed period of time. Once you request reserved hardware and your request is fulfilled, you will have access to that specific hardware for the duration of the reservation. The only way to get hardware in Expansion Metros is through Reserved Hardware.
Requesting Reserved Hardware¶
You can request Reserved Hardware in the console by navigating to the Servers page, clicking + New Server, and choosing Reserved from the three deployment options. The page will show any Reserved Hardware already attached to the Project. Click Request Reserved Servers to start a new request.
Select Your Contract Period for either 12 months or 36 months.
Then, each line has Metro, Server, Quantity, and Rate per month. The Rate will be determined by hardware and quantity you are reserving. Note: custom pricing agreements are not currently reflected in the rate and you will need to reach out to your sales rep directly to make a request with custom pricing.
If you need to make a request in other locations, click Add Row and repeat the process.
Almost all plans and locations are available for you to request, but this is not an indication that every plan and location will be able to immediately accommodate it. In some cases, we may need to add capacity for a plan or location.
If you have custom hardware requirements that are not listed, or if you would like to discuss further details regarding your request, you may contact our sales team, your dedicated account manager, or contact support at support@equinixmetal.com.
Once you have filled out the request form, click Review Request.
The total Quote reflects the monthly rates for the hardware and the length of the reservation. If you need to make changes, click Edit.
Please review your request carefully and be sure to read the Terms.
When you are ready, click Submit Request. You will get a confirmation email with your request details.
Outstanding Requests¶
You can find a list of your outstanding requests on the Pending Requests tab, and details on the requests can be found by clicking Details.
Request Fulfillment¶
When your request is filled, you will be notified via email, your contract term will begin, and your hardware will be available for you to provision when you need it.
In certain cases, if your whole request can’t be filled, we will reach out to talk about splitting it into multiple requests.
Provisioning From Your Reserved Hardware¶
Once you have Reserved Hardware assigned to your Project, when you go to provision a new server, you can provision directly from that pool of hardware.
In the Equinix Metal console, navigate to your Project's Servers page, click + New Server, and choose Reserved from the three deployment options. The Select Hardware Reservation dropdown will list any Reserved Hardware already attached to the Project.
Select the one you want to provision, give it a hostname, operating system, and use the Configure button to customize the deployment further. To provision more than one server, click Add Row and repeat the process.
When you have choosen and configured all the servers you want to deploy, click Deploy Now to start the provisioning.
To list hardware reservations, send a GET request to the /projects/{id}/hardware-reservations endpoint.
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
"https://api.equinix.com/metal/v1/projects/{id}/hardware-reservations"
To see the details of a single reservation, you can send a GET to /hardware-reservations/{id}.
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
"https://api.equinix.com/metal/v1/hardware-reservations/{id}"
To create a device from a specific hardware reservation, send a POST request to the the projects/<id>/devices endpoint, just as if you were provisioning an on-demand server, but specify the hardware_reservation_id, hostname, and operating_system that you want to provision in the body of the request.
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/devices" \
-d '{
"hardware_reservation_id":"reservation_id",
"hostname": "your-hostname",
"operating_system": "ubuntu_20_04_image"
}'
If you have multiple reservations, you can provision the next available reserved hardware by sending in "next-available" for hardware_reservation_id instead of a reservation ID.
Moving Reserved Hardware Between Projects¶
Reserved Hardware can be moved between Projects within the same Organization.
Managing hardware reservations between projects within the same organization can be done from the Equinix Metal console in Organization Settings on the Reserved Hardware tab. To move a hardware reservation to a different project, click the overflow menu (the three dots) and click Assign to project.
You can then select the project to move the reservation to from the drop-down field, click Assign, and the reservation will be moved to the new project.
To move to a reservation in the API, you will need the reservation ID and the Project ID that you are moving the reservation to. Then, send a POST to /hardware-reservations/{id}/move with the reservation ID in the path, and the project ID in the body of the request.
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/hardware-reservations/{id}/move" \
-d '{
"project_id": "new-project-id"
}'