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.
Some advantages to placing hardware reservations:
- Our Workload Optimized plans are only available through a reservation.
- Discounts are available for longer contract periods vs on demand pricing.
Equinix Metal offers a Pricing Calculator, so you can estimate the cost of your Reserved Hardware.
Requesting Reserved Hardware¶
To request Reserved Hardware, select one of your Projects, and under Bare Metal Servers, choose Deploy.
And then click Manage Reservations.
If you don't have any Hardware Reservations, you're taken directly to the Request Reserved Hardware page. If you have any Hardware Reservations available to deploy, click + New Request.
If you are interested in getting your hardware the fastest, click Browse In-stock Inventory. Select Your Contract Period for month-to-month, 12 months, or 36 months. Once you filter by Metro, you'll be able to see what inventory we have available to fill your request.
If you are looking for large numbers of servers, workload optimized servers, a combination of different server plans and Metros, or we don't currently have stock of the servers in the Metros where you need them, click Submit a Custom Request.
Select Your Contract Period for month-to-month, 12 months, or 36 months.
Then, fill out each line with Metro, Server Config, and Quantity.
The rate will be determined by the length of your contract, the Metro, and the server plan 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 + 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 us, your dedicated account manager, or email 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.
Converting On Demand to a Hardware Reservation¶
If you have existing On Demand servers and anticipate using them for a while, you can submit a request to convert those servers into a Hardware Reservation, guaranteeing inventory (even if you deprovision) and taking advantage of term discounts.
From the Reserved Hardware page, click + New Request.
Select Convert an existing on demand instance to a hardware reservation and select the contract period of month-to-month, 12 months, or 36 months.
From the drop-down, select the on demand server you want to convert. The Current Hourly Rate, New Monthly Rate, and Savings are auto-filled.
If you want to convert other servers for the same contract term, click + and repeat the process.
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.
Server Requests¶
Once you have submitted your request, you will receive a confirmation email, and you can see your request on the Server Requests tab of the Hardware Reservations section of the console.
The table displays basic request information including the Request ID, the date the request was submitted, the contract period, and the total cost of the request.
It also includes the request's Status. Possible statuses are:
- Pending - We've received and are reviewing your request. If we have questions or need to discuss delivery times, we will reach out.
- Approved - We're able to fulfill your request and are working on delivery. When your request is filled, you will be notified via email.
- Delivered - Your hardware will be available for you to provision when you need it, and your contract term has begun.
- Cancelled - We are not able to fulfill your request. In certain cases, if your whole request can’t be filled, we will reach out to talk about splitting it into multiple requests.
Click the hamburger menu to see the details of the reservation.
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.
To deploy a server from your Reserved Hardware, select one of your Projects, and under Bare Metal Servers, choose Deploy. Then click Manage Reservations.
On the Deploy Reserved Servers tab, select the server from the Server Config drop-down menu. Select its Operating System, and give it a Hostname.
Click Configure to customize the deployment further, including configuring the IP addresses, user data, SSH keys, tags, and custom data.
Click Apply Changes to save your configuration.
To provision more than one server, click + and repeat the process.
When you have chosen 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 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" instead of a reservation ID. When using "next-available", you need to also specify the metro of the reservation.
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":"next-available",
"hostname": "your-hostname",
"operating_system": "ubuntu_20_04_image",
"metro": "sv"
}'
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"
}'