Create Network

POST/v2.0/networks

Create a network. The next step is to create a subnet for the created network.

info

Source: create-network

Request

Body parameters

networkobjectrequired

A network object.

mtuinteger

Maximum transmission unit. Minimum 68 (IPv4) or 1280 (IPv6).

namestring

Human-readable name of the network.

descriptionstring

Human-readable description.

tenant_idstring

Alias for project ID. Admin/advsvc can specify others.

project_idstring

ID of the owning project. Admin/advsvc can specify other projects.

Example requests

cURL

curl -ks -H 'Content-Type: application/json' \
  -H 'X-Auth-Token: gAAAAA<...>' -d '
{
  "network": {
    "name": "privnet1"
  }
}' https://api.vietnix.cloud:9696/v2.0/networks

HTTP

POST https://api.vietnix.cloud:9696/v2.0/networks

Response

Response parameters

networkobjectrequired

A network object.

admin_state_upbooleanrequired

Administrative state: up (true) or down (false).

availability_zone_hintsarrayrequired

Availability zone candidates. Current VHI returns default or null.

availability_zonesarrayrequired

Availability zones. Current VHI returns default or null.

created_atstringrequired

Creation time (ISO 8601).

dns_domainstringrequired

DNS domain.

idstringrequired

Network ID.

ipv4_address_scopestringrequired

IPv4 address scope ID.

ipv6_address_scopestringrequired

IPv6 address scope ID.

l2_adjacencybooleanrequired

Whether L2 connectivity is available throughout the network.

mtuintegerrequired

Maximum transmission unit.

namestringrequired

Human-readable name.

port_security_enabledbooleanrequired

Port security status (default for new ports).

project_idstringrequired

Owning project ID.

provider:network_typestringrequired

Provider network type (e.g., flat, vlan, vxlan, gre).

provider:physical_networkstringrequired

Physical network.

provider:segmentation_idintegerrequired

Provider segmentation identifier.

qos_policy_idstringrequired

Associated QoS policy ID.

revision_numberintegerrequired

Revision number.

router:externalbooleanrequired

Whether network is external.

segmentsarrayrequired

List of provider segment objects.

sharedbooleanrequired

Whether network is shared across tenants.

statusstringrequired

Network status: ACTIVE, DOWN, BUILD, ERROR.

subnetsarrayrequired

Associated subnet IDs.

tenant_idstringrequired

Owning project ID.

updated_atstringrequired

Last update time (ISO 8601) or null.

vlan_transparentbooleanrequired

VLAN transparency mode.

default_vnic_typestringrequired

Default vnic_type for ports in this network.

descriptionstringrequired

Human-readable description.

is_defaultbooleanrequired

Whether network is default pool.

tagsarrayrequired

List of resource tags.

Sample responses

Response body

{
    "network": {
        "id": "170546a1-a70a-40af-93e2-9261c7c05b77",
        "name": "privnet1",
        "tenant_id": "f33507157a634f1cac71e06a70fb558e",
        "admin_state_up": true,
        "mtu": 1413,
        "default_vnic_type": null,
        "status": "ACTIVE",
        "subnets": [],
        "shared": false,
        "project_id": "f33507157a634f1cac71e06a70fb558e",
        "port_security_enabled": true,
        "qos_policy_id": "dfc42ced-02c8-4b1f-bbe6-14cc014f259d",
        "router:external": false,
        "provider:network_type": "vxlan",
        "is_default": false,
        "availability_zone_hints": [],
        "availability_zones": [],
        "ipv4_address_scope": null,
        "ipv6_address_scope": null,
        "description": "",
        "rbac_policies": [],
        "tags": [],
        "created_at": "2025-09-23T06:42:18Z",
        "updated_at": "2025-09-23T06:42:18Z",
        "revision_number": 1
    }
}

Status codes

Success

Status Code	Description
201 - Created	Resource was created and is ready to use.

Error

Status Code	Description
400 - Bad Request	Some content in the request was invalid.
401 - Unauthorized	User must authenticate before making a request.