advertencia

A partir de 1 de abril de 2025, Equinix Metal ha decidido cerrar el servicio Spot Market en June 20th, 2025. Convierta sus instancias activas de Spot Market a bajo demanda lo antes posible.

El mercado al contado

El mercado Equinix Metal™ Spot permite a los usuarios pujar por capacidad de servidor sobrante a precios reducidos. A cambio, usted otorga a Equinix Metal el derecho a revocar cualquier instancia con solo un aviso de dos minutos. Si tiene carga de trabajo portátil, el mercado Spot es una herramienta excelente para ayudarle a reducir sus costes.

¿Cómo funciona el mercado al contado?

El mercado al contado es un Marketplace con un inventario que cambia constantemente. Puedes pujar por este inventario definiendo una serie de factores, como el precio máximo que estás dispuesto a pagar por un recurso concreto, el número y tipo de servidores, si quieres que se cubra todo o parte del pedido en un momento dado, etc.

Por ejemplo, puede aprovisionar cinco instancias con el precio máximo que desea pagar por hora por instancia. Si su precio es igual o superior al precio al contado actual para el metro y el plan dados, se crearán las instancias por usted.

Estas instancias son volátiles, lo que significa que pueden ser revocadas por Equinix Metal en cualquier momento si otro usuario puja con un precio superior. Si su instancia va a ser revocada, recibirá un tiempo de terminación de al menos dos minutos de duración.

Precios de mercado actuales e históricos

El precio de mercado actual refleja el precio que debe especificar para desplegar una única instancia en este momento. Si el precio de mercado al contado que aparece es 10 veces superior al precio estándar para un servidor de ese tipo, entonces no tenemos capacidad para instancias de mercado al contado en esa ubicación.

El punto final /market/spot/prices proporcionará los precios actuales de cada metro y plan Equinix Metal.

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

Para ver el historial de precios de una ubicación y un servidor concretos, el punto final /market/spot/prices/history?plan&metro le permitirá consultar los precios del mercado al contado de los últimos 90 días.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/market/spot/prices/history?plan&metro

Estrategias de licitación

Aunque su estrategia específica de pujas depende totalmente de usted, la mayoría de los usuarios adoptan una de estas estrategias de pujas en función de su caso de uso:

Optimice estrictamente los costes - Sacrifique la disponibilidad para obtener el mayor descuento. Esto es ideal para cargas de trabajo de larga duración que tienen fechas de finalización flexibles.

• Caso práctico: Tareas de investigación
• Oferta sugerida: cerca del mínimo

Equilibrio coste/disponibilidad - Precio ligeramente superior al estrictamente optimizado para costes, pero le permite aumentar la probabilidad de obtener y mantener una instancia durante períodos más largos.

• Caso práctico: trabajos por lotes que pueden gestionar cierta cantidad de reclamaciones.
• Oferta sugerida: 10-20% por encima del mínimo

Precio bajo demanda - Reciba un descuento siempre que el precio al contado sea inferior al precio bajo demanda, pasando inmediatamente al precio bajo demanda cuando suba.

• Caso práctico: Aplicaciones totalmente nativas de la nube capaces de desplazar fácilmente las cargas de trabajo
• Oferta sugerida: precio según demanda

Optimice la continuidad - Haga una oferta muy alta para garantizar la disponibilidad y la continuidad.

• Caso práctico: Aceptar algunos periodos de precios superiores a los del mercado a cambio de la continuidad del tiempo de actividad.
• Oferta sugerida: 2x-3x sobre el precio de demanda

Crear una solicitud de mercado al contado

Para realizar una solicitud de Spot Market, envíe una solicitud POST al punto final /projects/{id}/spot-market-requestsendpoint. En el cuerpo de la solicitud, defina los detalles de su petición.

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>"
    }
}'

Parámetros corporales -

• 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. The instance parameters object must contain hostname, plan, operating_system, and metro.

instance_parameters también puede contener cualquiera de los otros campos utilizados para aprovisionar y configurar servidores a través de la API. Encontrará una lista completa de esos campos en la referencia de la API para el punto final /projects/{id}/spot-market-requests.

Gestión de los dispositivos del mercado al contado

Para obtener una lista de todos sus dispositivos Spot Market, envíe una solicitud GET al punto final /projects/{id}/devices, filtrando por tipo de dispositivo.

curl -X GET -H "X-Auth-Token: <API_TOKEN>" \
https://api.equinix.com/metal/v1/projects/{id}/devices?type=spot

Los dispositivos Spot Market pueden actualizarse a través de la API enviando una solicitud PUT al punto final /devices/{id}. Incluya los campos que desea actualizar en el cuerpo de la solicitud. Ninguno de los campos es obligatorio y todos pueden actualizarse de forma independiente.

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>"
}'

Encontrará una lista completa de los campos y sus descripciones en la Referencia API.

Convertir un servidor de mercado al contado en uno a la carta

Si tiene un servidor de mercado al contado que necesita conservar, puede utilizar la API para convertirlo en un servidor bajo demanda. Una vez que sea un servidor bajo demanda, no estará sujeto a rescisión y se facturará al precio bajo demanda durante el resto de su existencia.

nota

que los servidores que han sido marcados para ser dados de baja no son elegibles para la conversión. Debe convertir su servidor de mercado al contado a bajo demanda ANTES de que sea seleccionado para ser dado de baja.

Para convertir, envíe una solicitud PUT al punto final /devices/{id} con el cuerpo de la solicitud conteniendo el metro donde vive el servidor y "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
}'

Terminación del mercado al contado

La terminación de servidores del mercado al contado se produce cuando su precio máximo de oferta es inferior al precio máximo actual del mercado al contado o si la demanda de servidores ha aumentado y su dispositivo tiene el precio más bajo de todas las instancias del mercado al contado. Un servidor marcado para ser dado de baja dispone de 120 segundos antes de ser eliminado.

La hora de finalización está disponible en la API o en los metadatos del servidor.

Para determinar la hora de finalización de un servidor envíe una solicitud GET al punto final /devices/{id}.

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

El campo termination_time contiene la hora UTC en formato ISO8601 en la que finalizará la instancia. Si la respuesta es null, indica que no se ha establecido ninguna hora de terminación.

También puede obtener una lista de todos los dispositivos de un proyecto y su información desde el punto final /projects/{id}/devices.

Para consultar el tiempo de terminación en el propio servidor, puede cURL sus metadatos. Desde el propio servidor, ejecute

curl -s https://metadata.platformequinix.com/metadata

La respuesta contendrá una fecha/hora de finalización o será null.

Eliminar una solicitud de mercado al contado

Para eliminar una solicitud, envíe un DELETE al punto final /spot-market-requests/{id}.

curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1//spot-market-requests/{id}

Si desea eliminar también los servidores aprovisionados por la solicitud, envíe force_termination=true como parámetro de consulta.

curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/spot-market-requests/{id}?force_termination=true