Instance groups

Create an instance group

Creates a project-scoped group with a name, description, location, instance type and template.

post/v1/instance-groups

Request

  • Base URL: https://api.verda.com
  • URL: https://api.verda.com/v1/instance-groups
  • Auth: HTTP bearer

Request body

namestring required
descriptionstring
location_codestring required
instance_typestring required

A known instance type code. Fixed for the life of the group.

Example request

{
  "name": "hive-b300-pool-1",
  "location_code": "FIN-02",
  "instance_type": "8B300.640S.176V",
  "template": {
    "image": "ubuntu-24.04-cuda-12.8-docker",
    "os_volume": {
      "size": 200
    }
  }
}

Response

idstring required
project_idstring required
namestring required
descriptionstring nullable required
location_codestring required
instance_typestring required
templateobject required

The instance template stored by the group.

created_atstring date-time required
updated_atstring date-time required
deleted_atstring date-time nullable required

Non-null only on a tombstoned group. Public and internal reads return live groups only.

sizenumber required

Number of live instances in the group.

Changes

No recorded changes to this operation across all 1 revision of this API.