List regions with GPU cluster support

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

{
  "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
    }
  ]
}

GET

cloud

regions

List regions with GPU cluster support

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

{
  "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

results

Region object · object[]

required

Objects

Show child attributes

results.access_level

enum<string>

required

The access level of the region in string format.

Available options:

core,

edge

results.created_on

string<date-time>

required

A datetime object that is automatically generated when the region is created.

results.display_name

string

required

Unique constraint. Display name

results.endpoint_type

enum<string>

required

Endpoint type

Available options:

admin,

internal,

public

results.external_network_id

string

required

External network ID for Neutron

results.has_ai

boolean

required

Flag indicating if a region has AI capabilities available

results.has_ai_gpu

boolean

required

Flag indicating if a region has AI GPUs available

results.has_baremetal

boolean

required

Region has bare metal capability

results.has_basic_vm

boolean

required

Region has basic vm capability

results.has_ddos

boolean

required

Region has Advanced DDoS Protection

results.has_k8s

boolean

required

Flag indicating if a region is managed kubernetes available

results.has_kvm

boolean

required

Region has KVM virtualization capability

results.has_sfs

boolean

required

Region has SFS capability

results.id

integer

required

Region ID. It automatically is being generated when it is created

results.keystone

Keystone object · object

required

Keystone object in the JSON format

Show child attributes

results.keystone.keystone_federated_domain_id

string

required

ID of Keystone federated domain that was created during initialization

results.keystone.password

string<password> | null

required

'null' if the keystone doesn't have the password stored, and '******' (some password) otherwise

Example:

"******"

results.keystone.state

enum<string>

required

Keystone state

Available options:

DELETED,

INITIALIZATION_FAILED,

INITIALIZED,

NEW

results.keystone.url

string

required

Unique constraint. Keystone endpoint to use when interacting with Openstack API

results.keystone.username

string

required

Username for admin access

results.keystone.created_on

string<date-time> | null

Datetime object. It automatically is being generated when it is created

results.keystone.id

integer | null

An automatically generated Region ID when it is created.

Example:

1

results.keystone_id

integer

required

Foreign key for Keystone entity

results.keystone_name

string

required

Region name exactly as stated in keystone

results.metrics_database

Metrics database schema · object

required

Metrics database object in JSON format

Show child attributes

results.metrics_database.host

string

required

Metrics database host

results.metrics_database.id

integer

required

ID of the metrics database

results.metrics_database.port

integer

required

Metrics database port

results.metrics_database.username

string

required

Metrics database username

results.novnc_proxy_url

string | null

required

NoVNC console proxy URL

Example:

"http://example.com:6080/"

results.serial_proxy_url

string | null

required

Serial console proxy URL

Example:

"wss://example.com:6083/"

results.state

enum<string>

required

Region state

Available options:

ACTIVE,

DELETED,

DELETING,

DELETION_FAILED,

INACTIVE,

MAINTENANCE,

NEW

results.vlan_physical_network

string

required

Physical network name to create vlan networks

results.zone

enum<string> | null

required

Zone

Available options:

AMERICAS,

APAC,

EMEA,

RUSSIA_AND_CIS

Example:

"EMEA"

results.available_volume_types

string[] | null

List of available volume types, 'standard', 'ssd_hiiops', 'cold'].

Example:

["standard", "ssd_hiiops", "cold"]

results.available_volume_types_set

string[] | null

Set of available volume types, 'standard', 'ssd_hiiops', 'cold'].

Example:

["standard", "ssd_hiiops", "cold"]

results.country

string | null

Country

Example:

"LU"

results.ddos_endpoint

Endpoint object · object

deprecated

DDoS endpoint object

Show child attributes

results.ddos_endpoint.client_ids

integer[]

required

List of client IDs to access

results.ddos_endpoint.created_on

string<date-time>

required

The endpoint creation datetime timestamp

results.ddos_endpoint.id

integer

required

Endpoint ID

results.ddos_endpoint.region_id

integer

required

Region ID

results.ddos_endpoint.service

enum<string>

required

Endpoint service

Available options:

ai_service,

caas,

caas_for_inference,

dbaas,

faas,

inference_at_the_edge,

inference_box,

laas,

mkaas,

registry

results.ddos_endpoint.updated_at

string<date-time>

required

The endpoint last update datetime timestamp

results.ddos_endpoint.url

string

required

Endpoint URL

Maximum string length: 255

results.ddos_endpoint.version

string

required

Service version

Maximum string length: 32

results.ddos_endpoint_id

integer | null

deprecated

DDoS endpoint ID

Example:

3

results.metrics_database_id

integer | null

Foreign key to Metrics database entity

Example:

1

results.spice_proxy_url

string | null

Spice console proxy URL

Example:

"http://example.com:6082/"

results.task_id

string | null

deprecated

This field is deprecated and can be ignored

Example:

null

Resize bare metal GPU cluster Check bare metal GPU cluster quota

⌘I

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

FastEdge

WAAP

Streaming

Object Storage

Resellers

List regions with GPU cluster support

Authorizations

Response