Console Connect logo

Ports

Before configuring any network services in Console Connect, you must create a port. This is a two-step process; ordering or requesting a port, then activating that port. Console Connect manages entitlements through plan-based subscriptions associated with each port (one subscription per port). Before you can order a port, your company must have a subscription to a plan with sufficient entitlements available to complete the request. To list your company’s subscriptions and entitlements refer to Get all plans and entitlements.

List ports

Note: Reading a company’s ports is publicly visible.

A port can be in one of the following states:

Status Description
ACTIVATING In the process of being activated
READY Allocated but awaiting a physical network connection
ACTIVE Port is active
DISABLING In the process of being disabled
DISABLED The port is disabled
DELETING In the process of being deleted
DELETED The Port is deleted
UNKNOWN The status of the port cannot be determined
ONBOARDING The port is currently being on-boarded

In addition to these states, a port also has the singleService flag which indicates that the port is dedicated to a single untagged connection, so no further connections can be created on the port.

Securityapi-key
Request
path Parameters
companyName
required
string

The username of the company to check the port for.

Example: Acme
query Parameters
deleted
string

Set to false to exclude ports with DELETED status

Example: deleted=false
Responses
200

OK

get/api/company/{companyName}/ports
Response samples
application/json
{
  • "results": [
    ]
}

Delete port

Note: a port must be disabled using Port Actions before it can be deleted.

Securityapi-key
Request
path Parameters
companyName
required
string

The username of the company to check the port for.

Example: Acme
portId
required
string

The port id

Example: 55767b5652a693344a015744
Responses
200

OK

delete/api/company/{companyName}/ports/{portId}

Read port details

Note: Reading a company's port details is publicly visible.

Securityapi-key
Request
path Parameters
companyName
required
string

The username of the company to check the port for.

Example: Acme
portId
required
string

The port id

Example: 55767b5652a693344a015744
Responses
200

OK

get/api/company/{companyName}/ports/{portId}
Response samples
application/json
{
  • "activeChangedAt": "2016-06-16T06:20:10.640Z",
  • "asn": {
    },
  • "capacity": {
    },
  • "company": {
    },
  • "companyId": "5762451982894b9b1b1a5dbc",
  • "connections": [
    ],
  • "controllers": [
    ],
  • "createdAt": "2016-06-16T06:20:10.029Z",
  • "dataCenterFacility": {
    },
  • "dataCenterFacilityId": "5126c9f1111e15a24a066130",
  • "deleted": false,
  • "deletedAt": "1970-01-01T00:00:00.000Z",
  • "id": "5762451a82894b9b1b1a5dc2",
  • "ip": {
    },
  • "locationId": "b3f5ac21-fec1-4418-9e1a-709d48da59fa",
  • "crossConnectId": "68696464-b2f7-4c90-a342-293f7385469a",
  • "metro": {
    },
  • "metroId": "1232413986c08c061dd8c45f",
  • "name": "Vicente",
  • "networkServiceProviderId": null,
  • "partner": {
    },
  • "portId": null,
  • "singleService": false,
  • "speed": {
    },
  • "status": "ACTIVE",
  • "type": "PHYSICAL",
  • "updatedAt": "2016-06-16T06:20:11.116Z",
  • "vlanRange": [
    ]
}

Update port details

Update a port

Securityapi-key
Request
path Parameters
companyName
required
string

The username of the company to check the port for.

Example: Acme
portId
required
string

The port id.

Example: 55767b5652a693344a015744
Request Body schema: application/json
asn
string

The ASN to attach to this port.

name
required
string

A friendly name for the port

Responses
200

OK

