Adding a new external connection

External connections represent physical (L1) ports in the network fabric that act as uplinks outside of the network fabric. By configuring an external connection for a Logical Network the VLANs/VNIs configured will be terminated on the respective external connection.

To configure an external connection:

1. Log into the Admin UI, click on Fabrics, click on the fabric you wish to configure and click on External Connections
2. Click Add external connection

3. Fill in a name and a label and click Add external connection
4. Click edit on the newly created external connection
5. Go to the Network devices tab
6. Click Add external connection network device

8. Select the network device ID and input the ports that will be used for external connections on that switch and click Add external connection network device

Adding an external connection to an Infrastructure

1. Log into the Consumer UI by clicking on your initials in the top right and selecting Infrastructure designer
2. Click on Add element and select the network you wish to use.

3. If selecting a Private network, fill in the Name, the Label and select the Network profile and click Create

4. Click on the network on the diagram, click on External Connections and click on Attach Connection, select the External Connection and click on Attach Connection

5. The External connection will now show

Once complete, the infrastructure can now be deployed or the External connection can now be deleted.

Managing external connections via the API

External connections have a full REST API with support for managing interfaces and logical network attachments.

Creating an external connection

curl -X POST "https://<your-server>/api/v2/external-connections" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "ext-conn-01",
    "name": "Uplink to WAN router",
    "fabricId": 1,
    "externalConnectionInterfaces": [
      {"networkDeviceInterfaceId": 100}
    ]
  }'

Listing external connections

curl "https://<your-server>/api/v2/external-connections"

Managing interfaces

# List interfaces for an external connection
curl "https://<your-server>/api/v2/external-connections/{externalConnectionId}/interfaces"

# Add an interface
curl -X POST "https://<your-server>/api/v2/external-connections/{externalConnectionId}/interfaces" \
  -H "Content-Type: application/json" \
  -d '{"networkDeviceInterfaceId": 101}'

# Remove an interface
curl -X DELETE "https://<your-server>/api/v2/external-connections/{externalConnectionId}/interfaces/{interfaceId}"

Attaching a logical network

External connections can be linked to logical networks. Each attachment is tracked with its own status (pending_activation, active, etc.):

# Attach a logical network
curl -X POST "https://<your-server>/api/v2/external-connections/{externalConnectionId}/logical-networks" \
  -H "Content-Type: application/json" \
  -d '{"logicalNetworkId": 10}'

# List attached logical networks
curl "https://<your-server>/api/v2/external-connections/{externalConnectionId}/logical-networks"

# Detach a logical network (from the logical network side)
curl -X DELETE "https://<your-server>/api/v2/logical-networks/{logicalNetworkId}/external-connections/{externalConnectionId}"

Viewing external connections for a logical network

curl "https://<your-server>/api/v2/logical-networks/{logicalNetworkId}/external-connections"