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

Fabric課金Fabric仮想接続は、お客様のFabricポートまたはNetwork EdgeデバイスからEquinix Metalへの接続に使用します。使用例としては、Network Edgeデバイスをエクイニクスメタルサービスのルーターとして使用する場合や、エクイニクスメタルとクラウドサービスプロバイダーをメトロ間で接続する場合などがあります。利用料金、Network Edge利用料金、仮想デバイス利用料金はすべて、お客様のエクイニクスFabricアカウントに表示されます。

注：この機能は、Equinix FabricおよびNetwork EdgeデバイスとEquinix Metalインフラストラクチャを以前からご利用いただいているお客様の「共有ポート」に代わるものです。既存の共有ポート相互接続は引き続き機能し、ポータルとAPIでは_Legacy_と表示されます。

システム情報

• 各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｜はい クラスター化仮想デバイス（Network Edge HA ペア）｜ファブリック課金ファブリック VC｜いいえ ファブリック課金ファブリック VC｜いいえ

ファブリック課金によるファブリック仮想接続の要求

Console

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

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

• ドロップダウンから新しい接続先を選択します。エクイニクスメタルサーバーとVLANが存在する、またはプロビジョニングを予定しているメトロを選択します。
• 接続に名前をつける。
• 冗長ポートが必要かどうかを選択します。プライマリ・ポートとセカンダリ・ポートにそれぞれ仮想サーキットを設け、2つのVLANを接続することで、ある程度の冗長性と高可用性を確保できます。
• 最大相互接続速度］は、デフォルトの最大10 Gbpsに設定されています。実際の接続速度は、Fabricポータルでサービス・トークンを引き換える際に選択します。

次に、ポートを 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)のページに詳しい説明があります。

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

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

CLI

CLI でファブリック課金されたファブリック 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 Fabric-billed Fabric Virtual Connection. Set the value to z_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": "z_side",
    "redundancy": "redundant",
    "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) - The metro where the Fabric Virtual Connection lives.
• "type" (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to "shared".
• "service_token_type" (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to z_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"フィールドのいずれかを使用してください。これらは相互に排他的であり、少なくともどちらか一方が必要です。

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

"service_tokens": [ 
    {
    “id”: "ff0cf4dc-a897-426d-9621-14e5b985058f",
    “role”: "primary",
    “state”: "inactive",
        “max_allowed_speed”: 10000000000,
    “service_token_type”: "z_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}"

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

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

Frequent Connections_の下にある_Connect using a Service Token_タイルを選択し、Enter a Service Token をクリックします。

ダイアログボックスの_Enter Service Token_フィールドにトークンを貼り付け、Validate をクリックします。

トークンの詳細が正しいことを確認し、Redeem をクリックしてトークンを引き換え、Fabric への接続設定を完了します。

レガシー接続 - Equinix Metalで_Shared Ports_を利用したことがある場合、_Fabric Token_フィールドを使用してトークンを引き換え、接続を設定している可能性があります。既存のレガシー接続がある場合は、期待どおりに機能します。未交換のレガシートークンをお持ちの場合、Equinix Fabricでトークンを交換することはできません。新しいサービストークンをリクエストし、新しい手順でFabric上でトークンを交換してください。

Originの設定

これでFabricポータルで接続の設定を続けることができます。設定済みのサービストークンを引き換えたため、接続先は自動的にEquinix Metalに設定され、接続元はお客様が選択することになります。

まず、接続元の場所を選択します。これは多くの場合仮想デバイスですが、お客様のエクイニクスFabricポートでもかまいません。仮想デバイスまたはポートはどのメトロでもかまいません。

仮想デバイスを使用する場合は、デバイスタイプと接続タイプを選択します。現在、_Redundant Devices_と_Clusters_はサポートされていません。

接続の詳細]ページで、仮想接続にフレンドリーな名前を付け、仮想デバイス上のどのインターフェイスと接続するかを指定し（必要な場合）、請求のために必要な場合は発注番号を指定します。サイドVLANはサービストークンによって自動的に割り当てられるため、Equinix Metal上のVLAN IDと一致させる必要はありません。

次に、接続速度を設定します。Equinix Metalでは、Fabric Virtual Connections - Fabric Billedの最大速度を10 Gbpsに設定しています。Fabricの速度オプションと価格から選択します。

最後のページはレビューで、ここで選択を確認し、戻って変更を加えることができます。注文の準備ができたら、Submit Order をクリックします。これにより、FabricとEquinix Connect間の接続設定プロセスがバックグラウンドで開始され、完了までに最大10分かかります。

冗長接続のために2つのトークンを受け取った場合は、2つ目のトークンを利用するために必ずこのプロセスを繰り返してください。

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

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

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}

Fabric 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" - タグを追加または更新する。

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

ファブリック課金ファブリック 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からサーバーへのトラフィックは遮断されます。

EquinixMetal側からFabric課金仮想接続を削除すると、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}

リクエストを送信すると、接続は永久に削除されます。