G-g-core
Regions

Get region

Changed on
get/cloud/v1/regions/{region_id}

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/cloud/v1/regions/{region_id}
  • Auth
    HTTP apikey

Path parameters

region_idinteger required

Region ID

Example:11

Query parameters

show_volume_typesboolean

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

Response

OK

access_level'core' | 'edge' required
available_volume_typesstring[] nullable required

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

countrystring required

Two-letter country code, ISO 3166-1 alpha-2

created_atstring date-time required

Region creation date and time

created_onstring date-time required

This field is deprecated. Use created_at instead.

ddos_endpoint_idinteger nullable

DDoS endpoint ID

display_namestring required

Human-readable region name

endpoint_type'admin' | 'internal' | 'public' required
external_network_idstring nullable required

External network ID

file_share_typesFileShareStorageType[] nullable required

List of available file share types

has_aiboolean required

Region has AI capability

has_ai_gpuboolean required

Region has AI GPU capability

has_baremetalboolean required

Region has bare metal capability

has_basic_vmboolean required

Region has basic vm capability

has_dbaasboolean required

Region has DBAAS service

has_ddosboolean required

Region has Advanced DDoS Protection capability

has_k8sboolean required

Region has managed kubernetes capability

has_kvmboolean required

Region supports virtual machine instances

has_sfsboolean required

Region has SFS capability

idinteger required

Region ID

keystone_idinteger required

ID of the identity service record

keystone_namestring required

Technical region name

metrics_database_idinteger nullable required

Foreign key to Metrics database entity

slugstring required

Short, human-readable region identifier (e.g. luxembourg-2, santa-clara-1).

state'ACTIVE' | 'DELETED' | 'DELETING' | 'DELETION_FAILED' | 'INACTIVE' | 'MAINTENANCE' | 'NEW' required
task_idstring nullable required

This field is deprecated and can be ignored

vlan_physical_networkstring required

Physical network name to create vlan networks

zone'AMERICAS' | 'APAC' | 'EMEA' | 'RUSSIA_AND_CIS' required

Example response

{
  "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",
  "external_network_id": "c843c3e6-ef4d-4b92-8db2-e16ac05c5650",
  "file_share_types": [
    "standard",
    "vast",
    "ddn"
  ],
  "has_ai": true,
  "has_ai_gpu": true,
  "has_ddos": true,
  "has_k8s": true,
  "has_kvm": true,
  "id": 1,
  "keystone_id": 1,
  "keystone_name": "ED-9",
  "metrics_database_id": 1,
  "slug": "luxembourg-1",
  "vlan_physical_network": "br-ex"
}

Changes

  • a2b772345f3aRevision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 796429501557Revision changes
    • warning

      added the new ddn enum value to the // response property for the response status