Sign in

v32

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

Update subnet

patch/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

Request body

dns_nameserversstring[] nullable

List IP addresses of DNS servers to advertise via DHCP.

enable_dhcpboolean

True if DHCP should be enabled

gateway_ipstring ipvanyaddress nullable

Default GW IPv4 address to advertise in DHCP routes in this subnet. Omit this field to let the cloud backend allocate it automatically. Set to null if no gateway must be advertised by this subnet's DHCP (useful when attaching instances to multiple subnets in order to prevent default route conflicts).

namestring nullable

Name

tagsUpdateTagsSerializer

Example request

{
  "dns_nameservers": [
    "8.8.4.4",
    "1.1.1.1"
  ],
  "enable_dhcp": true,
  "gateway_ip": "192.168.10.1",
  "host_routes": [
    {
      "destination": "10.0.3.0/24",
      "nexthop": "10.0.0.13"
    }
  ],
  "name": "some_name"
}

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"
}