GET
/
cloud
/
v1
/
regions
/
{region_id}
Python
from gcore import Gcore

client = Gcore(
    api_key="My API Key",
)
region = client.cloud.regions.get(
    region_id=11,
)
print(region.id)
{
  "access_level": "core",
  "available_volume_types": [
    "standard",
    "ssd_hiiops",
    "cold"
  ],
  "coordinates": {
    "latitude": 41.40338,
    "longitude": 2.17403
  },
  "country": "LU",
  "created_at": "2019-12-31T23:59:59Z",
  "created_on": "2019-12-31T23:59:59Z",
  "ddos_endpoint_id": 3,
  "display_name": "Luxembourg",
  "endpoint_type": "public",
  "external_network_id": "c843c3e6-ef4d-4b92-8db2-e16ac05c5650",
  "file_share_types": [
    "standard",
    "vast"
  ],
  "has_ai": true,
  "has_ai_gpu": true,
  "has_baremetal": false,
  "has_basic_vm": false,
  "has_dbaas": false,
  "has_ddos": true,
  "has_k8s": true,
  "has_kvm": true,
  "has_sfs": false,
  "id": 1,
  "keystone_id": 1,
  "keystone_name": "ED-9",
  "metrics_database_id": 1,
  "state": "NEW",
  "task_id": null,
  "vlan_physical_network": "br-ex",
  "zone": "EMEA"
}

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

​
region_id
integer
required

Region ID

Examples:

11

Query Parameters

​
show_volume_types
boolean
default:false

If true, null available_volume_type is replaced with a list of available volume types.

Examples:

false

Response

200 - application/json

OK

​
access_level
enum<string>
required

The access level of the region.

Available options:
core,
edge
​
available_volume_types
string[] | null
required

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

Examples:
["standard", "ssd_hiiops", "cold"]
​
coordinates
object | null
required

Coordinates of the region

Examples:
{
  "latitude": 41.40338,
  "longitude": 2.17403
}
​
country
string | null
required

Country

Examples:

"LU"

​
created_at
string<date-time>
required

Region creation date and time

Examples:

"2019-12-31T23:59:59Z"

​
created_on
string<date-time>
required
deprecated

This field is deprecated. Use created_at instead.

Examples:

"2019-12-31T23:59:59Z"

​
display_name
string
required

Human-readable region name

Examples:

"Luxembourg"

​
endpoint_type
enum<string>
required

Endpoint type

Available options:
admin,
internal,
public
​
external_network_id
string | null
required

External network ID for Neutron

Examples:

"c843c3e6-ef4d-4b92-8db2-e16ac05c5650"

​
file_share_types
enum<string>[] | null
required

List of available file share types

Examples:
["standard", "vast"]
​
has_ai
boolean
required

Region has AI capability

Examples:

true

​
has_ai_gpu
boolean
required

Region has AI GPU capability

Examples:

true

​
has_baremetal
boolean
required

Region has bare metal capability

Examples:

false

​
has_basic_vm
boolean
required

Region has basic vm capability

Examples:

false

​
has_dbaas
boolean
required

Region has DBAAS service

Examples:

false

​
has_ddos
boolean
required

Region has Advanced DDoS Protection capability

Examples:

true

false

​
has_k8s
boolean
required

Region has managed kubernetes capability

Examples:

true

​
has_kvm
boolean
required

Region has KVM virtualization capability

Examples:

true

​
has_sfs
boolean
required

Region has SFS capability

Examples:

false

​
id
integer
required

Region ID

Examples:

1

​
keystone_id
integer
required

Foreign key to Keystone entity

Examples:

1

​
keystone_name
string
required

Technical region name

Examples:

"ED-9"

​
metrics_database_id
integer | null
required

Foreign key to Metrics database entity

Examples:

1

​
state
enum<string>
required

Region state

Available options:
ACTIVE,
DELETED,
DELETING,
DELETION_FAILED,
INACTIVE,
MAINTENANCE,
NEW
​
task_id
string | null
required
deprecated

This field is deprecated and can be ignored

Examples:

null

​
vlan_physical_network
string
required

Physical network name to create vlan networks

Examples:

"br-ex"

​
zone
enum<string> | null
required

Geographical zone

Available options:
AMERICAS,
APAC,
EMEA,
RUSSIA_AND_CIS
Examples:

"EMEA"

​
ddos_endpoint_id
integer | null
deprecated

DDoS endpoint ID

Examples:

3