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¶
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 1 month, 12 months, or 36 months.
Then, each line has:
- Metro
- Server
- Quantity
- 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 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.
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 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 or facility 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"
}'