post/api/company/{companyName}/ports/{portId}
Request samples
application/json
{
  • "asn": {
    },
  • "name": "VPort0"
}
Response samples
application/json
{
  • "activeChangedAt": "2016-06-16T06:20:10.640Z",
  • "asn": {
    },
  • "capacity": {
    },
  • "company": {
    },
  • "companyId": "5762451982894b9b1b1a5dbc",
  • "connections": [
    ],
  • "controllers": [
    ],
  • "createdAt": "2016-06-16T06:20:10.029Z",
  • "dataCenterFacility": {
    },
  • "dataCenterFacilityId": "5126c9f1111e15a24a066130",
  • "deleted": false,
  • "deletedAt": "1970-01-01T00:00:00.000Z",
  • "id": "5762451a82894b9b1b1a5dc2",
  • "ip": {
    },
  • "locationId": "b3f5ac21-fec1-4418-9e1a-709d48da59fa",
  • "crossConnectId": "68696464-b2f7-4c90-a342-293f7385469a",
  • "metro": {
    },
  • "metroId": "1232413986c08c061dd8c45f",
  • "name": "Vicente",
  • "networkServiceProviderId": null,
  • "partner": {
    },
  • "portId": null,
  • "singleService": false,
  • "speed": {
    },
  • "status": "ACTIVE",
  • "type": "PHYSICAL",
  • "updatedAt": "2016-06-16T06:20:11.116Z",
  • "vlanRange": [
    ]
}

Read port access circuit details

Securityapi-key
Request
path Parameters
companyName
required
string

The username of the company to check the port for.

Example: Acme
portId
required
string

The port id.

Example: 55767b5652a693344a015744
Responses
200

OK

401

Unauthorized

404

Not Found

get/api/company/{companyName}/ports/{portId}/access-circuit
Response samples
application/json
{
  • "crossConnectConnectorType": "SC",
  • "crossConnectId": "19204",
  • "crossConnectMediaConvertor": true,
  • "crossConnectMediaType": "SMF",
  • "crossConnectProvider": "My cross connect provider",
  • "crossConnectSalesRecordId": "",
  • "id": "12345",
  • "localLoopPartnerLocalLineNo": "L93850",
  • "localLoopRemoteCarrierContactNo": "+61 3 2223 3344",
  • "localLoopRemoteLocalLineNo": "L843840384",
  • "localLoopRemoteLocalLinePartner": "Partner name",
  • "localLoopRemoteRefNo": "#980344933948",
  • "localLoopSpeed": "0",
  • "managedRouterServiceCeWanInterface": "",
  • "managedRouterServiceCeWanIpAddress": "",
  • "managedRouterServiceCpeOrder": "",
  • "managedRouterServiceDialupNo": "",
  • "managedRouterServiceManagementIp": "192.0.2.101",
  • "managedRouterServiceRemark": "",
  • "managedRouterServiceRouterName": "cds-e038kf-jhsnv",
  • "managedRouterServiceRouterOwner": "",
  • "managedRouterServiceRouterProvider": "",
  • "premiumColocationPanelNumber": "",
  • "premiumColocationRackId": "",
  • "premiumColocationSalesRecordId": ""
}

Perform a action on a port

Securityapi-key
Request
path Parameters
companyName
required
string

The username of the company to check the port for.

Example: Acme
portId
required
string

The port id.

Example: 55767b5652a693344a015744
action
required
string

The action to take.

Example: action(sendloa)
Responses
200

OK

post/api/company/{companyName}/ports/{portId}/{action}(active|disable)
Response samples
application/json
{
  • "activeChangedAt": "2016-06-16T06:20:10.640Z",
  • "asn": {
    },
  • "capacity": {
    },
  • "company": {
    },
  • "companyId": "5762451982894b9b1b1a5dbc",
  • "connections": [
    ],
  • "controllers": [
    ],
  • "createdAt": "2016-06-16T06:20:10.029Z",
  • "dataCenterFacility": {
    },
  • "dataCenterFacilityId": "5126c9f1111e15a24a066130",
  • "deleted": false,
  • "deletedAt": "1970-01-01T00:00:00.000Z",
  • "id": "5762451a82894b9b1b1a5dc2",
  • "ip": {
    },
  • "locationId": "b3f5ac21-fec1-4418-9e1a-709d48da59fa",
  • "crossConnectId": "68696464-b2f7-4c90-a342-293f7385469a",
  • "metro": {
    },
  • "metroId": "1232413986c08c061dd8c45f",
  • "name": "Vicente",
  • "networkServiceProviderId": null,
  • "partner": {
    },
  • "portId": null,
  • "singleService": false,
  • "speed": {
    },
  • "status": "ACTIVE",
  • "type": "PHYSICAL",
  • "updatedAt": "2016-06-16T06:20:11.116Z",
  • "vlanRange": [
    ]
}

