メタル課金ファブリック仮想接続

Metal Billed Fabric Virtual Connectionsを利用すると、Equinix Metal™から同じメトロ内のFabric上の他のクラウドサービスプロバイダー（CSP）へ、Network Edgeデバイスなしでレイヤー2の仮想接続を行うことができます。aサイドのサービストークンを利用するには、エクイニクスFabricポータルのアカウントが必要です。

システム情報

• 各仮想ファブリック接続は、単一のポートまたは冗長ポートのセットにすることができます。ある程度の高可用性を確保するには冗長ポートを推奨します。単一ポートの場合、アップタイムは保証されません。

• 各ファブリック仮想接続には、VLANまたはVRFに接続するための1つの仮想サーキットが付属しています。冗長ポートを使用している場合は、各ポートに1つのバーチャルサーキットがあります。

• バーチャルサーキットとVLANの関係は1対1です。1つの仮想回線には1つのVLANしか接続できず、1つのVLANには1つの仮想回線しか接続できません。同じVLANを2つ以上の仮想回線に接続することはできません。結果として、プライマリ・ポートとセカンダリ・ポートで高可用性を設計する場合、それぞれにVLANが必要になり、インターブラン・ルーティングやその他のレイヤ3アプリケーションの認識が必要になります。

• ファブリック仮想接続はルーティングにVirtual Routing and Forwardingを使用できます。詳細はVRF for Interconnectionsのページを参照してください。

• 仮想ファブリックポートの最大帯域幅は10Gbpsです。

• 仮想ファブリックポートは、最大9000バイトの最大伝送単位（MTU）とジャンボイーサネットフレームをサポートします。

起点と終点

Origin	Destination	Supported
メタル課金ファブリック VC｜ファブリック上の任意の物理ポート（サービスプロファイル上ではない）。	メタル請求型ファブリックVC｜物理ファブリックポート上の任意のレイヤー2 サービスプロファイル（通常はクラウドサービスプロバイダー）｜はい メタル請求型ファブリックVC｜仮想デバイス（Network Edge）または仮想デバイス上のサービスプロファイル｜いいえ メタル請求型ファブリックVC｜Equinixメタルが接続先のクラウドサービスプロバイダー｜いいえ

帯域幅と価格

Metal課金Fabric仮想接続の利用料金は、Equinix Metalによって計測・請求され、毎月の請求書に記載されます。利用料金はすべて時間単位で、接続に選択した最大速度によって料金が決まります。最大速度のオプションは次のとおりです：

• 50 Mbps
• 200Mbps
• 500 Mbps
• 1Gbps
• 2Gbps
• 5 Gbps
• 10Gbps

注： 接続先のサービスプロバイダーが追加の接続速度オプションを用意している可能性があるため、最大速度を選択しています。Fabricポータルでは、エクイニクスメタルを通じて注文した最大速度までの速度を選択できます。

メタル課金ファブリック仮想接続のリクエスト

Console

ファブリック仮想接続をリクエストするには、プロジェクトの_Interconnections_ページを開きます。+ Request New Interconnection をクリックします。

相互接続タイプ］セクションで、［ファブリックVC］の下のドロップダウンをクリックし、［メタル課金］を選択します。

• ドロップダウンから新しい接続の場所を選択します。Equinix Metalインフラストラクチャが存在するメトロと、Fabricで接続するCSPが存在するメトロの両方を選択します。
• 接続に名前をつける。
• 冗長ポートが必要かどうかを選択します。冗長ポートを強くお勧めします。単一のポートを選択すると、計画的または非計画的な停止により、ダウンタイムが大きくなる可能性があります。
• 接続速度をドロップダウンから選択して設定します。注意：サービス・トークンの発行後は速度を変更できません。速度を変更するには、新しいリクエストとサービス・トークンが必要です。

次に、ポートを VLAN に接続するか、VRF に接続するかを選択します。

• VLANのみを使用する場合は、ポートに接続するVLANを選択します。VLANはFabric VCと同じプロジェクト、同じ場所にある必要があります。対象となるVLANがない場合は、+ Create a VLAN 。同じVLANを2つ以上の仮想回線に接続することはできませんので、冗長ポートを要求する場合は、それぞれにVLANを選択してください。注意: ファブリック VC を作成した後は、VLAN の更新や変更はできません。

