Sign in

v32

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

List virtual GPU cluster servers

List all servers in a virtual GPU cluster.

get/cloud/v3/gpu/virtual/{project_id}/{region_id}/clusters/{cluster_id}/servers

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

Query parameters

changed_beforestring date-time

Filters the results to include only servers whose last change timestamp is less than the specified datetime. Format: ISO 8601.

Example:2025-10-01T12:00:00Z

Filters the results to include only servers whose last change timestamp is less than the specified datetime. Format: ISO 8601.

changed_sincestring date-time

Filters the results to include only servers whose last change timestamp is greater than or equal to the specified datetime. Format: ISO 8601.

Example:2025-10-01T12:00:00Z

Filters the results to include only servers whose last change timestamp is greater than or equal to the specified datetime. Format: ISO 8601.

ip_addressstring

Filter servers by ip address.

Example:237.84.2.178

Filter servers by ip address.

limitinteger

Limit of items on a single page

Example:10

Limit of items on a single page

namestring

Filter servers by name. You can provide a full or partial name, servers with matching names will be returned. For example, entering 'test' will return all servers that contain 'test' in their name.

Filter servers by name. You can provide a full or partial name, servers with matching names will be returned. For example, entering 'test' will return all servers that contain 'test' in their name.

offsetinteger

Offset in results list

Offset in results list

order_by'created_at.asc' | 'created_at.desc' | 'status.asc' | 'status.desc'

Order field

status'ACTIVE' | 'BUILD' | 'ERROR' | 'HARD_REBOOT' | 'MIGRATING' | 'PAUSED' | 'REBOOT' | 'REBUILD' | 'RESIZE' | 'REVERT_RESIZE' | 'SHELVED' | 'SHELVED_OFFLOADED' | 'SHUTOFF' | 'SOFT_DELETED' | 'SUSPENDED' | 'VERIFY_RESIZE'

Filters servers by status.

uuidsstring[]

Filter servers by uuid.

Filter servers by uuid.

Response

OK

countinteger required

Number of objects

Example response

{
  "count": 1,
  "results": [
    {
      "created_at": "2025-03-17T13:22:23Z",
      "flavor": "g3-ai-64-384-3000-l40s-48-2",
      "id": "b6e58490-58d3-451c-bb77-4178157c98b2",
      "image_id": "ded40aad-505c-463b-aa59-8f5f455d1b6f",
      "ip_addresses": [
        "192.168.1.1"
      ],
      "name": "my-server-e2241889",
      "security_groups": [
        {
          "id": "ae74714c-c380-48b4-87f8-758d656cdad6",
          "name": "default"
        }
      ],
      "ssh_key_name": "ded40aad-505c-463b-aa59-8f5f455d1b6f",
      "tags": [
        {
          "key": "task_id",
          "read_only": true,
          "value": "d74c2bb9-cea7-4b23-a009-2f13518ae66d"
        }
      ],
      "task_id": "ded40aad-505c-463b-aa59-8f5f455d1b6f",
      "updated_at": "2025-03-17T13:22:23Z"
    }
  ]
}