G-g-core
Regions

List regions

Changed on
get/cloud/v1/regions

Request

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

Query parameters

display_namestring

Filter regions by display name. Case-insensitive exact match.

Example:Luxembourg
limitinteger

Limit the number of returned regions. Falls back to default of 100 if not specified. Limited by max limit value of 1000

Example:100
offsetinteger

Offset value is used to exclude the first set of records from the result

order_by'created_at.asc' | 'created_at.desc' | 'display_name.asc' | 'display_name.desc'

Order by field and direction.

product'containers' | 'inference'

If defined then return only regions that support given product.

show_volume_typesboolean

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

Response

OK

countinteger required

Number of objects

Example response

{
  "count": 1,
  "results": [
    {
      "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