• VRF を使用している場合は、ポートの VRF を選択します。VRF for Interconnections](vrf-interconnections.mdx#requesting-a-fabric-vc-with-vrf)のページに詳しい説明があります。

リクエストの概要を確認します。リクエストの送信 をクリックして、a-side サービス・トークンを受け取ります。

トークンの有効期限は7日間です。トークンと有効期限に関する情報が記載された電子メールも送信されます。Interconnections_ページで、新しくリクエストされたFabric仮想接続は_Pending Requests_タブに表示されます。

CLI

CLI で Metal-billed Fabric VC を要求するには、metal interconnections create コマンドを使用します。

metal interconnections create -p <project_id> -n <name> -m <metro> -r redundant -t shared -T z_side [--vlans <vlan_id>, <vlan_id> | --vrfs <vrf_uuid>, <vrf_uuid>]

オプション

• -p, --project-id (required) - Your Project's UUID.
• -r, --redundancy - Select primary or redundant. If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• -T, --service-token-type (required) - This parameter is required when requesting a Metal-billed Fabric Virtual Connection. Set the value to a_side.
• -t, --type (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to "shared".
• --vlan" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The vlan option is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• --vrfs - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The vrfs option is required if you are using VRFs. If you are using VLANs, this field is NOT required.

注："vlans"フィールドまたは"vrfs"フィールドのいずれかを使用してください。これらは相互に排他的であり、少なくともどちらか一方が必要です。

リクエストを送信すると、Zサイド・サービス・トークンが生成されます。トークンはレスポンス・オブジェクトに含まれます。冗長接続をリクエストした場合、2つのトークンを受け取ります。

API

API を介して接続を要求するには、/projects/{project_id}/connections エンドポイントに POST リクエストを送信します。このファブリック VC に VLAN をアタッチする場合は、リクエスト本文で "vlans" パラメータを使用します。VRF を使用している場合は、リクエスト・ボディに "vrfs" パラメータを使用します。

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{project_id}/connections" \
-d '{
    "name": "<string>",
    "description": "<string>",
    "contact_email": "<string>",
    "metro": "<metro_slug>",
    "type": "shared",
    "service_token_type": "a_side",
    "redundancy": "<redundant>",
    "speed": "<string>",
    "vlans": [ <integer>, <integer> ]  
}'

ボディ・パラメーター

• "name" (required) - The name of your new Fabric Virtual Connection.
• "description" (optional) - A user-friendly description for your Fabric Virtual Connection.
• "contact_email" - The preferred email used for communication and notifications about the Interconnection. Required when using a Project API key. Optional and defaults to your user email address when using a User API key.
• "metro" (required) - Select the metro where both your Equinix Metal infrastructure and the CSP destination on Fabric is: these interconnections are metro-bound.
• "type" (required) - This parameter is required when requesting a Metal-billed Fabric Virtual Connection. Set the value to "shared".
• "service_token_type" (required) - This parameter is required when requesting a Metal-billed Fabric Virtual Connection. Set the value to a_side.
• "redundancy" (required) - Select "primary" or "redundant". If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• "vlans" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The "vlans" field is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• "vrfs" - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The "vrfs" field is required if you are using VRFs. If you are using VLANs, this field is NOT required.

注："vlans"フィールドまたは"vrfs"フィールドのいずれかを使用してください。これらは相互に排他的であり、少なくともどちらか一方が必要です。

リクエストを送信すると、Equinix Fabric上にFabric VCが作成され、Fabricトークンが生成されます。トークンはレスポンスの"service_tokens"オブジェクトに含まれます。冗長接続をリクエストした場合は、2つのトークンが送信されます。

"service_tokens": [ 
    {
    “id”: "ff0cf4dc-a897-426d-9621-13e5b975058c",
    “role”: "primary",
    “state”: "inactive",
        “max_allowed_speed”: 50000000,
    “service_token_type”: "a_side",
    “expires_at”: "2019-09-30T20:22:20",
    }
],

トークンの有効期限は7日間です。また、お客様のサービス・トークンと有効期限情報が記載された電子メールが送信されます。このウィンドウの間に、/connections/{connection_id} エンドポイントに GET リクエストを送信することで、リクエストの確認とトークンの取得ができます。

curl -X GET -H 'X-Auth-Token: $API_TOKEN' \
"https://api.equinix.com/metal/v1/connections/{connection_id}"

Aサイド・サービス・トークンの交換

トークンを利用するには、Equinix Fabricポータルにログインし、_Connections_ドロップダウンメニューから_Create a Connection_をクリックしてください。

AWSやAzureなどのクラウドサービスプロバイダー、またはお客様が所有するFabricポートを接続先として選択します。接続先としてエクイニクスメタルはサポートされていません。

クラウドサービスプロバイダに接続する場合は、_A Service Provider_を選択し、お探しのプロバイダを選択してください。

または

自分のFabricポートに接続する場合は、_My Own Assets_と_Connect My Assets as E-line_を選択します。

接続先を選択したら、サービストークンを使用してEquinix Connectを接続元として設定します。Service Token_」を選択し、フィールドにトークンを入力します。トークンを入力すると、接続元のポート情報が自動的に入力されます。

クラウド・サービス・プロバイダーに接続している場合は、両方のトークンを一度に利用できる冗長オプションを提供している場合があります。

そうでなければ、トークンごとにこのプロセスを繰り返さなければならない。

または

自分のFabricポートに接続している場合、接続元のポート情報も自動的にフィルタリングされ、接続先のFabricポートを選択するためのオプションが表示されます。

接続先オプションは、Equinix Metalでリクエストしたメトロにフィルタリングされます。接続するメトロを選択し、「次へ」 をクリックしてください。

接続の仮想回線にフレンドリーな名前を付け、AWSアカウントIDなど、接続先のサービスプロバイダーが必要とする情報を入力します。エクイニクスで設定した上限値までの接続速度を設定します。

Next をクリックして選択内容を確認し、注文の準備ができたら、Submit Order をクリックします。

注：注文送信後、Equinix MetalおよびFabricからの接続を承認するために、接続先のサービスプロバイダーを管理するアカウントにログインする必要がある場合があります。

a-sideサービストークンを引き換え、Fabricで接続を設定すると、Equinix Metalのバックグラウンドジョブが開始され、設定とアクティベーションが完了します。通常15分以内で完了します。

冗長接続用に 2 つのトークンを受け取った場合、CSP への接続時に両方のトークンを引き換えることができなかった場合は、必ず 2 つ目のトークンを引き換えるプロセスを繰り返してください。

トークンを取得する必要がある場合は、Interconnection Request タブで取得できます。トークンが必要な相互接続の Manage をクリックします。

Fabric上でサービス・トークンを引き換え、アクティベーションが完了すると、時間単位の課金が開始されます。

ファブリック仮想接続の管理

Console

FabricとEquinix Metal間で相互接続が確立されると、プロジェクトの「相互接続」ページの「Fabric VC」セクションに「アクティブ」というステータスで表示されます。課金は、ファブリック仮想接続のステータスが「アクティブ」になった時点で開始されます。

• ファブリック課金 ファブリック仮想接続には、Fabric Billed というタイプがあります。
• メタル課金ファブリック 仮想接続のタイプは_Metal Billed_です。
• 共有ポート_として設定された相互接続は、タイプ_Legacy_で表示されます。

Dedicated Portsは組織レベルで管理されるため、組織内にDedicated Portsがある場合は、_Dedicated Ports_セクションにも表示されます。

インターコネクションの名前をクリックすると、プライマリポートとセカンダリポートの設定の概要と詳細が表示される_Overview_ ページが表示されます。

プライマリ・ポート］または［セカンダリ・ポート］をクリックすると、ポートのステータスと設定が表示されます。

CLI

metal interconnections getコマンドを使用して、メタル請求されたファブリック仮想接続を含むプロジェクトのすべての相互接続をリストします。-p または --project_id でプロジェクトを指定します。

metal interconnections get -p <project_id>

注：専用ポートは組織レベルで管理され、組織内のプロジェクト全体で共有されます。組織内に専用ポートがある場合は、そのポートも回答に表示されます。

UUIDと-iまたは--connIDでファブリック仮想接続を指定し、metal interconnections getコマンドで特定のファブリック仮想接続の詳細を取得します。

metal interconnections get -i <fabric_vc_uuid>

ファブリック仮想接続を更新するには、metal interconnections update コマンドを使用します。ファブリック仮想接続の UUID は必須です。他のフィールドはすべてオプションなので、個別に更新できます。

metal interconnections update -i <fabric_vc_uuid> -n <name> -d <description> -r <redundant|primary> -e <e-mail> --tags="<tag1>,<tag2>"

オプション

• -i, --id (required) - The UUID of the interconnection.
• -e, --contactEmail - Adds or updates the email contact for the Fabric Virtual Connection.
• -n, --name - Updates the name.
• -d, --description - Adds or updates the description.
• -r, --redundancy - Updating to primary will remove a secondary port, while updating to redundant will add a secondary port.
• -t, --tags - Adds or updates the tags.

API

プロジェクト内のすべての相互接続を一覧表示するには、/organizations/{organization_id}/connections エンドポイントに GET リクエストを送信し、リクエストのパスでプロジェクトへの応答をフィルタリングします。

注：専用ポートは組織レベルで管理され、組織内のプロジェクト全体で共有されます。組織内に専用ポートがある場合は、そのポートも回答に表示されます。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/organizations/{organization_id}/connections?project={project_id}

Metal-billed Fabric VC の詳細を取得するには、/connections/{connection_id} エンドポイントに GET リクエストを送信し、リクエストパスに UUID を指定します。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}

