Skip to content
Megaport Documentation
Moving a VXC and IX

Moving a VXC and IX with the API

This topic describes how to move a VXC and IX service.

Once you have created and deployed a VXC or IX on the Megaport network, you can move the A-End (VXC and IX) or B-End (VXC only), effectively moving the service. This is a useful function for reducing interruptions during maintenance and other tasks that would otherwise cause downtime. For more information, see Moving VXCs and Moving IXs.

You can move a VXC or IX by changing the productUid of the A-End or B-End, depending on the service. You can use the optional aEndProductUid or bEndProductUid parameters in the Body of the request:

{
  "aEndProductUid": "0ee41f61-4f03-5555-8afe-77fcc949c804"
}

Before you begin, obtain a valid access token. For more information, see Creating an API Key.

To move a VXC in the Postman collection

  1. In Postman, expand Connections > Virtual Cross Connects in the left navigation and click PUT Update VXC (v3).

  2. Identify the VXC to update by adding the productUid to the endpoint.
    Update VXC request

  3. Click the Body tab and add the aEndProductUID with the UID of the new A-End.
    You can update the A-End or B-End of a VXC, but you can only move one end per API call.

    Move VXC request

  4. Click Send.
    The changes will be reflected in the Portal within two minutes. The Services page shows the VXC moved to the new A-End or B-End, depending on the specification.

To move an IX in the Postman collection

  1. In Postman, expand Internet Exchange (IX) in the left navigation and click PUT Update IX.

  2. Identify the IX to update by adding the productUid to the endpoint.
    Update IX request

  3. Click the Body tab and add the aEndProductUID.
    Move IX request

  4. Click Send.
    The changes will be reflected in the Portal within two minutes. The Services page shows the IX moved to the new A-End.

Last update: 2024-04-15