Shared colocation

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

A shared colocation unit always has a fixed size in U (A standard rack unit defined as 1 and 3⁄4 inches (44.45 mm).) and can be ordered independently of its availability. A shared colocation unit is placed in a rack containing other shared colocation units from other customers.

Availability is subject to change and can only be used as indication.

Table of contents

Availability

The availability response contains the available locations (sites) and an indication of how many shared colocations units in U (A standard rack unit defined as 1 and 3⁄4 inches (44.45 mm).) are still available.

Example availability response
[
    {
        "site": {
            "id": 3,
            "name": "Enschede",
            "description": "Secondaire locatie"
        },
        "availability": 85
    }
]

The packages response contains all information about the possible configuration. The parameters and package codes are important for placing a valid order.

Example package response
[
    {
        "id": 30,
        "code": "ENS-SHARED",
        "name": "Shared Rackspace Enschede",
        "products": [
            {
                "id": 290.0,
                "code": "1",
                "description": "1GB Uplink",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "gb_speed": 1
                }
            },
            {
                "id": 294.0,
                "code": "69",
                "description": "IPv4-adressen",
                "mandatory": false,
                "type": "IPADDRESS",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "ipv4": true
                }
            },
            {
                "id": 295.0,
                "code": "69",
                "description": "IPv6-adressen",
                "mandatory": false,
                "type": "IPADDRESS",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "ipv6": true
                }
            },
            {
                "id": 296.0,
                "code": "33",
                "description": "Plaatsingskosten",
                "mandatory": true,
                "type": "COLOCATION",
                "chargeType": "NRC",
                "tariff": "12.34",
                "meta": null
            },
            {
                "id": 297.0,
                "code": "1253",
                "description": "1kW connection",
                "mandatory": false,
                "type": "POWER",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "kw": 1,
                    "kwh_price": 0.16
                }
            },
            {
                "id": 299.0,
                "code": "1292",
                "description": "Shared Rack - 1U",
                "mandatory": false,
                "type": "COLOCATION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "size": 1
                }
            },
            {
                "id": 301.0,
                "code": "1293",
                "description": "Shared Rack - 2U",
                "mandatory": false,
                "type": "COLOCATION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "size": 2
                }
            },
            {
                "id": 302.0,
                "code": "1294",
                "description": "Shared Rack - 4U",
                "mandatory": false,
                "type": "COLOCATION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "size": 4
                }
            },
            {
                "id": 303.0,
                "code": "1295",
                "description": "2 stopcontacten",
                "mandatory": false,
                "type": "PDU-POWER-PORT",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "count": 2
                }
            },
            {
                "id": 304.0,
                "code": "1296",
                "description": "4 stopcontacten",
                "mandatory": false,
                "type": "PDU-POWER-PORT",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "count": 4
                }
            },
            {
                "id": 305.0,
                "code": "1297",
                "description": "8 stopcontacten",
                "mandatory": false,
                "type": "PDU-POWER-PORT",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "count": 8
                }
            },
            {
                "id": 408.0,
                "code": "1320",
                "description": "No uplink",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "gb_speed": 0
                }
            },
            {
                "id": 409.0,
                "code": "1",
                "description": "Management link 1",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "gb_speed": 1,
                    "management": true
                }
            },
            {
                "id": 410.0,
                "code": "1",
                "description": "10GB",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "NRC",
                "tariff": "12.34",
                "meta": {
                    "gb_speed": 10
                }
            },
            {
                "id": 411.0,
                "code": "2",
                "description": "Management link 10",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "NRC",
                "tariff": "12.34",
                "meta": {
                    "gb_speed": 10,
                    "management": true
                }
            }
        ],
        "parameters": {
            "subnetSize": {
                "description": "IPv4 subnetgrootte",
                "type": "integer",
                "readOnly": false,
                "allowedValues": [
                    32,
                    31,
                    30,
                    29,
                    28,
                    27
                ],
                "value": null,
                "defaultValue": 32
            },
            "ipv6PrefixSize": {
                "description": "IPv6 prefix size",
                "type": "integer",
                "readOnly": false,
                "allowedValues": [
                    48
                ],
                "value": null,
                "defaultValue": 48
            },
            "ipAllocation": {
                "description": "IP allocatie toegestaan",
                "type": "boolean",
                "readOnly": true,
                "allowedValues": null,
                "value": true,
                "defaultValue": null
            },
            "powerPortCount": {
                "description": "Aantal benodigde stopcontacten voor een shared colo",
                "type": "integer",
                "readOnly": false,
                "allowedValues": null,
                "value": null,
                "defaultValue": 0
            }
        }
    }
]

