Create elastic server

Create an auto-scaling elastic server pool. An Elastic Server is a cluster of VMs that scale horizontally based on load. You only pay for the VMs you actually use, not the maximum number of nodes in the pool.

The request waits until the pool is ready, then returns the pool as JSON.

Progress is a separate Server-Sent Events stream. Subscribe with the same sequence_id from this request body at GET /v1/events/create-elastic-server/{sequence_id}.

Authorization

bearer_auth

AuthorizationBearer <token>

Authentication

Create an API token on Profile. Send it in the Authorization header:

Authorization: Bearer os1_...

Do not use the Keycloak web-session JWT as an API token. Keep the secret secure and do not share it.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

size*VmSize

one of predefined sizes/flavors, see VM Sizes/Flavors section.

project_id*ProjectId

A globally unique identifier for a project (where resource is placed) - or "default" for your default project. Projects are used as workspaces to organize things and separate resources for different independent purposes.

name*VmName

Human readable name for the VM (user can set it manually), preferably unique per user. Try suggesting initial name based on the size/flavor of the VM, its region, and and a unique index number (e.g. if user already has 3 VMs in the same region with same flavor, new VM would have number 4), e.g. : "my-example-computer" (distro flavor/resources region vm-index).

This will also be used as hostname when creating the VM, so it should be a valid hostname : lowercase letters, numbers or hyphens with max length of 253. Must also not start with a hyphen.

Match^[a-z0-9][a-z0-9-]+$

Lengthlength <= 255

sequence_id*integer

Random number you choose to correlate this create request with progress on GET /v1/events/create-vm/{sequence_id}.

description?|

VM description given by user

region*RegionCreateRequest

Region where this resource will be created. One of the available regions, see Regions section for more information.

distro?"debian-13"

Identifier of the OS distribution.

Value in

"debian-13"

template_id?string

Optional ID of a user or marketplace template to create the VM from. When set, this takes precedence over distro for the image source. Either distro or template_id must be provided.

vpc_id?string

The ID of the VPC to which the VM will be assigned. See VPCs section for more details.

If excluded, the VM will be assigned to the user's default VPC for the region.

Formatuuid

ssh_key_ids?array<>

IDs of stored SSH keys to embed in the VM's root account upon creation.

Prefer this over deprecated ssh_keys. Required unless password is set.

ssh_keys?array<string>

Deprecated

Deprecated. Raw SSH public key material. Prefer ssh_key_ids.

password?VmCreatePassword

Encrypted Password to be set for the VM. The use of password is discouraged in favor of SSH keys.

allow_root_ssh_password_access?boolean

If true, allow root SSH login with the provided password.

Defaultfalse

cloud_init_user_data?CloudInitUserData

A string containing cloud-init 'user data' which may be used to configure the VM on first boot, often a 'cloud-config' file or Bash script. It must be plain text and may not exceed 64 KiB in size.

attached_disks?array<>

Optional additional disks to attach at creation time.

scale_config*|

Scaling policy for an elastic server pool. Either fixed node count or autoscaling.

Response Body

`application/json`

`text/pain`

`application/json`

curl -X POST "https://example.com/v1/elastic-servers" \  -H "Content-Type: application/json" \  -d '{    "name": "my-servers",    "description": "My elastic servers",    "region": "alg1",    "size": "s-1vcpu-1gb",    "project_id": "default",    "sequence_id": 123,    "distro": "debian-12",    "cloud_init_user_data": "#!/bin/bash\\napt update && apt install -y python3-flask\\n",    "scale_config": {      "autoscale": true,      "min_nodes": 1,      "max_nodes": 5,      "autoscaling_metrics": [        {          "type": "cpu",          "min_threshold": 30,          "max_threshold": 60        }      ],      "cooldown": 90,      "metrics_interval": 60    }  }'

{  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",  "name": "my-servers",  "description": "My elastic servers",  "user_id": "2abb7c25-a2d5-42ac-a776-e8ac5dfb16c3",  "project_id": "default",  "distro": "debian-12",  "region": "alg1",  "vcpus": 1,  "storageGB": 25,  "memoryMB": 1024,  "transferGB": 1000,  "size": "s-1vcpu-1gb",  "vpc_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",  "vpc_subnet": "10.0.20.0/24",  "scale_config": {    "autoscale": true,    "min_nodes": 1,    "max_nodes": 5,    "autoscaling_metrics": [      {        "type": "cpu",        "min_threshold": 30,        "max_threshold": 60      }    ],    "cooldown": 90,    "metrics_interval": 60  },  "paused": false,  "autoscale": true,  "created_at": "2024-06-01T12:00:00Z",  "updated_at": "2024-06-15T08:30:00Z"}

{  "errors": [    {      "message": "'vcpus' field must be an integer",      "field": "resource_id"    }  ]}

"Access denied"

{  "errors": [    {      "message": "User not initialized. Send POST /v1/init, then retry the request."    }  ]}

{  "errors": [    {      "message": "VM with ID 23 not found"    }  ]}

Authorization

Authentication

Request Body

Response Body

200application/json

400application/json

403text/pain

444application/json

500application/json

`application/json`

`application/json`

`text/pain`

`application/json`

`application/json`