Skip to main content

Métadonnées

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

Les métadonnées ne sont accessibles qu'une fois le serveur actif lors du provisionnement. Si vous utilisez une image Equinix Metal OS, cela se produit généralement une fois le système d'exploitation entièrement installé et votre serveur prêt à fonctionner. Si vous utilisez Custom iPXE, votre serveur sera actif une fois le processus de démarrage initial Equinix Metal terminé et avant l'écriture du système d'exploitation sur le disque. Cela vous permet d'accéder au point de terminaison des métadonnées pendant le provisionnement Custom iPXE.

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 hybride. Les modes réseau de 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 utilitaires exécutés sur le serveur peuvent accéder au point de terminaison des métadonnées, et l'accès utilisateur à ce point de terminaison est possible si vous êtes connecté au serveur via 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 avec un outil tel que cURL. Si vous souhaitez extraire des informations spécifiques 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, celles-ci sont traitées dans la section Ressources de métadonnées.

Contenu complet des métadonnées​

À propos de​

Les métadonnées incluent 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 la zone métropolitaine et l'emplacement 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 opérateur​

L'identifiant operating_system indique le système d'exploitation et sa version installés. Si vous avez utilisé une image système d'Equinix Metal, cet identifiant contiendra également l'étiquette de l'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 en service.

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

État​

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

"state": "active",

Stockage​

Les informations de stockage contiennent les 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 ou les liens, les interfaces réseau distinctes au sein de ces liens, ainsi que tous les détails relatifs aux adresses IP de gestion de votre serveur. Si le serveur est connecté à une passerelle Metal Gateway, l'objet metal_gateways contient 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": []
},

Mots clés​

  "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 un iPXE personnalisé ou des données utilisateur personnalisées pour provisionner et configurer vos serveurs.

Voisins BGP​

Si le protocole BGP (../bgp/bgp-on-equinix-metal.mdx) est activé sur votre projet et votre serveur, les métadonnées contiennent l'objet bgp_neighbors. Cet objet est absent 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 utilisateur​

Si vous utilisez Userdata lors de l'approvisionnement de votre serveur, ce fichier est stocké sur le disque et accessible via le point de terminaison des métadonnées après le provisionnement. Vous pouvez y accéder par cURL à partir de ce point de terminaison.

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

Ressources de métadonnées​

Pour obtenir la 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 contient une version spécifique des métadonnées. 2009-04-04 correspond à 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 les ressources de métadonnées spécifiques, vous pouvez également interroger chacune des options. Par exemple, pour récupérer l'ID d'instance:

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