この情報を使用して、/connections/{connection_id} エンドポイントに PUT リクエストを送信して、Fabric Billed Fabric VC を管理および更新できます。リクエストの本文に変更したい内容を指定します。すべてのフィールドは独立して更新できるようにオプションです。

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/connections/{connection_id}" \
-d '{
    "contact_email": "<string>",
    "description": "<string>",
    "name": "<string>",
    "redundancy": "<string>",
    "tags": [
        "<string>"
    ]
}'

ボディ・パラメーター

• "contact_email" - Adds or updates the email contact for the Fabric Virtual Connection.
• "name" - Updates the name.
• "description" - Adds or updates the description.
• "redundancy" - Updating to "primary" will remove a secondary port, while updating to "redundant" will add a secondary port.
• "tags" - タグを追加または更新する。

また、相互接続のポート情報を取得することもできます。

Metal Billed Fabric VC のポート一覧を取得するには、/connections/{connection_id}/ports エンドポイントに GET リクエストを送信します。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports

ポートの詳細を取得するには、/connections/{connection_id}/ports/{id} エンドポイントに GET リクエストを送信します。

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports/{id}

仮想回路

プライマリおよびセカンダリの各ポートには、VLANまたはVRFをアタッチできる単一の仮想回路があります。

VLANを使用している場合、バーチャルサーキットは指定したVLANにアタッチされます。これらは変更できません。異なるVLANを持つファブリックVCが必要な場合は、ファブリックVCを解体して再作成する必要があります。

