Data centre interconnect

Swagger-UI: direct-order-v1 | OpenAPI file: direct-order-v1.yml

Before data centre interconnects can be ordered the customer must have an active rack.

A data centre interconnect is either a Cross Connect (A connection between two places within the same data centre.) or a Metro Connect (A connection between two places in two different data centres.) , which is represented by respectively the codes CROSS-CONNECT and METRO-CONNECT.

Table of contents

Availability

Before ordering, the available packages need to be retrieved. Each package will contain products which are specific to a site (data centre) and will contain information about the costs.

Example availability response
[
    {
        "id": 52,
        "code": "CROSS-CONNECT",
        "name": "Cross Connect",
        "products": [
            {
                "id": 400.0,
                "code": "1186",
                "description": "Cross Connect - SiteA",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "site_id": 20
                }
            },
            {
                "id": 404.0,
                "code": "1189",
                "description": "Setup Fee - Cross Connect - SiteA - One Time",
                "mandatory": true,
                "type": "SETUP",
                "chargeType": "NRC",
                "tariff": "12.34",
                "meta": {
                    "site_id": 20
                }
            },
            {
                "id": 405.0,
                "code": "1187",
                "description": "Cross Connect - SiteB",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "site_id": 10
                }
            },
            {
                "id": 406.0,
                "code": "1190",
                "description": "Setup Fee - Cross Connect - SiteB - One Time",
                "mandatory": true,
                "type": "SETUP",
                "chargeType": "NRC",
                "tariff": "12.34",
                "meta": {
                    "site_id": 10
                }
            },
            {
                "id": 407.0,
                "code": "1188",
                "description": "Cross Connect - NRC OUM01",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "site_id": 22
                }
            },
            {
                "id": 408.0,
                "code": "1191",
                "description": "Setup Fee - Cross Connect - NRC OUM01 - One Time",
                "mandatory": true,
                "type": "SETUP",
                "chargeType": "NRC",
                "tariff": "12.34",
                "meta": {
                    "site_id": 22
                }
            }
        ],
        "parameters": {
            "sourceId": {
                "description": "Source identifier",
                "type": "integer",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": null
            },
            "sourceText": {
                "description": "Source description",
                "type": "string",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": ""
            },
            "targetId": {
                "description": "Target identifier",
                "type": "integer",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": null
            },
            "targetText": {
                "description": "Target description",
                "type": "string",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": ""
            },
            "custRef": {
                "description": "Customer reference",
                "type": "string",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": ""
            }
        }
    },
    {
        "id": 53,
        "code": "METRO-CONNECT",
        "name": "Metro Connect",
        "products": [
            {
                "id": 418.0,
                "code": "1195",
                "description": "Setup fee - Metro Connect",
                "mandatory": true,
                "type": "SETUP",
                "chargeType": "NRC",
                "tariff": "12.34",
                "meta": {
                    "a_site_id": 20,
                    "z_site_id": 10
                }
            },
            {
                "id": 419.0,
                "code": "1194",
                "description": "SiteA - SiteB - Metro Connect",
                "mandatory": true,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "a_site_id": 20,
                    "z_site_id": 10
                }
            }
        ],
        "parameters": {
            "sourceId": {
                "description": "Source identifier",
                "type": "integer",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": null
            },
            "sourceText": {
                "description": "Source description",
                "type": "string",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": ""
            },
            "targetId": {
                "description": "Target identifier",
                "type": "integer",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": null
            },
            "targetText": {
                "description": "Target description",
                "type": "string",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": ""
            },
            "custRef": {
                "description": "Customer reference",
                "type": "string",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": ""
            }
        }
    }
]

Cross connect

Its meta will at least include the following parameter:

  • site_id: The site identifier

Metro connect

Its meta will at least include the following parameters:

  • a_site_id: The site identifier for the source site
  • z_site_id: The site identifier for the target site

Ordering

The required parameters differ per interconnect type, but the sourceId which points to a rack is always required. If the target is another known rack, the targetId should be specified as well. If the target is another party, targetId must be set to -1 and the submission of a LOA (Letter of Authorisation) document is required.

This request requires the data to be submitted as multipart/form-data due to the possible LOA (Letter of Authorisation) upload when another party is the target.

Example order request
------WebKitFormBoundaryO1f20n7OrVbnB4V2
Content-Disposition: form-data; name="loa"; filename="my_loa.pdf"
Content-Type: application/pdf

------WebKitFormBoundaryO1f20n7OrVbnB4V2
Content-Disposition: form-data; name="request"; filename="blob"
Content-Type: application/json

{"customerOrderId":"34bd2687-d81e-405e-94a8-ebf5f0fe449f","parameters":{"sourceId":1,"targetId":-1,"targetText":"Other party"}}
------WebKitFormBoundaryO1f20n7OrVbnB4V2--
Example order response
{
    "orderId": "00000001/126",
    "customerOrderId": "6732561b-509f-4d97-8319-d4b349dc39bf",
    "orderDateTime": "2024-07-26T13:24:44+02:00",
    "lastModifiedDateTime": "2024-07-26T13:24:44+02:00",
    "status": "NEW",
    "packageCode": "CROSS-CONNECT",
    "packageName": "Cross Connect",
    "products": [
        {
            "code": "58",
            "name": "Setup SiteA",
            "description": "",
            "chargeType": "NRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        },
        {
            "code": "58",
            "name": "General setup",
            "description": "",
            "chargeType": "NRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        },
        {
            "code": "59",
            "name": "Cross-connect SiteA",
            "description": "",
            "chargeType": "MRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        }
    ]
}

SA document

When an order is completed, an SA (Service Agreement) will be available which lists all information for the data centre interconnect. This file can be downloaded as PDF.