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 sitez_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.