action.skip

Changing an IX Configuration with the API

This topic describes how to change configuration details of an existing IX. For more information, see PUT Update IX in the API reference.

You can change the IX service name, rate limit, cost centre, VLAN ID, MAC address, ASN, BGP password, whether your IX traffic graphs are public or private, reverse DNS, A-End productUid (for moving an IX), and whether to shut down or re-enable an IX, by updating any of these parameters in the Body of the request:

{
  "name": "My updated API created IX",
  "rateLimit": 500,
  "costCentre": "My Port Account",
  "vlan": 1650,
  "macAddress": "01:02:0f:04:58:20", 
  "asn": 136999,
  "password": "gbixpassword",
  "publicGraph": false,
  "reverseDns": "as6533.charlotte.com",
  "aEndProductUid": "9e8ad9d7-85ab-46f9-ab13-c0966891341b",
  "shutdown": true
}

For details on moving an IX, see Moving a VXC and IX with the API.

For details on shutting down an IX, see Shutting Down a VXC and IX with the API.

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

To change the IX details 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. Select the Body tab and update IX details for name, rate limit, VLAN ID, BGP password, and so on. You only need to include the values you want to change.
    This example changes the following values.
    Update IX request

  4. Click Send.
    The changes will be reflected in the Portal within two minutes.
    Updated IX details