Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
GPU Bare Metal

Update bare metal GPU cluster server settings

This operation only modifies cluster settings such as SSH key, image, and user data. It does NOT modify or rebuild any existing servers in the cluster.

To apply these configuration changes to running servers, use the /cloud/v3/gpu/baremetal/{project_id}/{region_id}/clusters/{cluster_id}/rebuild endpoint.

patch/cloud/v3/gpu/baremetal/{project_id}/{region_id}/clusters/{cluster_id}/servers_settings

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:7

Region ID

cluster_idstring uuid4 required

Cluster unique identifier

Example:1aaaab48-10d0-46d9-80cc-85209284ceb4

Cluster unique identifier

Request body

image_idstring uuid4

System image ID

Example request

{
  "image_id": "3793c250-0b3b-4678-bab3-e11afbc29657",
  "servers_settings": {
    "credentials": {
      "ssh_key_name": "my-ssh-key"
    },
    "user_data": "eyJ0ZXN0IjogImRhdGEifQ=="
  }
}

Response

OK

created_atstring date-time required

Cluster creation date time

flavorstring required

Cluster flavor name

has_pending_changesboolean required

True if any server in the cluster has pending (not yet applied) settings changes

idstring uuid4 required

Cluster unique identifier

image_idstring required

Image ID

managed_by'k8s' | 'user' required
namestring required

Cluster name

servers_countinteger required

Cluster servers count

servers_idsstring[] required

List of cluster nodes

status'active' | 'creating' | 'degraded' | 'deleting' | 'error' | 'rebooting' | 'rebuilding' | 'resizing' | 'shutoff' required
updated_atstring date-time nullable required

Cluster update date time

Example response

{
  "created_at": "2024-12-31T23:59:59Z",
  "flavor": "g3-ai-32-192-1500-l40s-48-1",
  "id": "1aaaab48-10d0-46d9-80cc-85209284ceb4",
  "image_id": "76645f69-3219-417b-be59-99361f02e0d3",
  "name": "my virtual gpu cluster",
  "servers_count": 2,
  "servers_ids": [
    "b4522653-fbcd-44a0-a949-541570a52281",
    "e56192de-ed28-452a-b775-eeeacc795e3b"
  ],
  "servers_settings": {
    "file_shares": [
      {
        "id": "a3f2d1b8-45e6-4f8a-bb5d-19dbf2cd7e9a",
        "mount_path": "/mnt/vast"
      }
    ],
    "interfaces": [
      {
        "ip_family": "ipv4",
        "name": "eth0"
      }
    ],
    "security_groups": [
      {
        "id": "ae74714c-c380-48b4-87f8-758d656cdad6",
        "name": "default"
      }
    ],
    "ssh_key_name": "my-ssh-key",
    "user_data": "eyJ0ZXN0IjogImRhdGEifQ=="
  },
  "tags": [
    {
      "key": "my-tag",
      "read_only": false,
      "value": "my-tag-value"
    }
  ],
  "updated_at": "2025-01-11T23:59:59Z"
}