Skip to content
NimbusNexus

Subnets

A subnet is an IP-address block inside a network. VMs and load balancers attach to subnets, not directly to networks — a network is just a container that one or more subnets live inside.

CIDR sizing

You pick the CIDR at creation time. Typical sizes:

Use caseCIDRUsable addresses
Single-VM testing/295
Small app (≤ 20 VMs)/2727
Medium app (≤ 100 VMs)/25123
Large app/24251
Project-wide VPC/1665,531

Every subnet reserves: the network address (first), the broadcast (last), the gateway (typically .1), and our DHCP server (typically .2). So a /24 subnet has 256 raw addresses but only 251 usable for VMs.

You can resize a subnet larger (/27 → /25) online without disruption. You cannot shrink a subnet without recreating it; existing VM IPs would have to be renumbered.

DHCP, SLAAC, and gateway behavior

  • IPv4 subnets use DHCP by default. Each VM gets a fixed address from the subnet's available range. You can pre-allocate specific IPs via the ports endpoint when you need a stable address (e.g. for an LB backend in DNS).
  • IPv6 subnets use SLAAC by default. Each VM auto-generates an address from the subnet's /64 prefix + its MAC address. DHCPv6 is available as an opt-in for environments that require deterministic addressing.
  • Gateway is set per subnet. For tenant subnets that need internet access, the gateway points at the router attached to the subnet; for the external network's auto-created subnet, the gateway points at our edge.

Multiple subnets per network

You can attach multiple subnets to one network. A VM connected to that network can be reachable from every subnet inside it (subject to security groups). This is useful for IPv4 + IPv6 dual-stack — one v4 subnet + one v6 subnet on the same network gives every VM both stacks.

What's next

  • Networks — the parent of subnets.
  • Routers — what to attach a tenant subnet to so it can reach the internet.
  • Virtual machines — VMs attach to subnets via ports.

Reference

GET/api/v1/subnet/

List Subnets

Lists subnets visible to the project.

Parameters

NameInRequiredDescription
admin_domainqueryno—
admin_projectqueryno—
network_idqueryno—
ip_versionqueryno—
cidrqueryno—
scope_current_projectqueryno—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet/

POST/api/v1/subnet/

Create Subnet

Creates a subnet on an existing virtual network.

Request body

JSON body required.

Responses

  • 201Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet/

GET/api/v1/subnet/artifacts

Subnet Artifacts

Returns the subnet's existing interfaces with networks and subnet pools that may be attached.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet/artifacts

GET/api/v1/subnet/{subnet_id}

Get Subnet

Returns the details of a single subnet by ID.

Parameters

NameInRequiredDescription
subnet_idpathyes—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet/{subnet_id}

PUT/api/v1/subnet/{subnet_id}

Update Subnet

Updates the mutable attributes of an existing subnet.

Parameters

NameInRequiredDescription
subnet_idpathyes—

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet/{subnet_id}

DELETE/api/v1/subnet/{subnet_id}

Delete Subnet

Deletes a subnet by ID.

Parameters

NameInRequiredDescription
subnet_idpathyes—

Responses

  • 204Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet/{subnet_id}

GET/api/v1/subnet_pool/

List Subnet Pools

Lists subnet pools visible to the project.

Parameters

NameInRequiredDescription
namequeryno—
is_defaultqueryno—
min_prefixlenqueryno—
max_prefixlenqueryno—
default_prefixlenqueryno—
sharedqueryno—
scope_current_projectqueryno—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet_pool/

POST/api/v1/subnet_pool/

Create Subnet Pool

Creates a subnet pool from which subnets can allocate CIDRs.

Request body

JSON body required.

Responses

  • 201Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet_pool/

GET/api/v1/subnet_pool/{subnet_pool_id}

Get Subnet Pool

Returns the details of a single subnet pool by ID.

Parameters

NameInRequiredDescription
subnet_pool_idpathyes—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet_pool/{subnet_pool_id}

PUT/api/v1/subnet_pool/{subnet_pool_id}

Update Subnet Pool

Updates the mutable attributes of an existing subnet pool.

Parameters

NameInRequiredDescription
subnet_pool_idpathyes—

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet_pool/{subnet_pool_id}

DELETE/api/v1/subnet_pool/{subnet_pool_id}

Delete Subnet Pool

Deletes a subnet pool by ID.

Parameters

NameInRequiredDescription
subnet_pool_idpathyes—

Responses

  • 204Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/subnet_pool/{subnet_pool_id}

Need to make a real call? Try these endpoints in the live Swagger UI →