À compter du 1 avril 2025, Equinix Metal a décidé de fermer le service Spot Market le June 20th, 2025 Convertissez vos instances Spot Market actives en instances à la demande dès que possible.
Le marché au comptant
Le marché Spot Equinix Metal™ permet aux utilisateurs d'enchérir sur des capacités de serveur inutilisées à des tarifs réduits. En échange, vous autorisez Equinix Metal à révoquer toute instance avec un préavis de deux minutes seulement. Si vous disposez d'une charge de travail portable, le marché Spot est un excellent outil pour réduire vos coûts.
Comment fonctionne le marché au comptant ?
Le marché spot est une place de marché dont l'inventaire est en constante évolution. Vous pouvez placer des enchères sur cet inventaire en définissant divers facteurs, tels que le prix maximum que vous êtes prêt à payer pour une ressource donnée, le nombre et le type de serveurs, la possibilité d'exécuter tout ou partie de la commande à un moment donné, etc.
Par exemple, vous pouvez provisionner cinq instances avec le prix horaire maximum que vous souhaitez payer par instance. Si votre prix est égal ou supérieur au prix spot actuel pour la zone métropolitaine et le forfait donnés, les instances seront créées pour vous.
Ces instances sont volatiles, ce qui signifie qu'elles peuvent être révoquées par Equinix Metal à tout moment si un autre utilisateur propose un prix plus élevé. Si votre instance est révoquée, elle sera soumise à un délai de résiliation d'au moins deux minutes.
Prix du marché actuels et historiques
Le prix actuel du marché reflète le prix que vous devez spécifier pour déployer une instance unique à ce stade. Si le prix spot affiché est dix fois supérieur au prix standard pour un serveur de ce type, nous n'avons plus de capacité pour les instances spot à cet endroit.
Le point de terminaison /market/spot/prices fournira les prix courants pour chaque métro et plan Equinix Metal.
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/market/spot/prices
Pour voir l'historique des prix pour un emplacement et un serveur spécifiques, le point de terminaison /market/spot/prices/history?plan&metro vous permettra de vérifier les prix du marché au comptant des 90 derniers jours.
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/market/spot/prices/history?plan&metro
Stratégies d'enchères
Bien que votre stratégie d'enchères spécifique dépende entièrement de vous, la plupart des utilisateurs adoptent l'une de ces stratégies d'enchères en fonction de leur cas d'utilisation:
Optimisation stricte des coûts: privilégiez la réduction au détriment de la disponibilité. Cette option est idéale pour les charges de travail de longue durée dont la date de fin est flexible.
- Cas d'utilisation: tâches de type recherche
- Offre suggérée: proche du minimum
Équilibre coût/disponibilité - Un prix légèrement supérieur à celui d'une optimisation stricte des coûts, mais vous permet d'augmenter vos chances d'obtenir et de conserver une instance pendant une période plus longue.
- Cas d'utilisation: tâches par lots pouvant gérer une certaine quantité de récupération
- Offre suggérée: 10 à 20 % au-dessus du minimum
Prix sur demande - Obtenez une réduction chaque fois que le prix au comptant est inférieur au prix à la demande, et passez immédiatement au prix à la demande lorsqu'il augmente.
- Cas d'utilisation: applications entièrement cloud natives capables de déplacer facilement les charges de travail
- Offre suggérée: prix sur demande
Optimiser la continuité - Offrez un prix très élevé pour assurer la disponibilité et la continuité.
- Cas d'utilisation: Accepter certaines périodes de prix supérieurs à ceux du marché en échange d'une continuité de disponibilité
- Offre suggérée: 2x-3x le prix sur demande
Création d'une demande de marché au comptant
Pour faire une demande sur le marché au comptant, envoyez une requête POST au point de terminaison /projects/{id}/spot-market-requests. Dans le corps de la requête, précisez les détails de votre demande.
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/spot-market-requests" \
-d '{
"devices_max": <integer>,
"devices_min": <integer>,
"max_bid_price": <float>,
"metro": "<metro_slug>",
"instance_parameters": {
"hostname": "<string>",
"plan": "<plan_slug>",
"operating_system": "<os_slug>"
}
}'
Paramètres corporels -
devices_max(required) - The maximum number of devices to provision to fill this request.devices_min(required) - The minimum number of devices to provision to fill this request.max_bid_price(required) -end_at(optional) - Set an expiration for the spot market request with date and UTC time of expiration in ISO8601 format.instance_parameters(required) - Configuration for the requested devices. Theinstance parametersobject must containhostname,plan,operating_system, andmetro.
instance_parameters peut aussi contenir n'importe quel autre champ utilisé pour provisionner et configurer les serveurs via l'API. La liste complète de ces champs est disponible dans la documentation de référence de l'API pour le point de terminaison /projects/{id}/spot-market-requests.
Gestion de vos appareils de marché au comptant
Pour obtenir la liste de tous vos appareils du marché spot, envoyez une requête GET au point de terminaison /projects/{id}/devices, en filtrant sur le type d'appareil.
curl -X GET -H "X-Auth-Token: <API_TOKEN>" \
https://api.equinix.com/metal/v1/projects/{id}/devices?type=spot
Les appareils du marché au comptant peuvent être mis à jour via l'API en envoyant une requête PUT au point de terminaison /devices/{id}. Indiquez les champs à mettre à jour dans le corps de la requête. Aucun champ n'est obligatoire et tous peuvent être mis à jour indépendamment.
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}" \
-d '{
"description": "<string>",
"hostname": "<string>",
"always_pxe": <boolean>,
"ipxe_script_url": "<string>",
"locked": <boolean>,
"spot_instance": <boolean>,
"tags": [
"<string>"
],
"userdata": "<string>"
}'
Une liste complète des champs et de leurs descriptions est disponible dans la référence API.
Conversion d'un serveur Spot Market en On Demand
Si vous possédez un serveur de marché spot que vous souhaitez conserver, vous pouvez utiliser l'API pour le convertir en serveur à la demande. Une fois ce serveur converti en serveur à la demande, il ne sera pas résilié et sera facturé au tarif à la demande jusqu'à son terme.
Les serveurs dont la résiliation est prévue ne sont pas éligibles à la conversion. Vous devez convertir votre serveur du marché spot en serveur à la demande AVANT de le sélectionner pour la résiliation.
Pour convertir, envoyez une requête PUT au point de terminaison /devices/{id} avec le corps de la requête contenant le métro où se trouve le serveur et "spot_instance": false.
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}" \
-d '{
"spot_instance": false
}'
Résiliation du marché au comptant
La fermeture des serveurs du marché spot se produit lorsque votre prix d'enchère maximal est inférieur au prix spot maximal actuel, ou si la demande de serveurs a augmenté et que votre appareil affiche le prix le plus bas de toutes les instances du marché spot. Un serveur marqué pour fermeture dispose de 120 secondes avant d'être supprimé.
L'heure de fin est disponible dans l'API ou à partir des métadonnées du serveur.
Pour déterminer l'heure de terminaison d'un serveur, envoyez une requête GET au point de terminaison /devices/{id}.
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/devices/{id}
Le champ termination_time contient l'heure UTC au format ISO 8601 à laquelle l'instance sera arrêtée. Si la réponse est null, ça indique qu'aucune heure d'arrêt n'a été définie.
Vous pouvez aussi récupérer une liste de tous les appareils d'un projet et leurs informations à partir du point de terminaison /projects/{id}/devices.
Pour interroger le serveur lui-même sur l'heure de fin, vous pouvez cURLer ses métadonnées. Depuis le serveur, exécutez:
curl -s https://metadata.platformequinix.com/metadata
La réponse contiendra une date/heure de fin ou sera null.
Suppression d'une demande de marché au comptant
Pour supprimer une requête, envoyez un DELETE au point de terminaison /spot-market-requests/{id}.
curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1//spot-market-requests/{id}
Si vous voulez aussi supprimer les serveurs provisionnés par la requête, envoyez force_termination=true comme paramètre de requête.
curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/spot-market-requests/{id}?force_termination=true