List regions with GPU cluster support

Retrieve a list of regions that support GPU clusters. For resellers, returns all AI regions. For regular clients, returns only active AI regions.

GET /cloud/v1/ai/regions

List regions with GPU cluster support

cURL

curl --request GET \
  --url https://api.gcore.com/cloud/v1/ai/regions \
  --header 'Authorization: <api-key>'

200

{
  "count": 1,
  "results": [
    {
      "access_level": "core",
      "created_on": "2023-11-07T05:31:56Z",
      "display_name": "<string>",
      "endpoint_type": "admin",
      "external_network_id": "<string>",
      "has_ai": true,
      "has_ai_gpu": true,
      "has_baremetal": true,
      "has_basic_vm": true,
      "has_ddos": true,
      "has_k8s": true,
      "has_kvm": true,
      "has_sfs": true,
      "id": 123,
      "keystone": {
        "keystone_federated_domain_id": "<string>",
        "password": "******",
        "state": "DELETED",
        "url": "<string>",
        "username": "<string>",
        "created_on": "2023-11-07T05:31:56Z",
        "id": 1
      },
      "keystone_id": 123,
      "keystone_name": "<string>",
      "metrics_database": {
        "host": "<string>",
        "id": 123,
        "port": 123,
        "username": "<string>"
      },
      "novnc_proxy_url": "http://example.com:6080/",
      "serial_proxy_url": "wss://example.com:6083/",
      "state": "ACTIVE",
      "vlan_physical_network": "<string>",
      "zone": "EMEA",
      "available_volume_types": [
        "standard",
        "ssd_hiiops",
        "cold"
      ],
      "available_volume_types_set": [
        "standard",
        "ssd_hiiops",
        "cold"
      ],
      "country": "LU",
      "ddos_endpoint": {
        "client_ids": [
          123
        ],
        "created_on": "2023-11-07T05:31:56Z",
        "id": 123,
        "region_id": 123,
        "service": "ai_service",
        "updated_at": "2023-11-07T05:31:56Z",
        "url": "<string>",
        "version": "<string>"
      },
      "ddos_endpoint_id": 3,
      "metrics_database_id": 1,
      "spice_proxy_url": "http://example.com:6082/",
      "task_id": null
    }
  ]
}

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

Response

200 - application/json

All Regions (json format).

count · integer · required

Number of objects

Required range: x >= 0

Example:

1

results · Region object · object[] · required

Objects

Show child attributes