Ir al contenido principal

Metadatos

Los metadatos son un servicio ofrecido en cada instancia de servidor Equinix Metal™ que le permite acceder y compartir diversos datos sobre sí mismo.

Sólo se puede acceder a los metadatos después de que el servidor haya alcanzado el estado "Activo" en el proceso de aprovisionamiento. Si utiliza una imagen del sistema operativo Equinix Metal, esto suele ocurrir una vez que el sistema operativo está completamente instalado y el servidor está listo para funcionar. Si utiliza iPXE personalizado, el servidor estará "activo" una vez que haya finalizado el proceso de arranque inicial de Equinix Metal y antes de que el sistema operativo se escriba en el disco. Esto le permite acceder al punto final de metadatos durante el aprovisionamiento personalizado de iPXE.

Limitaciones:

  • El punto final de metadatos sólo está disponible cuando un servidor está en los modos de red de Capa 3 o Enlace híbrido. Los modos de red de capa 2 pura no admiten el punto final de metadatos.
  • Sólo se puede acceder a los metadatos desde el propio servidor. Las secuencias de comandos o utilidades que se ejecutan en el servidor pueden acceder al punto final de metadatos, y el acceso del usuario al punto final está disponible si está conectado mediante SSH al servidor.

Recuperación de metadatos​

Puede ver los metadatos de una instancia de servidor consultando el siguiente punto final con una herramienta como cURL.Si desea obtener información específica de los metadatos, puede utilizar jq para filtrar en campos específicos.

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

Existen recursos específicos proporcionados por el servicio de metadatos en sus propios puntos finales, éstos se tratan en la sección Recursos de metadatos.

Contenido completo de los metadatos​

Acerca de​

Los metadatos incluyen información de alto nivel como el nombre de host, el plan y el UUID de tu servidor. También contiene algunos campos útiles para configurar la automatización o configurar otras características, como el metro y la instalación de su servidor. Si está configurando volúmenes iSCSI, también se incluye el IQN del servidor.

"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",

Sistema operativo​

El operating_system le indica el sistema operativo y la versión instalados. Si se aprovisionó con una de las imágenes de sistema operativo de Equinix Metal, también contendrá la etiqueta de imagen.

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

Claves SSH​

ssh_keys es una matriz de todas las claves SSH que se añadieron al servidor en el momento de la provisión.

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

Estado​

state le indica el estado actual de un dispositivo.

"state": "active",

Almacenamiento​

La información de almacenamiento contiene la información del disco, la partición y el sistema de archivos.

"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"
            ]
          }
        }
      }
    ]
},

Especificaciones​

El objeto specs contiene los componentes de hardware específicos de su servidor.

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

Red​

El objeto network contiene información sobre el enlace (o enlaces), las interfaces de red independientes en los enlaces y todos los detalles sobre las direcciones IP de gestión de su servidor. Si el servidor está conectado a un Metal Gateway, metal_gateways se rellena con su información.

"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": []
},

Etiquetas​

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

Los phone_home_url y user_state_url son útiles si está utilizando iPXE personalizado o datos de usuario personalizados para aprovisionar y configurar sus servidores.

Vecinos BGP​

Si tiene BGP activado en su Proyecto y servidor, entonces los metadatos contienen el objeto bgp_neighbors. No estará presente si BGP no está habilitado.

"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": []
  }
],

Datos del usuario​

Si utiliza Userdata al aprovisionar su servidor, se almacena en el disco y está disponible desde el punto final de metadatos tras el aprovisionamiento. Puede cURLarlo desde el punto final de metadatos.

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

Recursos de metadatos​

Para obtener una lista de todos los recursos de metadatos disponibles, puede consultar https://metadata.platformequinix.com/2009-04-04/meta-data. Nota: la ruta contiene una versión específica de metadatos. 2009-04-04 es la versión actual.

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

Para obtener los recursos de metadatos específicos, también puede consultar cada una de las opciones. Por ejemplo, para recuperar el ID de instancia:

curl https://metadata.platformequinix.com/2009-04-04/meta-data/instance-id
¿Fue útil esta página?