Skip to main content

Métadonnées

Les métadonnées sont un service offert sur chaque instance de serveur Equinix Metal™ qui lui permet d'accéder à diverses données la concernant et de les partager.

Les métadonnées ne sont accessibles qu'une fois que le serveur a atteint l'état " actif " dans le processus de provisionnement. Si vous utilisez une image de système d'exploitation Equinix Metal, c'est généralement une fois que le système d'exploitation est entièrement installé et que votre serveur est prêt à fonctionner. Si vous utilisez Custom iPXE, votre serveur sera " actif " une fois que le processus de démarrage initial d'Equinix Metal sera terminé et avant que le système d'exploitation ne soit écrit sur le disque. Cela vous permet d'accéder au point de terminaison des métadonnées pendant le provisionnement iPXE personnalisé.

Limites :

  • Le point de terminaison des métadonnées n'est disponible que lorsqu'un serveur est en mode réseau de couche 3 ou Hybrid Bonded. Les modes de mise en réseau de la couche 2 uniquement ne prennent pas en charge le point de terminaison des métadonnées.
  • Les métadonnées ne sont accessibles qu'à partir du serveur lui-même. Les scripts ou les utilitaires exécutés sur le serveur peuvent accéder au point de terminaison des métadonnées, et l'utilisateur peut accéder au point de terminaison s'il est connecté au serveur par SSH.

Récupération des métadonnées​

Vous pouvez consulter les métadonnées d'une instance de serveur en interrogeant le point de terminaison suivant à l'aide d'un outil tel que cURL. Si vous souhaitez obtenir des informations spécifiques à partir des métadonnées, vous pouvez utiliser jq pour filtrer sur des champs spécifiques.

curl https://metadata.platformequinix.com/metadata | jq

Il existe des ressources spécifiques fournies par le service de métadonnées à leurs propres points de terminaison, elles sont couvertes dans la section Ressources de métadonnées.

Contenu complet des métadonnées​

A propos de​

Les métadonnées comprennent des informations de premier niveau telles que le nom d'hôte, le plan et l'UUID de votre serveur. Elles contiennent également des champs utiles pour configurer l'automatisation ou d'autres fonctionnalités, telles que le métro et l'installation de votre serveur. Si vous configurez des volumes iSCSI, l'IQN du serveur est également inclus.

"id": "d4b783e9-89f3-4d35-bdcd-ff6753b11911",
"hostname": "bgp-testing-3",
"iqn": "iqn.2021-09.net.packet:device.d4b783e9",
"plan": "c3.small.x86",
"reserved": false,
"class": "c3.small.x86",
"facility": "sv15",
"metro": "sv",
"private_subnets": [
  "10.0.0.0/8"
],
"switch_short_id": "3bbc11a0",

Système d'exploitation​

Le operating_system indique le système d'exploitation et la version installés. Si vous avez effectué un provisionnement avec l'une des images de système d'exploitation d'Equinix Metal, il contiendra également la balise image.

"operating_system": {
    "slug": "ubuntu_20_10",
    "distro": "ubuntu",
    "version": "20.10",
    "license_activation": {
      "state": "unlicensed"
    },
    "image_tag": "151bba731256fdfefb25bccbcf16575b999c1e6c"
},

Clés SSH​

ssh_keys est un tableau de toutes les clés SSH qui ont été ajoutées au serveur au moment de la mise à disposition.

"ssh_keys": [
    "ssh-rsa AAAAB3..."
],

État​

state vous indique l'état actuel d'un appareil.

"state": "active",

Stockage​

Les informations sur le stockage contiennent des informations sur le disque, la partition et le système de fichiers.

"storage": {
    "disks": [
      {
        "device": "/dev/sda",
        "wipeTable": true,
        "partitions": [
          {
            "label": "BIOS",
            "number": 1,
            "size": 4096
          },
          {
            "label": "SWAP",
            "number": 2,
            "size": "3993600"
          },
          {
            "label": "ROOT",
            "number": 3,
            "size": 0
          }
        ]
      }
    ],
    "filesystems": [
      {
        "mount": {
          "device": "/dev/sda3",
          "format": "ext4",
          "point": "/",
          "create": {
            "options": [
              "-L",
              "ROOT"
            ]
          }
        }
      },
      {
        "mount": {
          "device": "/dev/sda2",
          "format": "swap",
          "point": "none",
          "create": {
            "options": [
              "-L",
              "SWAP"
            ]
          }
        }
      }
    ]
},

Spécifications​

L'objet specs contient les composants matériels spécifiques de votre serveur.

"specs": {
    "cpus": [
      {
        "count": 1,
        "type": "Intel(R) Xeon(R) E-2278G CPU @ 3.40GHz"
      }
    ],
    "memory": {
      "total": "32GB"
    },
    "drives": [
      {
        "count": 2,
        "size": "480GB",
        "type": "SSD",
        "category": "boot"
      }
    ],
    "nics": [
      {
        "count": 2,
        "type": "10Gbps"
      }
    ],
    "gpu": [
      {
        "count": 1,
        "type": "Intel HD Graphics P630"
      }
    ],
    "features": {
      "raid": false,
      "txt": true,
      "uefi": false
    }
},

Réseau​

L'objet network contient des informations sur le lien (ou les liens), les interfaces réseau séparées dans les liens et tous les détails sur les adresses IP de gestion de votre serveur. Si le serveur est connecté à une passerelle Metal, metal_gateways est rempli avec ses informations.

