Networks¶
Private virtual networks (VNets) that connect your compute resources. Each network can have one or more subnets. Servers are attached to networks at creation time.
Endpoints¶
| Method | Path | Description |
|---|---|---|
GET | /cloud/networks?project_id=<uuid> | List networks |
GET | /cloud/networks/{id}?project_id=<uuid> | Show a network |
GET | /cloud/subnets?project_id=<uuid> | List subnets |
GET | /cloud/subnets?project_id=<uuid>&network_id=<id> | List subnets for a network |
GET | /cloud/subnets/{id}?project_id=<uuid> | Show a subnet |
GET | /cloud/ports?project_id=<uuid> | List ports |
GET | /cloud/ports?project_id=<uuid>&network_id=<id> | List ports on a network |
GET | /cloud/ports?project_id=<uuid>&device_id=<id> | List ports for a server |
GET | /cloud/ports/{id}?project_id=<uuid> | Show a port |
List networks¶
Network response fields:
| Field | Description |
|---|---|
id | OpenStack network UUID |
name | Display name |
status | ACTIVE, DOWN, BUILD, ERROR |
admin_state_up | Whether the network is administratively enabled |
shared | Whether the network is shared across projects |
external | Whether the network is an external (provider) network |
subnets | Array of subnet UUIDs attached to this network |
mtu | MTU in bytes |
availability_zones | AZs where the network is available |
Subnets¶
Subnet response fields:
| Field | Description |
|---|---|
id | Subnet UUID |
name | Display name |
network_id | Parent network UUID |
cidr | CIDR block (e.g. 10.0.0.0/24) |
ip_version | 4 or 6 |
gateway_ip | Default gateway IP, or null |
enable_dhcp | Whether DHCP is enabled |
allocation_pools | Array of {start, end} IP ranges for DHCP |
dns_nameservers | DNS resolver IPs |
Ports¶
Ports are virtual NICs — one per server-network attachment. Use the device_id filter to list all ports attached to a specific server:
Port response fields include mac_address, fixed_ips, security_groups, and status.