メインコンテンツにスキップ

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

前提条件​

  1. 認証-ユーザー認証情報、クライアントID、クライアントシークレットを送信してOauth2認証を行います。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「API認証」を参照してください。

  2. 既存の接続IDを確認します。接続の検索エンドポイントを使用して接続のリストを取得し、別のポートに移行する接続のIDを決定します。

  3. 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",
    }
}
このページは役に立ちましたか?