Rack

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

A rack 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 rack is usually a fully closed rack that can be exclusive used by the customer.

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 which size racks are available on those site, including an indication of how many of those are still available.

Example availability response
[
    {
        "site": {
            "id": 1,
            "name": "Amsterdam",
            "description": "Onze primaire locatie"
        },
        "availability": [
            {
                "count": 0,
                "height": 42
            },
            {
                "count": 1,
                "height": 20
            },
            {
                "count": 2,
                "height": 10
            }
        ]
    },
    {
        "site": {
            "id": 3,
            "name": "Enschede",
            "description": "Secondaire locatie"
        },
        "availability": [
            {
                "count": 4,
                "height": 42
            },
            {
                "count": 3,
                "height": 1
            }
        ]
    }
]

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": 24,
        "code": "ENS",
        "name": "Rackspace Enschede",
        "products": [
            {
                "id": 223.0,
                "code": "3",
                "description": "100MB Uplink",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "gb_speed": 0.1
                }
            },
            {
                "id": 224.0,
                "code": "1",
                "description": "1GB Uplink",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "gb_speed": 1
                }
            },
            {
                "id": 225.0,
                "code": "1250",
                "description": "42U rackspace",
                "mandatory": false,
                "type": "COLOCATION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "size": 42
                }
            },
            {
                "id": 226.0,
                "code": "1251",
                "description": "20U rackspace",
                "mandatory": false,
                "type": "COLOCATION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "size": 20
                }
            },
            {
                "id": 227.0,
                "code": "1252",
                "description": "10U rackspace",
                "mandatory": false,
                "type": "COLOCATION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "size": 10
                }
            },
            {
                "id": 228.0,
                "code": "69",
                "description": "IPv4-adressen",
                "mandatory": false,
                "type": "IPADDRESS",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "ipv4": true
                }
            },
            {
                "id": 229.0,
                "code": "69",
                "description": "IPv6-adressen",
                "mandatory": false,
                "type": "IPADDRESS",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "ipv6": true
                }
            },
            {
                "id": 230.0,
                "code": "33",
                "description": "Plaatsingskosten",
                "mandatory": true,
                "type": "COLOCATION",
                "chargeType": "NRC",
                "tariff": "12.34",
                "meta": null
            },
            {
                "id": 237.0,
                "code": "1253",
                "description": "1kW connection",
                "mandatory": false,
                "type": "POWER",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "kw": 1,
                    "kwh_price": 0.16
                }
            },
            {
                "id": 238.0,
                "code": "1254",
                "description": "2kW connection",
                "mandatory": false,
                "type": "POWER",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "kw": 2,
                    "kwh_price": 0.16
                }
            },
            {
                "id": 300.0,
                "code": "1254",
                "description": "3kW connection",
                "mandatory": false,
                "type": "POWER",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "kw": 3,
                    "kwh_price": 0.16
                }
            },
            {
                "id": 403.0,
                "code": "1320",
                "description": "No Rack Uplink",
                "mandatory": false,
                "type": "CONNECTION",
                "chargeType": "MRC",
                "tariff": "12.34",
                "meta": {
                    "gb_speed": 0
                }
            }
        ],
        "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
            },
            "hoodie": {
                "description": "Hoodie",
                "type": "string",
                "readOnly": false,
                "allowedValues": [
                    "Female S",
                    "Female M",
                    "Female L",
                    "Male M",
                    "Male L",
                    "Male XL",
                    "Male XXL"
                ],
                "value": null,
                "defaultValue": ""
            },
            "ipAllocation": {
                "description": "IP allocatie toegestaan",
                "type": "boolean",
                "readOnly": true,
                "allowedValues": null,
                "value": true,
                "defaultValue": null
            }
        }
    }
]

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
rackProductId COLOCATION
powerProductId POWER
networkProductId CONNECTION
Sample order request
{
    "customerOrderId": "4f049859-296b-4025-be23-374d30373ab3",
    "packageId": 24,
    "rackProductId": 225,
    "powerProductId": 237,
    "networkProductId": 223,
    "parameters": {
        "subnetSize": [
            32,
            30
        ],
        "ipv6PrefixSize": 48,
        "hoodie": "Male L"
    }
}
Sample order response
{
    "orderId": "00000001/125",
    "customerOrderId": "4f049859-296b-4025-be23-374d30373ab3",
    "orderDateTime": "2024-07-26T13:20:52+02:00",
    "lastModifiedDateTime": "2024-07-26T13:20:53+02:00",
    "status": "NEW",
    "packageCode": "ENS",
    "packageName": "Rackspace Enschede",
    "products": [
        {
            "code": "33",
            "name": "Plaatsingskosten",
            "description": "",
            "chargeType": "NRC",
            "quantity": 1,
            "tariff": "12.34",
            "totalTariff": "12.34"
        },
        {
            "code": "1250",
            "name": "42U rackspace",
            "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": "3",
            "name": "100MB Uplink",
            "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"
        }
    ]
}

Rack lock

When a rack lock code has been configured it can be retrieved with the rack information endpoint. It will be placed in the lockCode field.

PDU

Racks can be equipped with a PDU (Power distribution unit) to monitor the rack power usage, which can be used to charge for usage. The 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.