---
title: "List regions with GPU cluster support"
method: GET
path: "/cloud/v1/ai/regions"
tags: ["GPU Bare Metal"]
---

# List regions with GPU cluster support

`GET /cloud/v1/ai/regions`

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

## Response `200`

All Regions (json format).

- RegionSerializerAiCollectionSerializer
  - `count` integer, required — Number of objects
  - `results` RegionSerializerAi[], required — Objects
    - `access_level` 'core' | 'edge', required
    - `available_volume_types` string[], nullable — List of available volume types, 'standard', 'ssd_hiiops', 'cold'].
    - `country` string, required — Two-letter country code, ISO 3166-1 alpha-2
    - `created_on` string, date-time, required — A datetime object that is automatically generated when the region is created.
    - `ddos_endpoint` ServiceEndpointSerializer
      - `client_ids` integer[], required — List of client IDs to access
      - `created_on` string, date-time, required — The endpoint creation datetime timestamp
      - `id` integer, required — Endpoint ID
      - `region_id` integer, required — Region ID
      - `service` 'ai_service' | 'caas' | 'caas_for_inference' | 'dbaas' | 'faas' | 'inference_at_the_edge' | 'inference_box' | 'laas' | 'mkaas' | 'registry', required
      - `updated_at` string, date-time, required — The endpoint last update datetime timestamp
      - `url` string, required — Endpoint URL
      - `version` string, required — Service version
    - `ddos_endpoint_id` integer, nullable — DDoS endpoint ID
    - `display_name` string, required — Unique constraint. Display name
    - `endpoint_type` 'admin' | 'internal' | 'public', required
    - `external_network_id` string, required — External network ID for Neutron
    - `has_ai` boolean, required — Flag indicating if a region has AI capabilities available
    - `has_ai_gpu` boolean, required — Flag indicating if a region has AI GPUs available
    - `has_baremetal` boolean, required — Region has bare metal capability
    - `has_basic_vm` boolean, required — Region has basic vm capability
    - `has_ddos` boolean, required — Region has Advanced DDoS Protection
    - `has_k8s` boolean, required — Flag indicating if a region is managed kubernetes available
    - `has_kvm` boolean, required — Region has KVM virtualization capability
    - `has_sfs` boolean, required — Region has SFS capability
    - `id` integer, required — Region ID. It automatically is being generated when it is created
    - `keystone` KeystoneSerializerAi, required
      - `created_on` string, date-time, nullable — Datetime object. It automatically is being generated when it is created
      - `id` integer, nullable — An automatically generated Region ID when it is created.
      - `keystone_federated_domain_id` string, required — ID of Keystone federated domain that was created during initialization
      - `password` string, password, nullable, required — 'null' if the keystone doesn't have the password stored, and '******' (some password) otherwise
      - `state` 'DELETED' | 'INITIALIZATION_FAILED' | 'INITIALIZED' | 'NEW', required
      - `url` string, required — Unique constraint. Keystone endpoint to use when interacting with Openstack API
      - `username` string, required — Username for admin access
    - `keystone_id` integer, required — Foreign key for Keystone entity
    - `keystone_name` string, required — Region name exactly as stated in keystone
    - `metrics_database` MetricsDatabaseSerializer, required
      - `host` string, required — Metrics database host
      - `id` integer, required — ID of the metrics database
      - `password` string, password, required — Metrics database password
      - `port` integer, required — Metrics database port
      - `username` string, required — Metrics database username
    - `metrics_database_id` integer, nullable — Foreign key to Metrics database entity
    - `novnc_proxy_url` string, nullable, required — NoVNC console proxy URL
    - `serial_proxy_url` string, nullable, required — Serial console proxy URL
    - `slug` string, required — Short, human-readable region identifier (e.g. luxembourg-2, santa-clara-1).
    - `spice_proxy_url` string, nullable — Spice console proxy URL
    - `state` 'ACTIVE' | 'DELETED' | 'DELETING' | 'DELETION_FAILED' | 'INACTIVE' | 'MAINTENANCE' | 'NEW', required
    - `task_id` string, nullable — This field is deprecated and can be ignored
    - `vlan_physical_network` string, required — Physical network name to create vlan networks
    - `zone` 'AMERICAS' | 'APAC' | 'EMEA' | 'RUSSIA_AND_CIS', required

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)
