Xem chi tiết mạng

GET/v2.0/networks/{network_id}

Xem chi tiết mạng theo ID được chỉ định.

info

Nguồn: show-network-details

Request

Tham số path

network_idstringbắt buộc

ID của mạng.

Tham số query

fieldsstring

Các field cần trả về. Có thể chỉ định nhiều lần, ví dụ fields=id&fields=name. Nếu bỏ trống, tất cả thuộc tính được policy cho phép sẽ được trả về.

Request mẫu

Dùng curl

curl -ks -H 'Content-Type: application/json' \
  -H 'X-Auth-Token: gAAAAA<...>' \
  https://api.vietnix.cloud:9696/v2.0/networks/170546a1-a70a-40af-93e2-9261c7c05b77

HTTP request

GET https://api.vietnix.cloud:9696/v2.0/networks/{network_id}

Response

Tham số

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. Tối thiểu 68 (IPv4) hoặc 1280 (IPv6).

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": [
            "d3f93e1c-f59d-40f8-a46c-ea6285f3a069"
        ],
        "shared": false,
        "availability_zone_hints": [],
        "availability_zones": [
            "nova"
        ],
        "ipv4_address_scope": null,
        "ipv6_address_scope": null,
        "router:external": false,
        "description": "",
        "port_security_enabled": true,
        "rbac_policies": [],
        "qos_policy_id": "dfc42ced-02c8-4b1f-bbe6-14cc014f259d",
        "tags": [],
        "created_at": "2025-09-23T06:42:18Z",
        "updated_at": "2025-09-23T07:00:56Z",
        "revision_number": 2,
        "project_id": "f33507157a634f1cac71e06a70fb558e",
        "provider:network_type": "vxlan"
    }
}

Mã trạng thái

Thành công

Mã	Mô tả
200 - OK	Request thành công.

Lỗi

Mã	Mô tả
401 - Unauthorized	Cần xác thực trước khi gửi request.
404 - Not Found	Không tìm thấy tài nguyên.