Xem chi tiết subnet

GET/v2.0/subnets/{subnet_id}

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

info

Nguồn: show-subnet-details

Request

Tham số path

subnet_idstringbắt buộc

ID của subnet.

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/subnets/d3f93e1c-f59d-40f8-a46c-ea6285f3a069

HTTP request

GET https://api.vietnix.cloud:9696/v2.0/subnets/{subnet_id}

Response

Tham số

subnetobjectbắt buộc

Object subnet.

idstringbắt buộc

ID của subnet.

tenant_idstringbắt buộc

ID của project.

project_idstringbắt buộc

ID của project.

namestringbắt buộc

Tên dễ đọc của tài nguyên.

enable_dhcpbooleanbắt buộc

DHCP có được bật cho subnet hay không.

network_idstringbắt buộc

ID của mạng mà subnet thuộc về.

dns_nameserversarraybắt buộc

Danh sách DNS name server liên kết với subnet.

allocation_poolsarraybắt buộc

Các allocation pool với địa chỉ IP bắt đầu và kết thúc cho subnet này.

host_routesarraybắt buộc

Các route bổ sung cho subnet. Mỗi phần tử có destination và nexthop.

ip_versionintegerbắt buộc

Phiên bản giao thức IP. Giá trị là 4 hoặc 6.

gateway_ipstringbắt buộc

IP gateway của subnet này, hoặc null nếu không có gateway.

cidrstringbắt buộc

CIDR của subnet.

created_atstringbắt buộc

Ngày giờ tạo tài nguyên (ISO 8601).

descriptionstringbắt buộc

Mô tả dễ đọc cho subnet.

ipv6_address_modestringbắt buộc

Chế độ gán địa chỉ IPv6: slaac, dhcpv6-stateful, dhcpv6-stateless, hoặc null.

ipv6_ra_modestringbắt buộc

Chế độ router advertisement IPv6: slaac, dhcpv6-stateful, dhcpv6-stateless, hoặc null.

revision_numberintegerbắt buộc

Revision number của subnet.

segment_idstringbắt buộc

ID của network segment mà subnet liên kết.

subnetpool_idstringbắt buộc

ID của subnet pool liên kết với subnet.

service_typesarraybắt buộc

Các service type liên kết với subnet.

updated_atstringbắt buộc

Ngày giờ cập nhật tài nguyên (ISO 8601) hoặc null.

tagsarraybắt buộc

Danh sách tag trên tài nguyên.

dns_publish_fixed_ipbooleanbắt buộc

Có publish bản ghi DNS cho các IP thuộc subnet này hay không.

Response mẫu

Response body

{
    "subnet": {
        "id": "d3f93e1c-f59d-40f8-a46c-ea6285f3a069",
        "name": "",
        "tenant_id": "f33507157a634f1cac71e06a70fb558e",
        "network_id": "170546a1-a70a-40af-93e2-9261c7c05b77",
        "ip_version": 4,
        "subnetpool_id": null,
        "enable_dhcp": true,
        "ipv6_ra_mode": null,
        "ipv6_address_mode": null,
        "gateway_ip": "192.168.10.1",
        "cidr": "192.168.10.0/24",
        "allocation_pools": [
            {
                "start": "192.168.10.2",
                "end": "192.168.10.254"
            }
        ],
        "host_routes": [],
        "dns_nameservers": [
            "10.30.0.27",
            "10.30.0.28"
        ],
        "description": "",
        "service_types": [],
        "tags": [],
        "created_at": "2025-09-23T07:00:56Z",
        "updated_at": "2025-09-23T07:00:56Z",
        "revision_number": 0,
        "project_id": "f33507157a634f1cac71e06a70fb558e"
    }
}

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.