Global Backbone Maintenance: Please check out our status page for more information.
Home Features Pricing Network Benchmarks System Status

Cloud API

Automate deployments and easily scale your global cloud infrastructure using the Aulerion Cloud API. Simply retrieve your personal API key in the control panel and get started!

Cloud API v1 Introduction

Welcome to the Aulerion API documentation.

The Aulerion Cloud API allows you to manage all your cloud computing resources in a flexible, standarized and easy manner using conventional HTTP requests. The documentation below lists all available methods and requests - stay tuned for more coming soon.

HTTP Response Status

If an error occurs, the HTTP header status_code is set to 403, 404 or 500. A detailed error message will be returned in the body of the response, please see the following example:

HTTP/2 403 
{
    "id": "forbidden",
    "message": "You do not have access to this method."
}

cURL Examples

Querying our API is simple. The endpoint is api.aulerion.com, the URL consists of https:// endpoint /version, whereas the current version is v1. The API Key has to be provided as HTTP header Authorization: Bearer key.

curl -X GET -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/account/

Account

GET Display account information

Request
curl -X GET -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/account/
Response
{
    "account": {
        "email": "demo-account@aulerion.com",
        "balance": 9732.139,
        "affiliate_balance": 0,
        "bgp_asn": [
            64514
        ],
        "bgp_asmacro": null,
        "compute_limit": 999,
        "terminated": false,
        "suspended": false,
        "active": true,
        "uuid": "4514f6c6137100268064ef83a05352a7"
    }
}

Operating Systems

GET List available operating systems