Ordering

With the package information and the desired products, a request can be made. For a couple of product types a choice needs to be made and supplied as parameter during the order:

Order parameter Product type
sharedColoProductId COLOCATION
powerProductId POWER
powerPortProductId PDU-POWER-PORT
networkProductId CONNECTION
managementUplinkProductId CONNECTION with meta.management: true
Sample order request
{
    "customerOrderId": "15718736-4293-4dcb-9f1c-4cde2d6bb76e",
    "packageId": 30,
    "sharedColoProductId": 302,
    "powerProductId": 297,
    "powerPortProductId": 303,
    "networkProductId": 410,
    "managementUplinkProductId": 409,
    "parameters": {
        "subnetSize": [
            32,
            30
        ],
        "ipv6PrefixSize": 48
    }
}
Sample order response
{
    "orderId": "00000001/127",
    "customerOrderId": "15718736-4293-4dcb-9f1c-4cde2d6bb76e",
    "orderDateTime": "2024-07-26T13:43:50+02:00",
    "lastModifiedDateTime": "2024-07-26T13:43:50+02:00",
    "status": "NEW",
    "packageCode": "ENS-SHARED",
    "packageName": "Shared Rackspace Enschede",
    "products": [
        {
            "code": "33",
            "name": "Plaatsingskosten",
            "description": "",
            "chargeType": "NRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        },
        {
            "code": "1294",
            "name": "Shared Rack - 4U",
            "description": "",
            "chargeType": "MRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        },
        {
            "code": "1253",
            "name": "1kW connection",
            "description": "",
            "chargeType": "MRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        },
        {
            "code": "1295",
            "name": "2 stopcontacten",
            "description": "",
            "chargeType": "MRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        },
        {
            "code": "1",
            "name": "10GB",
            "description": "",
            "chargeType": "NRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        },
        {
            "code": "1",
            "name": "Management link 1",
            "description": "",
            "chargeType": "MRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        },
        {
            "code": "69",
            "name": "IPv4-adressen",
            "description": "",
            "chargeType": "MRC",
            "quantity": 4,
            "tariff": "12.34",
            "totalTariff": "49.36"
        },
        {
            "code": "69",
            "name": "IPv6-adressen",
            "description": "",
            "chargeType": "MRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        }
    ]
}

Power ports

A shared colocation unit can be connection on a PDU (Power distribution unit) power outlet, which can be controlled and registers the power usage.

De power ports details indicates whether a power port can be controlled (using the controllable field). When controllable, each port can receive one of three actions:

Action Result
turn-off Turns the power outlet off until instructed otherwise.
turn-on Turns the power outlet on until instructed otherwise.
toggle Turns the power outlet off for a couple of seconds, to turn it on afterwards.

The power usage information recorded can be retrieved using the power details endpoint. Depending on the passed parameters it will return either daily or hourly values. Only when the hourly values are requested the net reading (voltage & current) are included.

Example response - Daily
{
    "usage": {
        "2024-07-01": 18.583,
        "2024-07-02": 18.611,
        "2024-07-03": 18.512,
        ...
    },
    "netReadings": null
}
Example response - Hourly
{
    "usage": {
        "2024-07-05T00:00": 0.725,
        "2024-07-05T01:00": 0.723,
        "2024-07-05T02:00": 0.721,
        ...
    },
    "netReadings": {
        "2024-07-05T00:00": {
            "i": 3.23,
            "v": 228.39
        },
        "2024-07-05T00:10": {
            "i": 3.31,
            "v": 228.39
        },
        "2024-07-05T00:20": {
            "i": 3.19,
            "v": 228.42
        },
        ...
    }
}

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.