Sign in

v32

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

Create subnet

post/cloud/v1/subnets/{project_id}/{region_id}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:1

Region ID

Request body

cidrstring ipvanynetwork required

CIDR

connect_to_network_routerboolean

True if the network's router should get a gateway in this subnet. Must be explicitly 'false' when gateway_ip is null.

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).

ip_version4 | 6
namestring required

Subnet name

network_idstring uuid4 required

Network ID

router_id_to_connectstring uuid4 nullable

ID of the router to connect to. Requires connect_to_network_router set to true. If not specified, attempts to find a router created during network creation.

tagsCreateTagsSerializer

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.

Example request

{
  "cidr": "192.168.10.0/24",
  "connect_to_network_router": true,
  "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": "my subnet",
  "network_id": "ee2402d0-f0cd-4503-9b75-69be1d11c5f1",
  "router_id_to_connect": "00000000-0000-4000-8000-000000000000"
}

Response

OK

tasksstring[] required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

  • GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.
idstring required

Example response

{
  "tasks": [
    "d478ae29-dedc-4869-82f0-96104425f565"
  ]
}