Get virtual GPU cluster

Get detailed information about a specific virtual GPU cluster.

GET /cloud/v3/gpu/virtual/{project_id}/{region_id}/clusters/{cluster_id}

Python

Python

import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
gpu_virtual_cluster = client.cloud.gpu_virtual.clusters.get(
    cluster_id="1aaaab48-10d0-46d9-80cc-85209284ceb4",
    project_id=1,
    region_id=7,
)
print(gpu_virtual_cluster.id)

200

{
  "created_at": "2024-12-31T23:59:59Z",
  "flavor": "g3-ai-32-192-1500-l40s-48-1",
  "has_pending_changes": false,
  "id": "1aaaab48-10d0-46d9-80cc-85209284ceb4",
  "managed_by": "user",
  "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",
        "port_security_enabled": true,
        "security_groups": [
          {
            "id": "ae74714c-c380-48b4-87f8-758d656cdad6",
            "name": "default"
          }
        ],
        "type": "external"
      }
    ],
    "security_groups": [
      {
        "id": "ae74714c-c380-48b4-87f8-758d656cdad6",
        "name": "default"
      }
    ],
    "ssh_key_name": "my-ssh-key",
    "user_data": "eyJ0ZXN0IjogImRhdGEifQ==",
    "username": "admin",
    "volumes": [
      {
        "boot_index": 1,
        "delete_on_termination": true,
        "image_id": "3793c250-0b3b-4678-bab3-e11afbc29657",
        "name": "my-data-disk",
        "size": 100,
        "tags": [
          {
            "key": "my-tag",
            "read_only": false,
            "value": "my-tag-value"
          }
        ],
        "type": "ssd"
      }
    ]
  },
  "status": "active",
  "tags": [
    {
      "key": "my-tag",
      "read_only": false,
      "value": "my-tag-value"
    }
  ],
  "updated_at": "2025-01-11T23:59:59Z"
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234_abcdef

Path Parameters

project_id · integer · required

Project ID

Example:

1

region_id · integer · required

Region ID

Example:

7

cluster_id · string<uuid4> · required

Cluster unique identifier

Example:

"1aaaab48-10d0-46d9-80cc-85209284ceb4"

Response

200

application/json

OK

created_at · string<date-time> · required

Cluster creation date time

Example:

"2024-12-31T23:59:59Z"

flavor · string · required

Cluster flavor name

Example:

"g3-ai-32-192-1500-l40s-48-1"

has_pending_changes · boolean · required

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

Example:

false

id · string<uuid4> · required

Cluster unique identifier

Example:

"1aaaab48-10d0-46d9-80cc-85209284ceb4"

managed_by · enum<string> · required

User type managing the resource

Available options: k8s, user

Example:

"user"

name · string · required

Cluster name

Example:

"my virtual gpu cluster"

servers_count · integer · required

Cluster servers count

Example:

2

servers_ids · string<uuid4>[] · required

List of cluster nodes

Example:

[
  "b4522653-fbcd-44a0-a949-541570a52281",
  "e56192de-ed28-452a-b775-eeeacc795e3b"
]

servers_settings · VirtualServerSettingsOutputSerializer · object · required

Show child attributes

status · enum<string> · required

Cluster status

Available options: active, creating, degraded, deleting, error, rebooting, rebuilding, resizing, shutoff

Example:

"active"

tags · TagSerializer · object[] · required

List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.

Show child attributes

Example:

[
  {
    "key": "my-tag",
    "read_only": false,
    "value": "my-tag-value"
  }
]

updated_at · string<date-time> | null · required

Cluster update date time

Example:

"2025-01-11T23:59:59Z"