Request
curl -X GET -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/os/
Response
{
    "os": [
        {
            "id": 9,
            "distribution": "ubuntu",
            "codename": "bionic",
            "version": "18.04"
        },
        {
            "id": 10,
            "distribution": "ubuntu",
            "codename": "cosmic",
            "version": "18.10"
        },
        {
            "id": 11,
            "distribution": "ubuntu",
            "codename": "disco",
            "version": "19.04"
        },
...

Packages

GET List available packages

Request
curl -X GET -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/packages/
Response
{
    "packages": [
        {
            "id": 24,
            "class": "SCI",
            "name": "SCI1",
            "vcpus": 1,
            "memory": 512,
            "disk": 10,
            "disk_type": "ssd",
            "transfer": 500,
            "uplink": 10000,
            "price_month": 2.5,
            "price_hour": 0.0035
        },
        {
            "id": 12,
            "class": "SACI",
            "name": "SACI1",
            "vcpus": 1,
            "memory": 1024,
            "disk": 100,
            "disk_type": "sata",
            "transfer": 5000,
            "uplink": 1000,
            "price_month": 5,
            "price_hour": 0.0069
        },
        {
            "id": 20,
            "class": "ESCI",
            "name": "ESCI1",
            "vcpus": 2,
            "memory": 512,
            "disk": 10,
            "disk_type": "ssd",
            "transfer": 200,
            "uplink": 1000,
            "price_month": 5,
            "price_hour": 0.0069
        },
...

Datacenters

GET List available datacenters

Request
curl -X GET -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/datacenters/
Response
{
    "datacenters": [
        {
            "id": 5,
            "city": "Amsterdam",
            "country": "Netherlands",
            "country_code": "NL",
            "iata_code": "ams1",
            "available_packages": [
                24,
                25,
                26
            ]
        },
        {
            "id": 13,
            "city": "Dallas",
            "country": "United States",
            "country_code": "US",
            "iata_code": "dal1",
            "available_packages": [
                24,
                25,
                26,
                27,
                28,
                29
            ]
        },
        {
            "id": 18,
            "city": "Frankfurt",
            "country": "Germany",
            "country_code": "DE",
            "iata_code": "fra1",
            "available_packages": []
        },
...

Instances

GET List all active instances

Request
curl -X GET -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/instances/
Response
{
    "instances": [
        {
            "uuid": "379fb953727398b69e65b019de7e3cab",
            "name": "demo-server",
            "label": "demo-server",
            "vcpus": 1,
            "memory": 1024,
            "disk": 100,
            "package_id": 12,
            "operating_system": {
                "distribution": "debian",
                "codename": "stretch",
                "version": "9.5",
                "id": "5"
            },
            "custom_iso": null,
            "networks": {
                "public": {
                    "ipv4": [
                        {
                            "address": "100.64.100.1",
                            "netmask": "255.255.255.224",
                            "gateway": "100.64.100.30"
                        }
                    ],
                    "ipv6": [
                        {
                            "subnet": "2a06:8182:1000::",
                            "netmask": 64
                        }
                    ]
                },
                "private": null
            },
            "datacenter": {
                "id": 15,
                "iata": "hel1",
                "name": "helsinki"
            },
            "auth": {
                "setup_password": "hTqF$U32bV$CkZD$",
                "sshkeys": [
                    "c553c70e7e9d143d35d092a32ea389f6"
                ]
            },
            "meta": {
                "deploy_epoch": 0,
                "deploy_date": "1970-01-01 01:00:00"
            },
            "status": "running"
        },
...

GET List a particular instances

Request
curl -X GET -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/instances/#uuid#/
Response
{
    "instance": {
        "uuid": "cb1e986865788391e10b26c7685b27c9",
        "name": "demo-server-2",
        "label": "demo-server-2",
        "vcpus": 2,
        "memory": 2048,
        "disk": 20,
        "package_id": 26,
        "operating_system": {
            "distribution": "debian",
            "codename": "stretch",
            "version": "9.5",
            "id": "5"
        },
        "custom_iso": null,
        "networks": {
            "public": {
                "ipv4": [
                    {
                        "address": "100.64.100.3",
                        "netmask": "255.255.255.224",
                        "gateway": "100.64.100.30"
                    }
                ],
                "ipv6": [
                    {
                        "subnet": "2a06:8182:4000::",
                        "netmask": 64
                    }
                ]
            },
            "private": null
        },
        "datacenter": {
            "id": 15,
            "iata": "hel1",
            "name": "helsinki"
        },
        "auth": {
            "setup_password": "yNWjNYBq%6B2FWQT",
            "sshkeys": [
                "c553c70e7e9d143d35d092a32ea389f6"
            ]
        },
        "meta": {
            "deploy_epoch": 0,
            "deploy_date": "1970-01-01 01:00:00"
        },
        "status": "running"
    }
}

POST Deploy new instance

Request
curl -X POST -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/instances/ -d 'hostname=my-server' -d 'label=my-server' -d 'datacenter=15' -d 'os=9' -d 'package=24'

Required: hostname, label, datacenter, os, package

Optional: sshkeys

Response
{
    "instance": {
        "uuid": "cd6e881b4c89fe2772744cc9ce9a89bc",
        "name": "my-server",
        "label": "my-server",
        "vcpus": 1,
        "memory": 512,
        "disk": 10,
        "package_id": 24,
        "operating_system": {
            "distribution": "ubuntu",
            "codename": "bionic",
            "version": "18.04",
            "id": "9"
        },
        "custom_iso": null,
        "networks": {
            "public": {
                "ipv4": [
                    {
                        "address": "100.64.100.2",
                        "netmask": "255.255.255.224",
                        "gateway": "100.64.100.30"
                    }
                ],
                "ipv6": [
                    {
                        "subnet": "2a06:8182:2000::",
                        "netmask": 64
                    }
                ]
            },
            "private": null
        },
        "datacenter": {
            "id": 15,
            "iata": "hel1",
            "name": "helsinki"
        },
        "auth": {
            "setup_password": "vwNB_7%GeFjG7rCq",
            "sshkeys": []
        },
        "meta": {
            "deploy_epoch": 0,
            "deploy_date": "1970-01-01 01:00:00"
        },
        "status": "deploying"
    }
}
...

POST Start an instance

Request
curl -X POST -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/instances/#uuid#/start/
Response
{
    "id": "success",
    "message": "Server successfully started."
}

POST Stop an instance

Request
curl -X POST -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/instances/#uuid#/stop/
Response
{
    "id": "success",
    "message": "Server successfully stopped."
}

POST Delete an instance

Request
curl -X POST -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/instances/#uuid#/delete/
Response
{
    "id": "success",
    "message": "Server successfully deleted."
}

GET Get bandwidth usage

Request
curl -X GET -H 'Authorization: Bearer testkey' https://api.aulerion.com/v1/instances/#uuid#/bandwidth/
Response
{
    "instance": {
        "bandwidth_usage": {
            "rx": 6181.066855788231,
            "tx": 6035.175174474716
        },
        "bandwidth_overages": 51.06276996433735,
        "uuid": "cb1e986865788391e10b26c7685b27c9"
    }
}

Units: rx/tx: GiBytes, overages: USD

Ready to enter the next-generation cloud?

Create My Account