"network": {
  "bonding": {
    "mode": 4,
    "link_aggregation": "mlag_ha",
    "mac": "0c:42:a1:65:fd:ce"
  },
  "interfaces": [
    {
      "name": "eth0",
      "mac": "0c:42:a1:65:fd:ce",
      "bond": "bond0"
    },
    {
      "name": "eth1",
      "mac": "0c:42:a1:65:fd:cf",
      "bond": "bond0"
    }
  ],
  "addresses": [
    {
      "id": "aee6e0ca-70d1-4af2-b9b6-744e115ca1c4",
      "address_family": 4,
      "netmask": "255.255.255.254",
      "created_at": "2021-09-15T15:25:08Z",
      "public": true,
      "cidr": 31,
      "management": true,
      "enabled": true,
      "network": "203.0.113.0",
      "address": "203.0.113.1",
      "gateway": "203.0.113.0",
      "parent_block": {
        "network": "203.0.113.0",
        "netmask": "255.255.255.254",
        "cidr": 31,
        "href": "/ips/afc6f4cc-04f7-4c63-ac4d-a8e0aea541db"
      }
    },
    {
      "id": "97411ab0-922f-43b6-9b4f-e22b2b9a6c11",
      "address_family": 6,
      "netmask": "ffff:ffff:ffff:ffff:ffff:ffff:ffff:fffe",
      "created_at": "2021-09-15T15:25:08Z",
      "public": true,
      "cidr": 127,
      "management": true,
      "enabled": true,
      "network": "2001:DB8:45e1:5000::",
      "address": "2001:DB8:45e1:5000::1",
      "gateway": "2001:DB8:45e1:5000::",
      "parent_block": {
        "network": "2001:DB8:45e1:5000:0000:0000:0000:0000",
        "netmask": "ffff:ffff:ffff:ff00:0000:0000:0000:0000",
        "cidr": 56,
        "href": "/ips/7281c066-f4c2-4700-88da-b90dc3b5da32"
      }
    },
    {
      "id": "b04b5c36-82aa-4f5e-a026-8bddee388134",
      "address_family": 4,
      "netmask": "255.255.255.254",
      "created_at": "2021-09-15T15:25:08Z",
      "public": false,
      "cidr": 31,
      "management": true,
      "enabled": true,
      "network": "10.67.50.0",
      "address": "10.67.50.1",
      "gateway": "10.67.50.0",
      "parent_block": {
        "network": "10.67.50.0",
        "netmask": "255.255.255.128",
        "cidr": 25,
        "href": "/ips/b4b06d38-8730-47e3-8bbe-415b86aafea4"
      }
    }
  ],
  "metal_gateways": []
},

Tags​

  "tags": [
    "test",
    "SV_01",
    "Dev"
  ],

URL​

"api_url": "https://metadata.packet.net",
"phone_home_url": "http://tinkerbell.sv15.packet.net/phone-home",
"user_state_url": "http://tinkerbell.sv15.packet.net/events"

Les phone_home_url et user_state_url sont utiles si vous utilisez iPXE personnalisé ou des données utilisateur personnalisées pour approvisionner et configurer vos serveurs.

Voisins BGP​

Si BGP est activé sur votre projet et votre serveur, les métadonnées contiennent l'objet bgp_neighbors. Il ne sera pas présent si BGP n'est pas activé.

"bgp_neighbors": [
  {
    "address_family": 4,
    "customer_as": 65000,
    "customer_ip": "10.67.50.1",
    "md5_enabled": false,
    "md5_password": null,
    "multihop": true,
    "peer_as": 65530,
    "peer_ips": [
      "169.254.255.1",
      "169.254.255.2"
    ],
    "routes_in": [
      ...
    ],
    "routes_out": []
  },
  {
    "address_family": 6,
    "customer_as": 65000,
    "customer_ip": "2604:1380:45e1:5000::1",
    "md5_enabled": false,
    "md5_password": null,
    "multihop": true,
    "peer_as": 65530,
    "peer_ips": [
      "fc00:0000:0000:0000:0000:0000:0000:000e",
      "fc00:0000:0000:0000:0000:0000:0000:000f"
    ],
    "routes_in": [
      ...
    ],
    "routes_out": []
  }
],

Données de l'utilisateur​

Si vous utilisez Userdata lors du provisionnement de votre serveur, il est stocké sur le disque et disponible à partir du point de terminaison des métadonnées après le provisionnement. Vous pouvez l'obtenir par cURL à partir du point de terminaison des métadonnées.

curl https://metadata.platformequinix.com/userdata

Ressources en métadonnées​

Pour obtenir une liste de toutes les ressources de métadonnées disponibles, vous pouvez interroger https://metadata.platformequinix.com/2009-04-04/meta-data. Remarque : le chemin d'accès contient une version spécifique des métadonnées. 2009-04-04 est la version actuelle.

curl https://metadata.platformequinix.com/2009-04-04/meta-data
instance-id
hostname
iqn
plan
facility
tags
operating-system
public-keys
public-ipv4
public-ipv6
local-ipv4

Pour obtenir des ressources de métadonnées spécifiques, vous pouvez également interroger chacune des options. Par exemple, pour obtenir l'ID de l'instance :

curl https://metadata.platformequinix.com/2009-04-04/meta-data/instance-id
Cette page vous a-t-elle été utile ?