Facilités (obsolètes)

En mai 2023, Equinix Metal™ supprime les points d'extrémité 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 Metro.

A partir de May 30th, 2023:

• L'API renvoie des en-têtes de réponse contenant des messages de dépréciation et d'extinction aux demandes envoyées à des points de terminaison d'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 et ne pourront pas 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 à la fin de l'année 2023.

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

Avec la dépréciation 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 sur la dépréciation. Veuillez mettre à jour tous les scripts ou automatismes qui utilisent ces points de terminaison afin d'interroger les métros à la place.

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

Utilisez plutôt les commandes et les 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 : toutes les métros sont visibles par toutes les organisations et tous les projets.

Provisionnement

Avec l'abandon des points d'extrémité Facilities, les réponses aux requêtes CLI et API suivantes renverront des en-têtes de réponse contenant des informations sur l'abandon. Veuillez mettre à jour tous les scripts ou automatismes qui utilisent ces points de terminaison pour provisionner en utilisant Metros à la place.

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 de provisionnement POST projects/{id}/devices, utilisez le champ "metro" avec le metro_code où vous souhaitez que le serveur soit installé 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" ne prend qu'un type de chaîne. "facilities" prend une chaîne ou un tableau de chaînes.

Utilisation des métros à la place des installations

Comme pour le provisionnement des serveurs à la demande, d'autres options de déploiement et fonctionnalités de la plateforme qui permettaient auparavant le provisionnement dans des installations spécifiques renverront des en-têtes de réponse indiquant qu'elles sont obsolètes.

Veuillez mettre à jour vos scripts ou vos automatismes pour utiliser les métros à la place des facilités dans l'interface de programmation ou l'API.

Attention, l'utilisation du paramètre "facilities" est mutuellement exclusive du paramètre "metros" ; il n'est pas possible d'utiliser les deux.

Requêtes de capacité

Avec la dépréciation des points de terminaison Facilities, les réponses aux demandes CLI et API suivantes renverront des en-têtes de réponse contenant des informations de dépréciation. Veuillez mettre à jour tous les scripts ou automatismes qui utilisent ces points de terminaison pour demander Metro capacity à la place.

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

Dans quel métro ou établissement se trouve mon serveur ?

Les réponses pour les serveurs et autres infrastructures qui contiennent un objet "facilities" continueront à le renvoyer. Pour les infrastructures provisionnées au niveau métropolitain, l'objet "facilities" peut être vide.

Toutes les réponses contiennent un objet "metro", pour identifier le métro dans lequel la réponse est fournie.

Vous pouvez toujours savoir dans quelle installation se trouve votre serveur, mais vous devez savoir que la diversité au niveau de l'installation n'offre pas de garanties de haute disponibilité ou de redondance. Pour mettre en place et configurer la haute disponibilité, vous devez opter pour une architecture multi-métropole.

CLI

Utilisez la commande metal device et indiquez que vous souhaitez une réponse JSON à l'aide de l'indicateur de sortie -o.

metal device get -i <device_id> -o json

API

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}

La CLI et l'API renvoient toutes deux une réponse comprenant 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"
    }
  },
...
}