サービストークンを使用したNetwork Edgeデバイスの接続
サービストークンを使用したファブリックAPIを使用して、Network Edgeデバイスとファブリック上のネットワークリソース間の接続を確立する。
Fabric API の前提条件
-
認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「API認証」を参照。
-
仮想デバイスの取得または仮想デバイスの取得{uuid}を使用してNetwork Edgeデバイス情報を取得する。冗長デバイスの場合は、プライマリデバイスまたはセカンダリデバイスの一意のIDを選択する。同様に、クラスタデバイスの場合は、またはの一意のIDを選択する。
node0``node1デバイスが冗長/クラスタであっても、1つの接続しかない。 -
Get All Service Tokensエンドポイントを呼び出して、使用可能なサービストークンと許可された接続設定を取得する。
サービス・トークンを使った接続
サービストークンを使用して、Network Edge仮想デバイスとファブリック上の別のネットワークロケーション間の接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信する。POSTリクエストの本文に含まれる仮想デバイス、サービストークン、および接続構成を指定する。ネットワークロケーションの詳細は、サービストークンによって提供される。
サービストークンは、複数の受信者に送信することができ、どの受信者も1回だけ使用することができます。
| POST /ファブリック/v4 /接続 | |
|---|---|
| 方法 | POST |
| エンドポイント | /fabric/v4/connections |
| ヘッダー | Authorization、Content-Type |
| パスパラメータ | 該当なし |
| クエリーパラメータ | 該当なし |
| ボディパラメータ | type、name、order、、、redundancy、bandwidth``aSide、zSide、notifications |
この例では、a サイドは Network Edge デバイスであり、サービストークンは z サイドの宛先用です。
サンプルcURLリクエスト：
curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
"type": "EVPL_VC",
"name": "Conn-1",
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"bandwidth": 1000,
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "fd5342f3-d067-4683-a24f-be952279630b"
},
"interface": {
"type": "NETWORK",
"id": 5
}
}
},
"zSide": {
"serviceToken": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@equinix.com"
]
}
]
}'
リクエストボディに含まれるパラメータは、この例に固有のものである。パラメータの完全なリストとその説明については、『APIリファレンス』を参照。
回答例
{
"type": "EVPL_VC",
"href": "https://api.equinix.com/fabric/v4/connections/ebc37e2e-c36b-4e93-86a4-fc4efce7abc8",
"uuid": "ebc37e2e-c36b-4e93-86a4-fc4efce7abc8",
"name": "Test ST",
"state": "ACTIVE",
"operation": {
"providerStatus": "AVAILABLE",
"equinixStatus": "PROVISIONED"
},
"notifications": [
{
"type": "ALL",
"emails": [
"testNEuser2@equinix.com"
]
}
],
"account": {
"accountNumber": 270235,
"orgId": 92794,
"globalOrgId": "0016u000003JZ55AAG"
},
"changeLog": {
"createdBy": "testNEuser2",
"createdDateTime": "2022-10-05T19:37:12.748Z",
"updatedBy": "testNEuser2",
"updatedDateTime": "2022-10-05T19:37:12.748Z"
},
"bandwidth": 50,
"redundancy": {
"group": "b64dad2a-2763-4084-bc50-b36ef4f67137",
"priority": "PRIMARY"
},
"isRemote": true,
"direction": "INTERNAL",
"aSide": {
"accessPoint": {
"interface": {
"uuid": "11fd6067-149f-4142-a5b4-54a8dd6f53fe",
"id": 6,
"type": "CLOUD"
},
"type": "VD",
"account": {
"accountNumber": 270217,
"organizationName": "eqx-nfv"
},
"location": {
"region": "AMER",
"metroName": "Ashburn",
"metroCode": "DC"
},
"virtualDevice": {
"href": "https://api.equinix.com/ne/v1/devices/3539f96c-7f67-4696-90f3-7b6d2fdcde5f",
"uuid": "3539f96c-7f67-4696-90f3-7b6d2fdcde5f",
"name": "testing1234",
"type": "EDGE"
}
}
},
"zSide": {
"serviceToken": {
"uuid": "e05f4f23-d098-4d7c-a9ca-c2897b465107",
"account": {
"orgId": 92794
}
},
"accessPoint": {
"type": "COLO",
"account": {
"accountNumber": 270235,
"organizationName": "testNEuser2-270235"
},
"location": {
"region": "AMER",
"metroName": "Ashburn",
"metroCode": "DC"
},
"port": {
"href": "https://qa3api.corp.equinix.com/fabric/v4/ports/c791f8cb-59d0-9d00-8ce0-306a5c00a4ee",
"uuid": "c791f8cb-59d0-9d00-8ce0-306a5c00a4ee",
"name": "testNEuser2-DC6-NL-Dot1q-STD-SEC-10G-JN-216"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 553
}
}
}
}
レスポンスペイロードには、リクエスト本文で定義された設定パラメータが含まれる。使用可能なパラメータの完全なリストとその説明については、『APIリファレンス』を参照。
接続の監視
Get Specified Connection APIエンドポイントを使用して、接続ステータスを監視する。