異なる仮想デバイスへの接続の移行

前提条件
-
認証-ユーザー認証情報、クライアントID、クライアントシークレットを送信してOauth2認証を行います。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「API認証」を参照してください。
-
既存の接続IDを確認します。接続の検索エンドポイントを使用して接続のリストを取得し、別のポートに移行する接続のIDを決定します。
-
Network Edgeデバイス情報を確認します。登録されたライセンスを持つ、プロビジョニングされたEquinix仮想デバイス/冗長デバイス/クラスタが必要です。Get Virtual DevicesまたはGet Virtual Device {uuid}を呼び出して、利用可能な仮想デバイスとクラスタを確認します。接続には、デバイスで使用可能なインターフェースを選択できます。ただし、指定しない場合、Equinixはインターフェースを選択します。
接続の更新
接続を更新して別の仮想デバイスに移行するには、/fabric/v4/connections/{id}エンドポイントにリクエストを送信します。PATCHリクエストの本文で、接続を移行する仮想デバイスへの接続のAサイドIDを指定します。
| パッチ/ファブリック/v4/connections/{uuid} | |
|---|---|
| 方法 | パッチ |
| URLまたはエンドポイント | /fabric/v4/connections/{uuid} |
| ヘッダー | Authorization、Content-Type |
| パスパラメータ | uuid |
| クエリーパラメータ | 該当なし |
| ボディパラメータ | op、パス、値 |
接続を変更せずに本番環境でこのリクエストを安全に検証するには、「本番環境でのテスト(APIドライラン)」を参照してください。
サンプルcURLリクエスト:
curl -X
PATCH 'https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62'
-H 'content-type: application/json-patch+json'
-H 'authorization: Bearer <token>'
-d '[
{
"op": "replace",
"path": "/aSide/accessPoint",
"value": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "e8b49cd7-9b4c-4123-8bd4-fbead83c3436"
},
"interface": {
"type": "NETWORK",
"id": 5
}
}
}
]'
パスパラメータ
| パラメータ | 必須 | タイプ | 例 | 適用可能な値 | 説明 |
|---|---|---|---|---|---|
| ユイド | はい | 文字列 | 3a58dd05-f46d-4b1d-a154-2e85c396ea62 | - | エクイニクスが割り当てた接続識別子 |
本文パラメータ
| パラメータ | 必須 | タイプ | 例 | 適用可能な値 | 説明 |
|---|---|---|---|---|---|
| オペレーション | はい | 文字列 | 交換 | 交換 | リクエストタイプの更新 |
| パス | はい | 文字列 | /Aside/アクセスポイント | /Aside/アクセスポイント | パラメータパス |
| 金額 | はい | オブジェクト | - | ||
| タイプ | はい | 文字列 | 仮想ディスク(VD) | 仮想ディスク(VD) | VD - 仮想デバイス |
| 仮想デバイス | はい | オブジェクト | - | 仮想デバイスの詳細。 | |
| タイプ | はい | 文字列 | エッジ | エッジ | エッジ。 |
| ユイド | はい | 文字列 | 78rtdd05-f46d-4b1d-a154-2e85c396yt56 | 新しい仮想デバイスの固有 ID。 | |
| インターフェイス | いいえ | オブジェクト | インターフェイスの詳細 | ||
| タイプ | いいえ | 文字列 | ネットワーク | ネットワーク | |
| ID | いいえ | 整数 | 5 | 仮想デバイスのインターフェース。 |
回答例
{
"href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"type": "EVPL_VC",
"uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"name": "Conn-Name-2",
"state": "PROVISIONED",
"order": {
"purchaseOrderNumber": "1-129105284100",
"billingTier": "Up to 1 Gbps"
},
"bandwidth": 1000,
"redundancy": {
"group": "m167f685-41b0-1b07-6de0-320a5c00abeu",
"priority": "PRIMARY"
},
“aSide”: {
“accessPoint”: {
"interface": {
“uuid”: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
“id”: 7,
“type”: "NETWORK"
},
“location”: {
“metroCode”: "AM"
},
“virtualDevice”: {
“uuid”: "XXXXXXXXXXXXXXXXXXXXXXXXXX",
“type”: "EDGE"
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",
"type": "L2_Profile",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"location": {
"href": "https://api.equinix.com/v4/metros/SV",
"metrocode": "SV",
"region": "AMER"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test@equinix.com"
]
}
],
"operation": {
"equinixStatus": "PROVISIONED",
"providerStatus": "PROVISIONED"
},
"changeLog": {
"createdDateTime": "2021-07-15T19:30:29.526Z",
"updatedDateTime": "2021-08-15T19:30:29.526Z",
}
}