Instalaciones (obsoletas)

En mayo de 2023, Equinix Metal™ dejará de ofrecer soporte y puntos finales de API específicos de las instalaciones. Todos los conceptos relacionados con la ubicación, incluido el aprovisionamiento de dispositivos y otras infraestructuras, se trasladan al nivel Metro.

A partir de May 30th, 2023:

• La API devuelve cabeceras de respuesta que contienen mensajes de desaprobación y de puesta a punto a las solicitudes enviadas a los puntos finales de las instalaciones o a las solicitudes que utilizan instalaciones en sus parámetros.
• Las nuevas organizaciones (las creadas después del 30 de mayo) no tendrán acceso a los puntos finales de las instalaciones ni podrán utilizar instalaciones en los parámetros de sus solicitudes.

El uso de los puntos finales y parámetros de solicitud específicos de las instalaciones se desactivará de forma permanente para todos los usuarios a finales de 2023.

Información general sobre el metro

Con la eliminación de los puntos finales de Facilities, las respuestas a las siguientes solicitudes de CLI y API devolverán cabeceras de respuesta con información sobre la eliminación. Actualice cualquier script o automatización que utilice estos puntos finales para consultar Metros en su lugar.

• El comando metal facilities get.
• El punto final /facilities.
• El punto final /projects/{id}/facilities.
• El punto final /organizations/{id}/facilities.

En su lugar, utilice los siguientes comandos y puntos finales para Metros.

• El comando metal metros get.
• El punto final /locations/metros.
• El punto final /locations/metros/{id}.

Nota - todos los Metros son visibles para todas las Organizaciones y Proyectos.

Aprovisionamiento

Con la eliminación de los puntos finales de Facilities, las respuestas a las siguientes solicitudes de CLI y API devolverán encabezados de respuesta con información sobre la eliminación. Actualice cualquier script o automatización que utilice estos puntos finales para aprovisionar utilizando Metros en su lugar.

CLI

Cuando utilice el comando metal device create, utilice el parámetro --metro o -m para especificar el Metro en lugar de una instalación.

metal device create -p $METAL_PROJECT_ID -P <plan> -m <metro> -H <hostname> -O <operating_system>

API

Cuando envíe la solicitud de aprovisionamiento POST projects/{id}/devices endpoint, utilice el campo "metro" con el metro_code donde desea que viva el servidor en lugar de especificar una Instalación.

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/devices" \
-d '{
    "metro": "<metro_code>",
    "plan": "<server_type>",
    "operating_system": "<os_code>"
}'

Nota: "metro" sólo toma un tipo de cadena. "facilities" se utiliza para tomar una cadena o una matriz de cadenas.

Utilización de metros en lugar de instalaciones

Al igual que ocurre con el aprovisionamiento de servidores bajo demanda, otras opciones de despliegue y funciones de la plataforma que anteriormente permitían el aprovisionamiento en instalaciones específicas devolverán encabezados de respuesta que indicarán su eliminación.

Por favor, actualice sus scripts o automatizaciones para utilizar Metros en lugar de instalaciones en la CLI o API.

Tenga en cuenta que el uso del parámetro "facilities" es mutuamente excluyente con el parámetro "metros"; no es posible utilizar ambos.

Consultas sobre capacidad

Con la desaprobación de los puntos finales de Facilities, las respuestas a las siguientes solicitudes CLI y API devolverán cabeceras de respuesta que contienen información sobre la desaprobación. Por favor, actualice cualquier script o automatización que utilice estos puntos finales para consultar Metro capacity en su lugar.

• El comando metal capacity cuando se utiliza con una Instalación en lugar de un Metro.
• El comando metal capacity check cuando se utiliza con una Instalación en lugar de un Metro.
• El punto final /capacity.

¿En qué metro o instalación se encuentra mi servidor?

Las respuestas para servidores y otras infraestructuras que contengan un objeto "facilities" seguirán devolviéndolo. Para la infraestructura que se aprovisiona en el nivel Metro, el objeto "facilities" puede estar vacío.

Todas las respuestas contienen un objeto "metro", para identificar en qué metro se aprovisiona.

Aún puede averiguar en qué Facility se encuentra su servidor, pero debe saber que la diversidad a nivel de Facility no ofrece garantías de alta disponibilidad o redundancia. Para establecer y configurar una alta disponibilidad, debe optar por una arquitectura multimetro.

CLI

Utilice el comando metal device, y especifique que desea una respuesta JSON utilizando la bandera de salida -o.

metal device get -i <device_id> -o json

API

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}

Tanto la CLI como la API devuelven una respuesta que incluye un objeto "facility". Respuesta de ejemplo:

{
"id": "0dd71771-143e-4964-87d2-7e6f0348253a",
...
 "facility": {
    "id": "917e9941-8323-487f-8688-2b0b11baacd4",
    "name": "Silicon Valley",
    "code": "sv15",
    "features": [
      "baremetal",
      "backend_transfer",
      "layer_2",
      "global_ipv4",
      "ibx"
    ],
    "address": {
      ...
      }
    },
    "metro": {
      "id": "2991b022-b8c4-497e-8db7-5a407c3a209b",
      "name": "Silicon Valley",
      "code": "sv",
      "country": "US"
    }
  },
...
}