Clusters

Deploy cluster

Changed on

Deploy a new cluster.

Before deploying add at least one SSH key to enable access to your cluster.

Cluster types can be listed using the GET /v1/cluster-types endpoint. Image types can be listed using the GET /v1/images/cluster endpoint.

post/v1/clusters

Request

  • Base URL: https://api.verda.com
  • URL: https://api.verda.com/v1/clusters
  • Auth: HTTP bearer

Request body

cluster_typestring required

Cluster instance type. Can be listed using the GET /v1/cluster-types endpoint.

imagestring required

OS image type or UUID for the cluster. For a list of advertised images, check GET /v1/images/cluster. Hidden images can also be deployed directly. The image must be enabled or explicitly enabled for the project owner and compatible with the cluster type.

startup_script_idstring

Startup script ID to run on cluster initialization

hostnamestring required
descriptionstring

Optional cluster description. Omit or pass null to use an empty string.

location_codestring required

Location code for the cluster and its shared volume

contract'PAY_AS_YOU_GO' | 'LONG_TERM'

Contract type. For clusters, only PAY_AS_YOU_GO currently supported.

extension_settings'auto_renew' | 'pay_as_you_go' | 'end_contract'

Extension settings for long-term contracts. Takes priority over auto_rental_extension and turn_to_pay_as_you_go.

auto_rental_extensionboolean

Deprecated: use extension_settings instead. Enable automatic rental extension for long-term contracts.

turn_to_pay_as_you_goboolean

Deprecated: use extension_settings instead. Automatically convert to pay-as-you-go after the long-term period ends.

Example request

{
  "cluster_type": "16H200",
  "image": "ubuntu-22.04-cuda-12.4-cluster",
  "startup_script_id": "be3dbe7d-237c-4c49-9d85-bfd7dd072a5a",
  "hostname": "dark-vm-shrinks-fin-01",
  "description": "ubuntu-22-04-cuda-12-4-16b200-fin-01",
  "tags": [
    {
      "key": "environment",
      "value": "production"
    },
    {
      "key": "benchmark"
    }
  ],
  "location_code": "FIN-01",
  "contract": "PAY_AS_YOU_GO",
  "shared_volume": {
    "name": "SFS-pmAna3o2",
    "size": 30000
  },
  "existing_volumes": []
}

Response

Cluster deployed

idstring required

Example response

{
  "id": "66b8db5d-4ec7-4354-820d-6fe4e9ca28bc"
}

Changes

  • 31918503bdd7Revision changes
    • warning

      deleted the header request parameter cf-connecting-ip

    • warning

      deleted the header request parameter user-agent

  • af37d33af0b7Revision changes
    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable