GET
/
cloud
/
v2
/
ai
/
clusters
/
{project_id}
/
{region_id}
import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
page = client.cloud.gpu_baremetal_clusters.list(
    project_id=0,
    region_id=0,
)
page = page.results[0]
print(page.cluster_id)
{
  "count": 1,
  "results": [
    {
      "cluster_id": "d1e1500b-e2be-40aa-9a4b-cc493fa1af30",
      "cluster_name": "my-gpu-cluster",
      "cluster_status": "ACTIVE",
      "created_at": "2025-04-17 12:05:22.597284",
      "creator_task_id": "d1e1500b-e2be-40aa-9a4b-cc493fa1af30",
      "flavor": "bm3-ai-1xlarge-h100-80-8",
      "image_id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
      "image_name": "ubuntu-22.04-x64-nvidia-a100/h100-550-12.4-eni",
      "interfaces": [
        {
          "network_id": "024a29e9-b4b7-4c91-9a46-505be123d9f8",
          "port_id": "2c5eae5b-f76a-4c23-98ff-c77bc0a8bab5",
          "subnet_id": "91200a6c-07e0-42aa-98da-32d1f6545ae7",
          "type": "<string>"
        }
      ],
      "password": "my-password",
      "project_id": 1337,
      "region": "Luxembourg 1",
      "region_id": 7,
      "servers": [
        {
          "addresses": {},
          "blackhole_ports": [
            {
              "AlarmEnd": "2025-02-05 12:04:30",
              "AlarmStart": "2025-02-05 12:04:11",
              "AlarmState": "alarm",
              "AlertDuration": "2 hours",
              "DestinationIP": "80.240.114.116",
              "ID": 123
            }
          ],
          "created_at": "2023-11-29T10:56:49Z",
          "creator_task_id": "<string>",
          "ddos_profile": {
            "fields": [
              {
                "base_field": 10,
                "default": null,
                "description": "ARK server ports. Valid port values are in range 1000-65535",
                "field_type": null,
                "field_value": [
                  45046,
                  45047
                ],
                "id": 11,
                "name": "ARK Ports",
                "required": true,
                "validation_schema": {
                  "items": {
                    "maximum": 65535,
                    "minimum": 1000,
                    "type": "integer"
                  },
                  "minItems": 1,
                  "type": "array"
                },
                "value": null
              }
            ],
            "id": 0,
            "options": {
              "active": true,
              "bgp": true
            },
            "profile_template": {
              "description": "description",
              "fields": [
                {
                  "default": null,
                  "description": "ARK server ports. Valid port values are in range 1000-65535",
                  "field_type": null,
                  "id": 11,
                  "name": "ARK Ports",
                  "required": true,
                  "validation_schema": {
                    "items": {
                      "maximum": 65535,
                      "minimum": 1000,
                      "type": "integer"
                    },
                    "minItems": 1,
                    "type": "array"
                  }
                }
              ],
              "id": 123,
              "name": "ICMP port"
            },
            "profile_template_description": "ARK server ports. Valid port values are in range 1000-65535",
            "protocols": [
              {
                "additionalProp1": "string",
                "additionalProp2": "string",
                "additionalProp3": "string"
              }
            ],
            "site": "ED",
            "status": {
              "error_description": "",
              "status": "Updated"
            }
          },
          "fixed_ip_assignments": [
            {
              "external": true,
              "ip_address": "123.123.123.1",
              "subnet_id": "eaafdc3c-f48b-4eb4-826f-057dfc7d6476"
            }
          ],
          "flavor": {
            "architecture": "x86_64",
            "flavor_id": "g2-standard-32-64",
            "flavor_name": "g2-standard-32-64",
            "hardware_description": {
              "cpu": "1x Intel Xeon 4C/8T 3.7 GHz",
              "disk": "2x 250GiB SSD",
              "gpu": "NVIDIA h100-8GPU (80GB)",
              "license": "",
              "network": "1x 500Mbps",
              "ram": "32 GiB"
            },
            "os_type": "linux",
            "ram": 2048,
            "resource_class": "bm2-hf-medium",
            "vcpus": 1
          },
          "id": "6c6aa80f-7836-4dc2-a2ae-125e248be476",
          "instance_description": "Instance description",
          "instance_isolation": {
            "reason": "Suspicious activities"
          },
          "name": "my-server-1",
          "project_id": 111,
          "region": "Luxembourg",
          "region_id": 4,
          "security_groups": [
            {
              "name": "some_name"
            }
          ],
          "ssh_key_name": "my-ssh-key",
          "status": "ACTIVE",
          "tags": [
            {
              "key": "my-tag",
              "read_only": false,
              "value": "my-tag-value"
            }
          ],
          "task_id": null,
          "task_state": "<string>",
          "vm_state": "active"
        }
      ],
      "ssh_key_name": "my-ssh-key",
      "tags": [
        {
          "key": "my-tag",
          "read_only": false,
          "value": "my-tag-value"
        }
      ],
      "task_id": "d1e1500b-e2be-40aa-9a4b-cc493fa1af30",
      "task_status": "FINISHED",
      "user_data": "<string>",
      "username": "my-username"
    }
  ]
}

Authorizations

APIKey
string
header
required

API key for authentication.

Path Parameters

project_id
integer
required

Project ID

region_id
integer
required

Region ID

Query Parameters

limit
integer

Limit the number of returned clusters

offset
integer

Offset value is used to exclude the first set of records from the result

Response

200 - application/json

List of GPU clusters

The response is of type object.