跳至内容

元数据

元数据是每个Equinix Metal™ 服务器实例上提供的服务，允许其访问和共享有关自身的各种数据。

只有在服务器在配置过程中达到“活动”状态后，才能访问元数据。如果您使用的是Equinix Metal OS 映像，则通常是在操作系统完全安装且服务器准备就绪之后。如果您使用的是自定义 iPXE，则在Equinix Metal初始启动过程完成后，且在操作系统写入磁盘之前，您的服务器将处于“活动”状态。这允许您在自定义 iPXE 配置期间访问元数据端点。

限制：

  • 仅当服务器处于第 3 层或混合绑定网络模式时，元数据端点才可用。纯第 2 层网络模式不支持元数据端点。
  • 元数据只能从服务器本身访问。服务器上运行的脚本或实用程序可以访问元数据端点，并且如果您通过 SSH 连接到服务器，则用户也可以访问该端点。

检索元数据​

您可以使用 cURL 等工具查询以下端点来查看服务器实例的元数据。如果您想从元数据中获取特定信息，可以使用 jq 按特定字段进行筛选。

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

元数据服务在其自身的端点上提供了一些特定的资源，这些资源在元数据资源部分中有所介绍。

完整元数据内容​

关于​

元数据包含一些顶级信息，例如主机名、计划和服务器的 UUID。它还包含一些用于设置自动化或配置其他功能（例如服务器的城域网和设备）的有用字段。如果您要设置 iSCSI 卷，则还会包含服务器的 IQN。

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

操作系统​

operating_system 表示已安装的操作系统及其版本。如果您使用的是 Equinix Metal 的操作系统镜像，则它还会包含镜像标签。

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

SSH 密钥​

ssh_keys 是一个数组，其中包含在配置时添加到服务器的所有 SSH 密钥。

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

状态​

state 表示设备的当前状态。

"state": "active",

储存​

存储信息包含磁盘、分区和文件系统信息。

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

规格​

specs 对象包含服务器中的特定硬件组件。

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

网络​

network 对象包含有关绑定（或多个绑定）的信息、绑定中的各个网络接口，以及服务器管理 IP 地址的所有详细信息。如果服务器连接到 Metal 网关，则 metal_gateways 对象会填充其信息。

"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": [
    "test",
    "SV_01",
    "Dev"
  ],

网址​

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

如果您使用自定义 iPXE 或自定义用户数据来配置服务器，则 phone_home_url 和 user_state_url 非常有用。

BGP邻居​

如果您的项目和服务器启用了 BGP，则元数据中包含 bgp_neighbors 对象。如果未启用 BGP，则不会包含该对象。

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

用户数据​

如果您在配置服务器时使用了用户数据，它将存储在磁盘上，并在配置完成后可通过元数据端点访问。您可以从元数据端点使用cURL访问它。

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

元数据资源​

要获取所有可用元数据资源的列表，您可以查询 https://metadata.platformequinix.com/2009-04-04/meta-data。注意：该路径包含特定的元数据版本。2009-04-04 是当前版本。

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

要获取特定的元数据资源，您还可以查询每个选项。例如，要检索实例 ID：

curl https://metadata.platformequinix.com/2009-04-04/meta-data/instance-id
此页面有帮助吗？