Installations (obsolètes)

En mai 2023, Equinix Metal™ abandonne les points de terminaison et la prise en charge des API spécifiques aux installations. Tous les concepts liés à la localisation, y compris le provisionnement des appareils et autres infrastructures, passent au niveau métropolitain.

À partir du May 30th, 2023:

• L'API renvoie des en-têtes de réponse contenant des messages d'obsolescence et de cessation aux demandes envoyées aux points de terminaison des installations ou aux demandes utilisant des installations dans leurs paramètres.
• Les nouvelles organisations (celles créées après le 30 mai) n'auront pas accès aux points de terminaison des installations ni ne pourront utiliser les installations dans leurs paramètres de demande.

L'utilisation des points de terminaison et des paramètres de demande spécifiques aux installations sera définitivement désactivée pour tous les utilisateurs fin 2023.

Trouver des informations générales sur le métro

Avec l'obsolescence des points de terminaison Facilities, les réponses aux requêtes CLI et API suivantes renverront des en-têtes contenant des informations d'obsolescence. Veuillez mettre à jour les scripts ou automatisations utilisant ces points de terminaison pour interroger les Metros.

• La commande metal facilities get.
• Le point final /facilities.
• Le point final /projects/{id}/facilities.
• Le point final /organizations/{id}/facilities.

Utilisez plutôt les commandes et points de terminaison suivants pour les métros.

• La commande metal metros get.
• Le point de terminaison /locations/metros.
• Le point de terminaison /locations/metros/{id}.

Remarque: tous les métros sont visibles par toutes les organisations et tous les projets.

Approvisionnement

Avec l'obsolescence des points de terminaison Facilities, les réponses aux requêtes CLI et API suivantes renverront des en-têtes contenant des informations d'obsolescence. Veuillez mettre à jour les scripts ou automatisations utilisant ces points de terminaison pour qu'ils soient provisionnés via Metros.

CLI

Lorsque vous utilisez la commande metal device create, utilisez le paramètre --metro ou -m pour spécifier le métro au lieu d'une installation.

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

API

Lorsque vous envoyez la requête d'approvisionnement POST projects/{id}/devices au point de terminaison, utilisez le champ "metro" avec le metro_code où vous souhaitez que le serveur réside au lieu de spécifier une installation.

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

Remarque: "metro" n’accepte que des chaînes de caractères. "facilities accepte une chaîne de caractères ou un tableau de chaînes de caractères.

Utiliser les métros à la place des installations

Similairement à l'approvisionnement de serveurs à la demande, d'autres options de déploiement et fonctionnalités de plate-forme qui prenaient auparavant en charge l'approvisionnement dans des installations spécifiques renverront des en-têtes de réponse indiquant leur dépréciation.

Veuillez mettre à jour vos scripts ou votre automatisation pour utiliser Metros à la place des fonctionnalités de la CLI ou de l'API.

Attention, l'utilisation du paramètre "facilities" est incompatible avec celle du paramètre "metros" ; c'est pas possible d'utiliser les deux.

Requêtes de capacité

Suite à la suppression des points de terminaison Facilities, les réponses aux requêtes CLI et API suivantes renverront des en-têtes de réponse contenant des informations de suppression. Veuillez mettre à jour les scripts ou automatisations utilisant ces points de terminaison afin d'interroger plutôt la capacité du métro (capacité métro).

• La commande metal capacity lorsqu'elle est utilisée avec une Facility au lieu d'un Metro.
• La commande metal capacity check lorsqu'elle est utilisée avec une Facility au lieu d'un Metro.
• Le point de terminaison /capacity.

Dans quelle métropole ou installation se trouve mon serveur ?

Les réponses concernant les serveurs et autres infrastructures contenant un objet "facilities" continueront de le renvoyer. Pour les infrastructures approvisionnées au niveau du réseau métropolitain, l'objet "facilities" peut être vide.

Toutes les réponses contiennent un objet "metro", pour identifier le métro dans lequel elles sont provisionnées.

Vous pouvez toujours déterminer dans quelle installation se trouve votre serveur. Cependant, sachez que la diversité au niveau de l'installation ne garantit ni la haute disponibilité ni la redondance. Pour mettre en place et configurer la haute disponibilité, privilégiez une architecture multi-métro.

CLI

Utilisez la commande metal device et précisez que vous voulez une réponse JSON en utilisant l'indicateur de sortie -o.

metal device get -i <device_id> -o json

API

Envoyer 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}

L'interface de ligne de commande (CLI) et l'API renvoient toutes deux une réponse contenant un objet "facility". Exemple de réponse:

{
"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"
    }
  },
...
}