エクイニクスメタル上のVLAN
Equinix Metal™は、お客様のサーバーやその他のインフラストラクチャを接続するレイヤ2仮想ネットワークを提供します。エクイニクスのVLANについてご紹介します:
- VLANはすべてのメトロで利用可能です。
- VLANはプロジェクトレベルのインフラストラクチャです。
- プロジェクトにVLANを追加しても、追加費用は発生しません。
- 最初の制限は1プロジェクトにつき5VLANで、すべてのVLANが同じメトロである必要はありません。support@equinixmetal.com にご連絡いただければ、上限を増やすことも可能です。
- VLANはメトロにローカルです。メトロ外のVLANにサーバーを接続することはできません。
- VLANは最大9000バイトの最大伝送単位(MTU)とジャンボイーサネットフレームをサポートします。
- Equinix MetalネットワークとVLANは、
TPID 0x8100タグ付きフレームの外側にスタックされたVLANタグ付きトラフィックをサポートしています。これらのスタックされたTPID 0x8100フレームのサポートは、専用ポートのトンネルモードを通じて、より広いエクイニクス相互接続に拡張されています。
また、ネットワークを設計する際に注意すべき特定の制限もいくつかあります。これらの制限に遭遇した場合は、サポートまたはアカウント・マネージャーにご連絡ください。
-
レイヤー2制御プロトコル - Equinix Metalのレイヤー2またはVLAN機能は、Equinix Metalインスタンスから他のEquinix Metalホストを含む広範なネットワークへのレイヤー2制御プロトコル(L2CP)の送信をサポートしていません。LACP、ポーズ、スパニングツリーなどのトラフィックは、レイヤー2やVLAN接続が正しく設定されていても、Equinix Metalインスタンスに接続されているスイッチによってドロップされます。この動作は、Equinix Metalネットワーク自体を保護するために設計されています。
-
マルチキャストトラフィック - Equinix Metalでは、設定されたレイヤ2ネットワークやVLANを経由してマルチキャストトラフィックを伝送することができますが、高いスループットではパフォーマンスの制約を受ける可能性があります。毎秒数ギガビットのマルチキャストトラフィックを想定している場合は、サポートまたは営業担当までお問い合わせください。また、Equinix Metalはインターネットグループ管理プロトコル(IGMP)またはIGMP Snoopingカテゴリのマルチキャストトラフィックをサポートしていません。
-
QinQ、
TPID 0x88a8- Equinix MetalはスタックドVLANタグTPID 0x8100をサポートしていますが、QinQ、TPID 0x88a8ネットワーキング・モードは正式にサポートしていません。 -
Media Access Control Security (MACsec) - Equinix Metalは、レイヤ2ネットワークおよびVLANを経由したMACsec設定の拡張をサポートしていません。
VLANの作成
- Console
- CLI
- API
プロジェクトの Layer 2 VLAN ページで VLAN を管理します。VLAN をプロビジョニングするには、+ Add VLAN をクリックします。

