Network Edgeデバイスをリモートポートに接続
Fabric APIを使用して、Network Edge仮想デバイスとリモートのFabricポートの間でタグなし接続を確立します。
Fabric API の前提条件
-
認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証を使用します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API認証を参照してください。
-
Aサイド情報の確認Get Virtual Devices または [Get Virtual Device {uuid} を使用して、Network Edge デバイス情報を取得します。接続には、デバイス上で利用可能な任意のインターフェースを選択できます。ただし、指定がない場合はエクイニクスがインターフェースを選択します。
-
Get All Ports APIリクエストを使用して、Equinix Fabricのポート情報を取得します。
タグなしリモートポートへの接続
Network Edgeデバイスからリモートポートへのタグなしトラフィックによる接続を作成するには、/fabric/v4/connectionsエンドポイントにPOSTリクエストを送信します。リクエストの本文に、接続の設定の詳細を指定します。
メモ
Network Edge 仮想デバイスからリモートポートには、タグ付けされていない接続を 1 つだけ作成できます。
| POST /fabric/v4/connections | |
|---|---|
| Method | POST |
| Endpoint | /fabric/v4/connections |
| Headers | Authorization, Content-Type |
| Path Parameters | Not applicable |
| Query Parameters | Not applicable |
| Body Parameters | type, name, order, bandwidth, aSide, zSide, project, notifications |
サンプルcURLリクエスト：
curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
"type": "EVPL_VC",
"bandwidth": 100,
"redundancy": {
"priority": "PRIMARY"
},
"name": "ConnectionName-1",
"order": {
"purchaseOrderNumber": "1-3232923"
},
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "fd5342f3-d067-4683-a24f-be952279630b"
},
"interface": {
"type": "NETWORK",
"id": 45645
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"linkProtocol": {
"type": "UNTAGGED"
}
}
},
"project": {
"projectId": 567
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test1@equinix.com"
]
}
]
}'
リクエストボディに含まれるパラメータは、この例に特有のものです。パラメーターの全リストとその説明については、APIリファレンスを参照してください。
DOT1Qリモートポートへの接続
Network EdgeデバイスからDOT1Qリモートポートへの接続を作成するには、/fabric/v4/connectionsエンドポイントにPOSTリクエストを送信します。リクエストの本文に、接続の設定の詳細を指定します。
サンプルcURLリクエスト：
curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '
{
"type": "EVPL_VC",
"bandwidth": 1000,
"name": "vd to COLO",
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"interface": {
"type": "NETWORK",
"id": 45645
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 300
}
}
},
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test1@equinix.com"
]
}
]
}'
回答例
{
"type": "EVPL_VC",
"href": "https://api.equinix.com/fabric/v4/connections/c193c1c4-2c7e-472d-8c91-0283bc3b5a71",
"uuid": "c193c1c4-2c7e-472d-8c91-0283bc3b5a71",
"name": "ConnectionName-1",
"state": "PROVISIONING",
"operation": {
"providerStatus": "NOT_AVAILABLE",
"equinixStatus": "PROVISIONING"
},
"order": {
"purchaseOrderNumber": "1-3232923"
},
"project": {
"projectId": 567
},
"notifications": [
{
"type": "ALL",
"emails": [
"testqq@equinix.com"
]
}
],
"account": {
"accountNumber": 270217,
"orgId": 92287,
"globalOrgId": "0016u000003JZ53AAG"
},
"changeLog": {
"createdBy": "eqxnfvuser",
"createdDateTime": "2022-03-22T23:14:23.546Z"
},
"bandwidth": 100,
"redundancy": {
"group": "79a0e626-55fe-4fe1-89a5-4d7ca52214db",
"priority": "PRIMARY"
},
"isRemote": true,
"direction": "INTERNAL",
"aSide": {
"accessPoint": {
"interface": {
"uuid": "bf8a606b-32b2-4a53-a450-6eabd7d9ccab",
"id": 45645,
"type": "CLOUD"
},
"type": "VD",
"account": {
"accountNumber": 270217,
"orgId": 92287,
"organizationName": "eqx-nfv",
"globalOrgId": "0016u000003JZ53AAG"
},
"location": {
"href": "https://api.equinix.com/fabric/v4/metros/DC",
"region": "AMER",
"metroName": "Ashburn",
"metroCode": "DC"
},
"virtualDevice": {
"href": "https://api.equinix.com/ne/v1/devices/fd5342f3-d067-4683-a24f-be952279630b",
"uuid": "fd5342f3-d067-4683-a24f-be952279630b",
"name": "ha-json",
"type": "EDGE"
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"account": {
"accountNumber": 270224,
"orgId": 92287,
"organizationName": "eqx-nfv",
"globalOrgId": "0016u000003JZ53AAG"
},
"location": {
"href": "https://api.equinix.com/fabric/v4/metros/SY",
"region": "APAC",
"metroName": "Sydney",
"metroCode": "SY"
},
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/c791f8cb-5d73-d730-8ce0-306a5c00a4ee",
"uuid": "c791f8cb-5d73-d730-8ce0-306a5c00a4ee",
"name": "eqx-nfv-SY1-L-Dot1q-BO-PRI-10G-JN-1147"
},
"linkProtocol": {
"type": "DOT1Q"
}
}
},
"additionalInfo": []
}
レスポンスペイロードには、リクエストボディで定義された設定パラメータが含まれます。使用可能なパラメータの一覧とその説明については、API リファレンス を参照してください。
QinQリモートポートへの接続
Network EdgeデバイスからQinQリモートポートへの接続を作成するには、/fabric/v4/connectionsエンドポイントにPOSTリクエストを送信します。リクエストの本文に、接続の設定の詳細を指定します。
サンプルcURLリクエスト：
curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '
{
"type": "EVPL_VC",
"bandwidth": 1000,
"name": "vd to COLO",
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"interface": {
"type": "NETWORK",
"id": 45645
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"linkProtocol": {
"type": "QINQ",
"vlanSTag": 300,
"vlanCTag": 400
}
}
},
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test1@equinix.com"
]
}
]
}
'
接続の監視
接続ステータスを監視するには、Get Specified Connection API エンドポイントを使用します。