本文へスキップ

メタデータ

メタデータは、エクイニクスMetal™サーバーインスタンスで提供されるサービスで、サーバーインスタンス自身に関するさまざまなデータにアクセスし、共有することができます。

メタデータにアクセスできるのは、プロビジョニングプロセスでサーバーが「アクティブ」状態になった後です。Equinix Metal OSイメージを使用している場合は、通常、オペレーティングシステムが完全にインストールされ、サーバーが準備完了した後です。カスタムiPXEを使用している場合、Equinix Metalの初期ブートプロセスが終了し、OSがディスクに書き込まれる前にサーバーは「アクティブ」になります。これにより、Custom iPXEプロビジョニング中にメタデータエンドポイントにアクセスできるようになります。

制限：

  • メタデータ・エンドポイントは、サーバーがレイヤ3またはハイブリッド・ボンディング・ネットワーキング・モードの場合にのみ使用できます。純粋なレイヤ2のみのネットワーキング・モードでは、メタデータ・エンドポイントはサポートされません。
  • メタデータにはサーバー本体からのみアクセスできる。サーバー上で実行されているスクリプトやユーティリティはメタデータ・エンドポイントにアクセスでき、サーバーにSSH接続している場合はエンドポイントへのユーザー・アクセスが可能です。

メタデータの取得​

メタデータから特定の情報を取得したい場合は、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のOSイメージでプロビジョニングした場合は、イメージタグも含まれます。

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

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"

phone_home_urlとuser_state_urlは、カスタムiPXEまたはカスタムユーザーデータを使用してサーバーのプロビジョニングと構成を行う場合に便利です。

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

ユーザーデータ​

サーバーのプロビジョニング時にUserdataを使用している場合、ディスクに保存され、プロビジョニング後にメタデータエンドポイントから利用できます。メタデータエンドポイントから 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
このページは役に立ちましたか？