Huddle01 Cloud
Instances

Create instance

Provisions a new instance.

POST
/instances
x-api-key<token>

In: header

Query Parameters

regionstring

The region to deploy the instance in.

Default"eu2"
namestring
Length1 <= length <= 255
flavor_refstring
image_refstring
key_name?string
volume_sizeinteger
Default10
Range8 <= value
security_groups?array<string>
tags?array<string>

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://anton-api.huddle01.media/api/v1/instances?region=eu2" \  -H "Content-Type: application/json" \  -d '{    "name": "my-server",    "flavor_ref": "c2-small",    "image_ref": "ubuntu-22-04-x64",    "volume_size": 20  }'
{
  "id": "string",
  "name": "string",
  "vcpus": 0.1,
  "ram": 0.1,
  "status": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "image": {
    "id": "string",
    "name": "string",
    "distribution": "string",
    "distribution_version": "string"
  },
  "region": {
    "name": "eu2"
  }
}
Empty
{
  "status": "HTTP_400",
  "message": "Invalid request",
  "data": {},
  "request_id": "string"
}
{
  "status": "HTTP_400",
  "message": "Invalid request",
  "data": {},
  "request_id": "string"
}
{
  "status": "HTTP_400",
  "message": "Invalid request",
  "data": {},
  "request_id": "string"
}