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.

Creation is asynchronous — progress events are streamed back as Server-Sent Events (SSE). Subscribe with the same sequence_id via the events endpoint, or consume the SSE body on this response.

Authorization

bearer_auth

AuthorizationBearer <token>

OAuth Authentication

OpenScaler API uses OAuth, a standard for secure authorization. To access the API, obtain a token via the OpenScaler Platform.

Use the access_token in the Authorization header for requests:

Authorization: Bearer <token>

Always keep your token secure and do not share it with anyone.

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

A random number used to identify your creation request and receive progress updates.

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<string>

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

`text/event-stream`

`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 (missing required fields in token), please init user by sending POST request to `/v1/init` then refresh your token\n"    }  ]}

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

Authorization

OAuth Authentication

Request Body

Response Body

200text/event-stream

400application/json

403text/pain

444application/json

500application/json

`text/event-stream`

`application/json`

`text/pain`

`application/json`

`application/json`