Get port utilization data

Obtain utilization information about a specific port using a specific time period and preferred resolution.

Utilization is based on connections attached to a port. Incoming connections (connections initiated by someone else that you accepted) are not included in utilization, but outgoing connections (connections you initiated) are included. You may not create an outgoing connection request that exceeds your port utilization.

Securityapi-key
Request
path Parameters
companyName
required
string

The username of the company to check the port for.

Example: Acme
portId
required
string

The port id.

Example: 55767b5652a693344a015744
query Parameters
start
required
string

Unix timestamp for beginning of time window.

Example: start=1459376516
end
required
string

Unix timestamp for end of time window.

Example: end=1459376516
resolution
required
string

Set the resolution of response ('day' | 'hour' | 'minute'). Resolution defaults to minute if not passed. Note: As minute is the smallest resolution, it will not have min/max fields in the response.

Example: resolution=day
Responses
200

OK

get/api/company/{companyName}/ports/{portId}/utilization
Response samples
application/json
{
  • "portId": 120391239323,
  • "results": [
    ],
  • "unit": "Mbps"
}

Get port VLAN info

Return the vlan information around the given port

Securityapi-key
Request
path Parameters
companyName
required
string

The username of the company to check the port for.

Example: Acme
portId
required
string

The port id.

Example: 55767b5652a693344a015744
query Parameters
detailed
string

Retrieve available VLANs? Default: true.

Example: detailed=true
service
string

The service type to retrieve the available VLANs for. Accepted values are ‘connection’ and ‘gia’. Default: ‘connection’.

Example: service=connection
Responses
200

OK

get/api/company/{companyName}/ports/{portId}/vlan{:detailed,:service)
Response samples
application/json
{
  • "id": 120391239323,
  • "available": [
    ],
  • "ranges": [
    ],
  • "unit": "Mbps"
}

Get all ports/regions for DCP

DCP Partner Username
AWS amazon
AZURE azure
GCE google_cloud
TENCENT tencent-cloud
ALICLOUD alibaba_cloud
Securityapi-key
Request
path Parameters
username
required
string

The username of the Direct Connect Partner (DCP) for which to retrieve the ports/regionIds.

Example: amazon
Responses
200

OK

get/api/directConnectPartner/{username}/regions
Response samples
application/json
{
  • "results": [
    ]
}

Get all DCP add-ons

Securityapi-key
Request
path Parameters
username
required
string

The username of the Direct Connect Partner (DCP) for which to retrieve the add-ons.

Example: amazon
Responses
200

OK

get/api/directConnectPartner/{username}/addons
Response samples
application/json
{
  • "results": [
    ]
}

Get all connections for a specified port

Securityapi-key
Request
path Parameters
companyName
required
string

The username of the company to check the port for.

Example: Acme
portId
required
string

The port id.

Example: 55767b5652a693344a015744
Responses
200

OK

get/api/company/{companyName}/ports/{portId}/connections
Response samples
application/json
{
  • "type": "LAYER2",
  • "name": "string",
  • "srcPortId": "string",
  • "speed": {
    },
  • "destMetroId": "string",
  • "destCompany": "string",
  • "destPortId": "string",
  • "paymentType": "creditcard",
  • "partner": {
    }
}

Check Port capabilities

Check the capabilities of a Port.

Prerequisites:

  • Your company has been verified on the Console Connect platform.
  • You have a port.
Securityapi-key
Request
path Parameters
companyId
required
string

The ID of the company requesting the capabilities check.

Example: 5e4cb418ab1dbe8c8476163b
portId
required
string

The ID of the port to request the capabilities of.

Example: 6ea4b418ab1dbe8c8476163b
Responses
200

OK

get/app-user/{companyId}/ports/{portId}/info
Response samples
application/json
{
  • "capabilities": {
    }
}
➔ Next to Layer 2 Connections