注：コンソールまたはAPIを使用して仮想サーキットのVLANを追加、削除、または変更したことがある場合、2024年2月29日 以降、これらのオプションは使用できません。/virtual-circuits/{id}エンドポイントへのアップデート(PUT)リクエストは、レスポンスにサンセットヘッダを持ちます。ただし、2024年3月1日 より前にプロビジョニングされた Waiting on customer VLAN のファブリック VC については例外があります。

VRF を使用している場合、仮想サーキットのステータスは Waiting on Peering Details になります。

VRFの設定

Console

仮想サーキットで VRF を使用している場合は、3 つのバーメニューをクリックして Manage Peering Details ペインを開きます。要求された情報をフィールドに入力します。

VRF の IP アドレス範囲から VRF および仮想回線リモート側のアドレスとなるサブネットを指定します。このサブネットの IP アドレス予約は自動的に作成されます。

より詳細なドキュメントは、VRF for Interconnections ページを参照してください。

仮想サーキットの更新 をクリックします。

冗長ポートがある場合は、セカンダリーポートでこのプロセスを繰り返します。

API

VRF のピアリング詳細を使用して仮想サーキットを更新するには、次の手順に従います。/virtual-circuits/{vrf_virtual_circuit_id} エンドポイントに PUT リクエストを送信します。

VRF の IP アドレス範囲から VRF および仮想回線リモート側のアドレスとなるサブネットを指定します。このサブネットの IP アドレス予約は自動的に作成されます。

IPv4サブネットの場合：

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
    "peer_asn": <integer>,
    "subnet": "<subnet>",
    "metal_ip": "<ip_address>",
    "customer_ip": "<ip_address>”,
    "md5": "<string>"
}'

IPv6サブネットの場合：

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
    "peer_asn": <integer>,
    "subnet_ipv6": "<subnet>",
    "metal_ipv6": "<ip_address>",
    "customer_ipv6": "<ip_address>”,
    "md5": "<string>"
}'

より詳細なドキュメントは、VRF for Interconnections ページを参照してください。

ファブリック仮想接続の削除

警告

Fabric仮想接続の削除は永続的です。接続を削除すると、接続されていたVLANはすべて切り離され、Fabricからサーバーへのトラフィックは遮断されます。

Equinix Metal側からMetal課金仮想接続を削除すると、Fabric上の接続も自動的に削除されます。Fabricポータルから削除すると、Equinix Metal側でも自動的にクリーンアップされます。これは非同期処理で、完了までに最大3分かかります。

削除前に必ずトラフィックを停止し、接続先のクラウドサービスプロバイダから接続に関連付けられたリソースをクリーンアップしてください。MetalまたはFabricポータルから接続を削除する前にこの作業を行うことで、接続が完全に削除され、課金も停止されます。

Console

Interconnections_］ページの接続リストから、削除するファブリック仮想接続の名前をクリックします。

ファブリック仮想接続を完全に削除するには、Delete Interconnection をクリックします。

CLI

ファブリック仮想接続を削除するには、metal interconnections delete コマンドを使用します。ファブリック仮想接続の UUID を -i または --id で指定します。確認ステップをスキップするには、-f または --force を使用します。

metal interconnections delete -i <uuid> -f

API

API から Fabric Virtual Connection を削除するには、/connections/{connection_id} エンドポイントに DELETE リクエストを送信し、パスにポートの ID を指定します。

curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{id}

リクエストを送信すると、接続は永久に削除されます。Metal Billed接続が削除されると、使用/課金が停止されます。