Sign in

v32

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

Update bare metal GPU cluster

Update the name of an existing bare metal GPU cluster.

Update tags for a bare metal GPU cluster (and apply to all its nodes) using JSON Merge Patch semantics (RFC 7386). To add or update tags, provide key-value pairs. To remove a tag, set its value to null.

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

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

namestring

Cluster name

tagsUpdateTagsSerializer

Example request

{
  "name": "gpu-cluster-1"
}

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"
}