Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Networks

Get subnet

get/cloud/v1/subnets/{project_id}/{region_id}/{subnet_id}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:1

Region ID

subnet_idstring uuid4 required

Subnet ID

Example:b39792c3-3160-4356-912e-ba396c95cdcf

Subnet ID

Response

OK

available_ipsinteger nullable

Number of available ips in subnet

cidrstring ipvanynetwork required

CIDR

created_atstring date-time required

Datetime when the subnet was created

creator_task_idstring uuid4 nullable

Task that created this entity

dns_nameserversstring[] nullable

List IP addresses of a DNS resolver reachable from the network

enable_dhcpboolean required

True if DHCP should be enabled

gateway_ipstring ipvanyaddress nullable

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

has_routerboolean

Deprecated. Always returns false.

idstring uuid4 nullable

Subnet id.

ip_version4 | 6 required
namestring required

Subnet name

network_idstring uuid4 required

Network ID

project_idinteger required

Project ID

regionstring required

Region name

region_idinteger required

Region ID

task_idstring uuid4 nullable

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.

total_ipsinteger nullable

Total number of ips in subnet

updated_atstring date-time required

Datetime when the subnet was last updated

Example response

{
  "available_ips": 250,
  "cidr": "192.168.13.0/24",
  "created_at": "2019-06-13T13:58:12+0000",
  "creator_task_id": "5cc890da-d031-4a23-ac31-625edfa22812",
  "dns_nameservers": [
    "8.8.8.8",
    "8.8.4.4"
  ],
  "enable_dhcp": true,
  "gateway_ip": "192.168.13.1",
  "host_routes": [],
  "id": "b39792c3-3160-4356-912e-ba396c95cdcf",
  "name": "subnet_3",
  "network_id": "b30d0de7-bca2-4c83-9c57-9e645bd2cc92",
  "project_id": 1337,
  "region": "Luxembourg 1",
  "region_id": 7,
  "tags": [
    {
      "key": "my-tag",
      "read_only": false,
      "value": "my-tag-value"
    }
  ],
  "total_ips": 253,
  "updated_at": "2019-06-13T13:58:12+0000"
}