List networks with subnets details

curl --request GET \
  --url https://api.gcore.com/cloud/v1/availablenetworks/{project_id}/{region_id} \
  --header 'Authorization: <api-key>'

{
  "count": 1,
  "results": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "creator_task_id": "fd50fdd1-0482-4c9b-b847-fc9924665af6",
      "default": true,
      "external": true,
      "id": "<string>",
      "mtu": 123,
      "name": "<string>",
      "port_security_enabled": true,
      "project_id": 1337,
      "region": "<string>",
      "region_id": 123,
      "segmentation_id": 9,
      "shared": true,
      "subnets": [
        {
          "cidr": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "enable_dhcp": true,
          "ip_version": 4,
          "name": "<string>",
          "network_id": "<string>",
          "project_id": 123,
          "region": "<string>",
          "region_id": 123,
          "tags": [
            {
              "key": "<string>",
              "read_only": true,
              "value": "<string>"
            }
          ],
          "updated_at": "2023-11-07T05:31:56Z",
          "available_ips": 250,
          "creator_task_id": "5cc890da-d031-4a23-ac31-625edfa22812",
          "dns_nameservers": [
            "8.8.8.8",
            "8.8.4.4"
          ],
          "gateway_ip": "192.168.13.1",
          "has_router": false,
          "host_routes": [],
          "id": "b39792c3-3160-4356-912e-ba396c95cdcf",
          "task_id": null,
          "total_ips": 253
        }
      ],
      "tags": [
        {
          "key": "<string>",
          "read_only": true,
          "value": "<string>"
        }
      ],
      "task_id": null,
      "type": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}

GET

cloud

availablenetworks

{project_id}

{region_id}

List networks with subnets details

curl --request GET \
  --url https://api.gcore.com/cloud/v1/availablenetworks/{project_id}/{region_id} \
  --header 'Authorization: <api-key>'

{
  "count": 1,
  "results": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "creator_task_id": "fd50fdd1-0482-4c9b-b847-fc9924665af6",
      "default": true,
      "external": true,
      "id": "<string>",
      "mtu": 123,
      "name": "<string>",
      "port_security_enabled": true,
      "project_id": 1337,
      "region": "<string>",
      "region_id": 123,
      "segmentation_id": 9,
      "shared": true,
      "subnets": [
        {
          "cidr": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "enable_dhcp": true,
          "ip_version": 4,
          "name": "<string>",
          "network_id": "<string>",
          "project_id": 123,
          "region": "<string>",
          "region_id": 123,
          "tags": [
            {
              "key": "<string>",
              "read_only": true,
              "value": "<string>"
            }
          ],
          "updated_at": "2023-11-07T05:31:56Z",
          "available_ips": 250,
          "creator_task_id": "5cc890da-d031-4a23-ac31-625edfa22812",
          "dns_nameservers": [
            "8.8.8.8",
            "8.8.4.4"
          ],
          "gateway_ip": "192.168.13.1",
          "has_router": false,
          "host_routes": [],
          "id": "b39792c3-3160-4356-912e-ba396c95cdcf",
          "task_id": null,
          "total_ips": 253
        }
      ],
      "tags": [
        {
          "key": "<string>",
          "read_only": true,
          "value": "<string>"
        }
      ],
      "task_id": null,
      "type": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}

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

project_id

integer

required

Project ID

region_id

integer

required

Region ID

Query Parameters

limit

integer

default:1000

Optional. Limit the number of returned items

Required range: x <= 1000

name

string

Filter networks by name

Maximum string length: 61

network_id

string<uuid4>

Optional. Can be used to only show subnets of the specific network

network_type

enum<string>

Optional. Filter network by network type (vlan or vxlan)

Available options:

vlan,

vxlan

offset

integer

default:0

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

Required range: x >= 0

order_by

enum<string>

Ordering networks list result by name, created_at fields of the network and directions (created_at.desc).

Available options:

created_at.asc,

created_at.desc,

name.asc,

name.desc

shared

boolean

Optional. Can be used to only show networks with shared state

tag_key

string[]

Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2

Tag key. The maximum size for a key is 255 characters.

Required string length: 1 - 255

tag_key_value

string

Optional. Filter by tag key-value pairs.

Response

200 - application/json

count

integer

required

Number of objects

