GET
/
cloud
/
v2
/
ai
/
clusters
/
{project_id}
/
{region_id}
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
)
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": [
              {
                "port": "80",
                "protocols": [
                  "TCP",
                  "HTTP"
                ]
              },
              {
                "port": "53",
                "protocols": [
                  "UDP"
                ]
              }
            ],
            "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

​
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

​
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

​
count
integer
required

Number of objects

Required range: x >= 0
Examples:

1

​
results
AIClusterSerializer · object[]
required

Objects