Tạo mạng

POST/v2.0/networks

Tạo một mạng. Bước tiếp theo là tạo subnet cho mạng vừa tạo.

info

Nguồn: create-network

Request

Tham số body

networkobjectbắt buộc

Object mạng.

mtuinteger

Maximum transmission unit. Tối thiểu 68 (IPv4) hoặc 1280 (IPv6).

namestring

Tên dễ đọc của mạng.

descriptionstring

Mô tả dễ đọc.

tenant_idstring

Alias cho ID project. Admin/advsvc có thể chỉ định project khác.

project_idstring

ID của project sở hữu. Admin/advsvc có thể chỉ định project khác.

Request mẫu

Dùng curl (tạo mạng riêng)

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 request

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

Response

Tham số response

networkobjectbắt buộc

Object mạng.

admin_state_upbooleanbắt buộc

Trạng thái quản trị: up (true) hoặc down (false).

availability_zone_hintsarraybắt buộc

Các availability zone ứng viên. VHI hiện tại trả về giá trị mặc định hoặc null.

availability_zonesarraybắt buộc

Các availability zone. VHI hiện tại trả về giá trị mặc định hoặc null.

created_atstringbắt buộc

Thời điểm tạo (ISO 8601).

dns_domainstringbắt buộc

DNS domain.

idstringbắt buộc

ID mạng.

ipv4_address_scopestringbắt buộc

ID address scope IPv4.

ipv6_address_scopestringbắt buộc

ID address scope IPv6.

l2_adjacencybooleanbắt buộc

Mạng có khả năng kết nối L2 xuyên suốt hay không.

mtuintegerbắt buộc

Maximum transmission unit.

namestringbắt buộc

Tên dễ đọc.

port_security_enabledbooleanbắt buộc

Trạng thái port security (mặc định cho port mới).

project_idstringbắt buộc

ID project sở hữu.

provider:network_typestringbắt buộc

Loại mạng provider (ví dụ flat, vlan, vxlan, gre).

provider:physical_networkstringbắt buộc

Mạng vật lý.

provider:segmentation_idintegerbắt buộc

ID segmentation của provider.

qos_policy_idstringbắt buộc

ID policy QoS liên kết.

revision_numberintegerbắt buộc

Revision number.

router:externalbooleanbắt buộc

Mạng có phải mạng external hay không.

segmentsarraybắt buộc

Danh sách object segment của provider.

sharedbooleanbắt buộc

Mạng có được chia sẻ giữa các tenant hay không.

statusstringbắt buộc

Trạng thái mạng: ACTIVE, DOWN, BUILD, ERROR.

subnetsarraybắt buộc

ID các subnet liên kết.

tenant_idstringbắt buộc

ID project sở hữu.

updated_atstringbắt buộc

Thời điểm cập nhật gần nhất (ISO 8601) hoặc null.

vlan_transparentbooleanbắt buộc

Chế độ VLAN transparent.

default_vnic_typestringbắt buộc

vnic_type mặc định cho các port trong mạng này.

descriptionstringbắt buộc

Mô tả dễ đọc.

is_defaultbooleanbắt buộc

Mạng có phải default pool hay không.

tagsarraybắt buộc

Danh sách tag của tài nguyên.

Response mẫu

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

Mã trạng thái

Thành công

Mã	Mô tả
201 - Created	Tài nguyên đã được tạo và sẵn sàng sử dụng.

Lỗi

Mã	Mô tả
400 - Bad Request	Nội dung request không hợp lệ.
401 - Unauthorized	Cần xác thực trước khi gửi request.

Request​

Tham số body​

Request mẫu​

Dùng curl (tạo mạng riêng)​

HTTP request​

Response​

Tham số response​

Response mẫu​

Mã trạng thái​

Thành công​

Lỗi​