Required range: x >= 0

results

NetworkSubnetworkSerializer · object[]

required

Objects

Show child attributes

results.created_at

string<date-time>

required

Datetime when the network was created

results.creator_task_id

string<uuid4> | null

required

Task that created this entity

Example:

"fd50fdd1-0482-4c9b-b847-fc9924665af6"

results.default

boolean | null

required

True if network has is_default attribute

Example:

true

results.external

boolean

required

True if the network router:external attribute

results.id

string<uuid4>

required

Network ID

results.mtu

integer

required

MTU (maximum transmission unit). Default value is 1450

results.name

string

required

Network name

results.port_security_enabled

boolean

required

Indicates port_security_enabled status of all newly created in the network ports.

results.project_id

integer | null

required

Project ID

Example:

1337

results.region

string

required

Region name

results.region_id

integer

required

Region ID

results.segmentation_id

integer | null

required

Id of network segment

Example:

9

results.shared

boolean

required

True when the network is shared with your project by external owner

results.subnets

SubnetSerializer · object[]

required

List of subnets associated with the network

Show child attributes

results.subnets.cidr

string<ipvanynetwork>

required

CIDR

results.subnets.created_at

string<date-time>

required

Datetime when the subnet was created

results.subnets.enable_dhcp

boolean

required

True if DHCP should be enabled

results.subnets.ip_version

enum<integer>

required

IP version

Available options:

4,

6

results.subnets.name

string

required

Subnet name

results.subnets.network_id

string<uuid4>

required

Network ID

results.subnets.project_id

integer

required

Project ID

results.subnets.region

string

required

Region name

results.subnets.region_id

integer

required

Region ID

results.subnets.tags

TagSerializer · object[]

required

List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.

Show child attributes

results.subnets.tags.key

string

required

Tag key. The maximum size for a key is 255 characters.

results.subnets.tags.read_only

boolean

required

If true, the tag is read-only and cannot be modified by the user

results.subnets.tags.value

string

required

Tag value. The maximum size for a value is 255 characters.

results.subnets.updated_at

string<date-time>

required

Datetime when the subnet was last updated

results.subnets.available_ips

integer | null

Number of available ips in subnet

Example:

250

results.subnets.creator_task_id

string<uuid4> | null

Task that created this entity

Example:

"5cc890da-d031-4a23-ac31-625edfa22812"

results.subnets.dns_nameservers

string<ipvanyaddress>[] | null

List IP addresses of a DNS resolver reachable from the network

Example:

["8.8.8.8", "8.8.4.4"]

results.subnets.gateway_ip

string<ipvanyaddress> | null

Default GW IPv4 address, advertised in DHCP routes of this subnet. If null, no gateway is advertised by this subnet.

Example:

"192.168.13.1"

results.subnets.has_router

boolean

default:false

deprecated

Deprecated. Always returns false.

results.subnets.host_routes

RouteOutSerializer · object[] | null

List of custom static routes to advertise via DHCP.

Show child attributes

results.subnets.host_routes.destination

string<ipvanynetwork>

required

CIDR of destination IPv4 subnet.

results.subnets.host_routes.nexthop

string<ipvanyaddress>

required

IPv4 address to forward traffic to if it's destination IP matches 'destination' CIDR.

Example:

[]

results.subnets.id

string<uuid4> | null

Subnet id.

Example:

"b39792c3-3160-4356-912e-ba396c95cdcf"

results.subnets.task_id

string<uuid4> | null

The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.

Example:

null

results.subnets.total_ips

integer | null

Total number of ips in subnet

Example:

253

results.tags

TagSerializer · object[]

required

Show child attributes

results.tags.key

string

required

Tag key. The maximum size for a key is 255 characters.

results.tags.read_only

boolean

required

If true, the tag is read-only and cannot be modified by the user

results.tags.value

string

required

Tag value. The maximum size for a value is 255 characters.

results.task_id

string<uuid4> | null

required

The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.

Example:

null

results.type

string

required

Network type (vlan, vxlan)

results.updated_at

string<date-time>

required

Datetime when the network was last updated

Update PostgreSQL service status List networks

⌘I

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

FastEdge

WAAP

Streaming

Object Storage

Resellers

List networks with subnets details

Authorizations

Path Parameters

Query Parameters

Response