- 唯一の必須フィールドは_Location_です。ドロップダウンからVLANが存在するメトロを選択します。
- VLANの_Description_フィールドには、親しみやすく人間的な説明を記述することができます。
- オプションの_VNID_フィールドには、VLAN IDとして2~3999の整数を入力できます。省略した場合、VLAN IDはメトロによって1000から段階的に自動割り当てされます。
Add をクリックすると、VLANがプロビジョニングされます。プロビジョニングが完了すると、新しい VLAN が Layer 2 ページに表示されます。ここで表示される割り当てVLAN IDは、VLANにサーバをアタッチする際に使用されます。
CLIでVLANを作成するには、metal virtual-network createコマンドを使用します。
metal virtual-network create -p <project_id> -m <metro_code> -vxlan <vlan>
オプション
-p(required) - Your Project ID.-m(required) - The metro where you are creating the VLAN.--vxlan(optional) - Specify an integer between 2 and 3999 to serve as the VLAN ID. If omitted, the VLAN ID is auto-assigned incrementally by metro, starting at 1000.--description(optional) - A field for a friendly description of the VLAN.
VLAN を作成するには、/projects/{id}/virtual-networks エンドポイントに POST リクエストを送信します。パスに VLAN のプロジェクト ID を指定します。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/virtual-networks" \
-d '{
"vxlan": <integer>,
"description": "<string>",
"metro": "<string>"
}'
ボディ・パラメーター
"metro"(required) - The two-letter metro code for where the VLAN is located."vxlan"(optional) - An integer between 2 and 3999 to serve as the VLAN ID. If omitted, the VLAN ID is auto-assigned incrementally by metro, starting at 1000."description"(optional) - A friendly, human description of the VLAN, if desired.
VLANの使用
VLANを設定したら、プロジェクト内のどのサーバーもVLANに接続できるように設定できます。各サーバーに選択するネットワーキング・モードは、ユースケース、場所、高可用性によって異なります。
異なるネットワーキング・モードの概要は、レイヤ2ネットワーキングの概要 ページにあります。
各ネットワーキングモードへの変換方法と、VLANに接続するためのサーバーの設定方法の詳細と説明は、各モードのページに記載されています。
ポートにVLANを割り当てる
VLANをポートにアタッチできるのは、サーバーのネットワーク・モードを変更した後なので、その方法については、各ネットワーク・モードのページに説明があります。
通常、VLANの割り当てはEquinix Metalコンソールの「_Network」ページ、CLIの「metal portコマンド、APIの/ports/{id}/assignエンドポイントにPOSTを送信して行います。
VLANの管理
- Console
- CLI
- API
プロジェクトの_Layer 2 VLAN_ページでVLANを管理します。プロジェクト内の各VLANは、ID、説明、場所、接続数、およびDelete のオプションとともに一覧表示されます。

VLANが使用されている場合、_Devices_列にVLANに接続されているデバイスの数が表示され、その数をクリックすると、それらのデバイスのリストが表示されます。
プロジェクト内のすべての VLAN をリストするには、metal virtual-network get コマンドを使用します。
metal virtual-network get -p <project_id>
プロジェクト内の VLAN をリストするには、/projects/{id}/virtual-networks エンドポイントに GET リクエストを送信します。
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/projects/{id}/virtual-networks
特定の VLAN の詳細を取得するには、/virtual-networks/{id} エンドポイントに GET リクエストを送信します。
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/virtual-networks/{id}
VLAN が使用中の場合、GET のレスポンスには "instances" フィールドに VLAN が接続されているデバイスのリストが含まれます。
VLANポート割り当ての表示
- Console
- CLI
- API
サーバーの[ネットワーク]タブで、サーバーがどのVLANに接続されているかを確認できます。

レイヤ2」のセクションでは、VLANがどのポートに割り当てられているかを確認できます。

metal port get コマンドでポートに割り当てられた VLAN を表示し、--output コマンドで JSON レスポンスの取得を指定できます。
metal port get --port-id <port_id> --output json
ポートに割り当てられた VLAN のリストを取得するには、/ports/{id}/vlan-assignments/ エンドポイントに GET リクエストを送信します。
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/ports/{id}/vlan-assignments/
個々の VLAN 割り当ての詳細を取得するには、/ports/{id}/vlan-assignments/{id} エンドポイントに GET リクエストを送信します。
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/ports/{id}/vlan-assignments/{id}
VLANの一括操作
エクイニクスメタルは、非同期バッチリクエストプロセスを通じて、VLANの一括割り当てと割り当て解除をサポートしています。
- Console
- CLI
- API
ポートに複数のVLANを割り当てるには、サーバーの_Network_タブのレイヤ2セクションに移動します。Add New VLAN をクリックすると、ポートに追加する複数のVLANを選択するオプションがあります。

