Skip to content

Shutting Down a VXC and IX with the API

This topic describes how to shut down and re-enable a VXC and IX service.

Once you have created and deployed a VXC or IX on the Megaport network, you can temporarily shut down the service for failover testing, redundancy, or network design testing purposes. For more details, see Shutting Down a VXC for Failover Testing.

You can shut down a VXC/IX by setting the optional shutdown parameter to true in the Body of the request:

{
  "shutdown": true
}

To re-enable the VXC/IX, set the shutdown parameter to false:

{
  "shutdown": false
}

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

To shut down 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 update the shutdown parameter to true.
    Shutdown VXC request

  4. Click Send.
    The changes will be reflected in the Portal within two minutes. The Services page shows the gear icon next to the VXC in blue when the service has been shut down, and the text (Shut Down) is displayed next to the service ID.
    VXC Connection Shut Down in the Services Page

To shut down 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 update the shutdown parameter to true.
    Shutdown IX request

  4. Click Send.
    The changes will be reflected in the Portal within two minutes. The Services page shows the gear icon next to the IX in blue when the service has been shut down, and the text (Shut Down) is displayed next to the service ID.
    IX Connection Shut Down in the Services Page


Last update: 2023-12-20