DAdatacrunch
Instance groups

Create an instance group

Changed on

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
descriptionobject 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_atobject 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

  • 416768e2fdd7Revision changes
    • breaking

      the response's property type changed from string to object, and format from date-time to no format for status

    • breaking

      the response's property type changed from string to object for status

  • feda601a5b19Revision changes
    • warning

      removed the request property //

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status