ポートに複数の VLAN をアサインする場合は、metal port vlan コマンドで各 VLAN を指定します。
metal port vlan --port-id <bond0_id> --assign <vlan> --assign <vlan>
複数のVLANを削除する場合は、削除するVLANごとに指定してください。
metal port vlan --port-id <bond0_id> --unassign <vlan> --unassign <vlan>
ポートに VLAN を一括割り当てまたは割り当て解除するには、リクエストの本文に VLAN 割り当て(または割り当て解除)のアレイを含む POST リクエストを /ports/{id}/vlan-assignments/batches エンドポイントに送信します。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN> " \
"https://api.equinix.com/metal/v1/ports/{id}/vlan-assignments/batches" \
-d '{
"vlan_assignments": [
{
"vlan": "string",
"state": "string"
},
{
"vlan": "string",
"state": "string"
},
]
}'
ポートに VLAN を割り当てるには、"state" パラメータを "assigned" に設定します。ポートから VLAN の割り当てを解除するには、"state" パラメータを "unassigned" に設定します。同じ要求で、VLAN のセットを割り当てることも、別の VLAN のセットを割り当て解除することもできます。
このプロセスは非同期のバッチプロセスであるため、すぐに完了しない場合があります。VLAN 割り当てバッチの詳細のステータスを確認するには、/ports/{id}/vlan-assignments/batches/{id} エンドポイントに GET リクエストを送信します。応答はバッチ内の各割り当てまたは割り当て解除の状態を返します。状態は、"queued"、"in_progress"、"completed"、および "failed "です。
ポートに複数のバッチ要求を行った場合、/ports/{id}/vlan-assignments/batches エンドポイントに GET 要求を送信することで、その特定のポートの VLAN 割り当てバッチのリストを取得できます。
ポートからVLANを削除する
- Console
- CLI
- API
サーバーの_Network_タブの_Layer 2_セクションで、ポートからVLANを削除できます。VLANを選択し、削除 をクリックします。

ポートから VLAN を削除したり、確認としてDelete をクリックしても、VLAN は削除されません。
CLI で、metal port vlan コマンドを使用してポートから VLAN を削除します。
metal ports vlan --port-id <bond0_id> --unassign <vlan>
複数のVLANを削除する場合は、削除するVLANごとに指定してください。
metal port vlan --port-id <bond0_id> --unassign <vlan> --unassign <vlan>
API では、/ports/{id}/unassign エンドポイントに POST を送信することで、ポートから VLAN を削除します。
パスの中で VLAN がアタッチされるポート ID を指定する必要があり、/devices/{id} エンドポイントによって返されるそのポートの UUID である必要があります。
VLAN の ID はリクエストのボディで送信され、/projects/{id}/virtual-networks エンドポイントによって返される VLAN の UUID か、コンソールにある vxlan ID のどちらかになります。ID です。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN> " \
"https://api.equinix.com/metal/v1/ports/{id}/assign" \
-d '{
"vnid": "c4032b18-5494-451b-a779-a7d3c536bfd7"
}'
非同期バッチプロセスの一部として、ポートへの VLAN の割り当てを一括して解除することも可能です。POST リクエストを /ports/{id}/vlan-assignments/batches エンドポイントに送信し、リクエストの本文に VLAN 割り当ての配列を指定します。
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN> " \
"https://api.equinix.com/metal/v1/ports/{id}/vlan-assignments/batches" \
-d '{
"vlan_assignments": [
{
"vlan": "string",
"state": "unassigned"
},
{
"vlan": "string",
"state": "unassigned"
},
]
}'
VLANは、VLANのUUIDまたはコンソールにあるVLAN IDのいずれかで識別できます。ポートから VLAN の割り当てを解除するので、"state" フィールドは "unassigned" にします。
VLANの削除
- Console
- CLI
- API
レイヤ2 VLAN_]ページを開きます。削除する VLAN を選択し、削除 。複数の VLAN を確認する場合は、削除する VLAN をそれぞれ選択し、Delete をクリックします。

VLAN を削除するには、metal virtual-network delete コマンドを使用します。
metal virtual-network delete --id <vlan_id>
VLAN を削除するには、/virtual-networks/{id} エンドポイントに DELETE リクエストを送信します。
curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/virtual-networks/{id}
デバイスがアタッチされているVLANを削除することはできません。そうしないとエラーが返されます。
施設ベースのVLAN
2021年4月にMetroが導入される以前は、VLANは施設レベルでプロビジョニングされ、VLANは単一の施設内のサーバーのみを接続することができました。メトロス導入前にプロビジョニングされたVLANは、この方法で機能し続け、そのまま機能し続けます。
しかし、施設ベースのVLANとメトロベースのVLANは互換性がない。
まず、同じプロジェクト内でファシリティVLANとメトロVLANの両方を持つことは可能ですが、ファシリティVLAN 1001があれば、メトロVLAN 1001を作成することはできません。同様に、メトロVLAN 1002があれば、ファシリティVLAN 1002を持つことはできません。
第二に、既存の施設レベルのVLANをメトロVLANに拡張することはできません。まったく新しいメトロ対応VLANをプロビジョニングし、それを使用するようにサーバーを再設定する必要があります。