Chuyển tới nội dung chính

Xem chi tiết network port

GET/v2.0/ports/{port_id}

Xem chi tiết một network port theo ID.

Theo policy mặc định, bạn có thể xem các port thuộc project của mình (trừ khi bạn có quyền admin).

Request​

Tham số path​

port_idstringbắt buộc

ID của port cần xem.

Tham số query​

fieldsstring

Giới hạn các thuộc tính được trả về. Có thể lặp lại (ví dụ ?fields=id&fields=name). Nếu bỏ qua, tất cả thuộc tính được policy cho phép sẽ được trả về.

Request mẫu​

curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://<node_IP_addr>:9696/v2.0/ports/2d74fa0c-3e43-4fd9-a234-cbb4996cc684

Response​

Tham số response​

Nếu thành công, API trả về một object port duy nhất với các thuộc tính bên dưới.

portobjectbắt buộc

Object bao ngoài của port.

idstringbắt buộc

ID của port.

namestringbắt buộc

Tên dễ đọc của port.

network_idstringbắt buộc

ID của mạng gắn với port.

tenant_idstringbắt buộc

ID project (field legacy).

project_idstringbắt buộc

ID project sở hữu.

mac_addressstringbắt buộc

Địa chỉ MAC của port (có thể bị ghi đè với direct-physical).

admin_state_upbooleanbắt buộc

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

statusstringbắt buộc

Trạng thái port: ACTIVE, DOWN, BUILD hoặc ERROR.

device_idstringbắt buộc

ID của thiết bị được gắn (server, router, v.v.).

device_ownerstringbắt buộc

Loại entity sử dụng port (ví dụ compute:nova).

fixed_ipsarraybắt buộc

Danh sách {subnet_id, ip_address} được gán cho port.

port_security_enabledbooleanbắt buộc

Port security có được bật hay không.

qos_policy_idstringbắt buộc

QoS policy áp dụng trực tiếp lên port (hoặc null).

qos_network_policy_idstringbắt buộc

QoS policy của mạng cha (hoặc null).

security_groupsarraybắt buộc

ID các security group được áp dụng.

binding:vnic_typestringbắt buộc

Loại vNIC: normal, macvtap, direct, baremetal, direct-physical, virtio-forwarder, smart-nic, remote-managed.

binding:profileobjectbắt buộc

Thông tin VIF đặc thù backend (rỗng {} nếu không có).

binding:host_idstringbắt buộc

ID host nơi port nằm.

binding:vif_typestringbắt buộc

Loại mechanism driver hoặc unbound / binding_failed.

binding:vif_detailsobjectbắt buộc

Thông tin bổ sung (ví dụ port_filter, ovs_hybrid_plug).

allowed_address_pairsarraybắt buộc

Allowed address pair (ip_address, mac_address tuỳ chọn).

extra_dhcp_optsarraybắt buộc

Các object DHCP option bổ sung.

descriptionstringbắt buộc

Mô tả.

resource_requestobject

Tài nguyên và trait Placement được yêu cầu.

tagsarraybắt buộc

Danh sách tag.

created_atstringbắt buộc

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

updated_atstringbắt buộc

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

revision_numberintegerbắt buộc

Revision number.

ip_allocationstringbắt buộc

Chế độ cấp phát: immediate, deferred hoặc none (nếu có).

dns_assignmentobjectbắt buộc

Gán DNS nội bộ (hostname, ip_address, fqdn).

dns_domainstringbắt buộc

DNS domain.

dns_namestringbắt buộc

DNS name.

hintsobjectbắt buộc

Hint điều khiển OVS Userspace Tx packet steering (chỉ admin) nếu có.

numa_affinity_policystring

Policy NUMA affinity: none, required, preferred hoặc legacy.

propagate_uplink_statusbooleanbắt buộc

Cờ lan truyền trạng thái uplink.

mac_learning_enabledboolean

MAC learning có được bật hay không.

port_trusted_vifbooleanbắt buộc

Trạng thái trusted VIF (cũng có trong binding:profile).

data_plane_statusstringbắt buộc

Trạng thái data plane bên dưới nếu được báo cáo.

Mã trạng thái​

Thành công​

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

Lỗi​

MãMô tả
401 - UnauthorizedCần xác thực trước khi gửi request.
404 - Not FoundKhông tìm thấy port được yêu cầu.

Response mẫu​

Response body
{
    "port": {
        "id": "2d74fa0c-3e43-4fd9-a234-cbb4996cc684",
        "name": "private-port",
        "network_id": "f858b8d1-e66b-4a48-bc2e-3f16483b1b58",
        "tenant_id": "f33507157a634f1cac71e06a70fb558e",
        "mac_address": "fa:16:3e:7f:ae:b2",
        "admin_state_up": true,
        "status": "DOWN",
        "device_id": "",
        "device_owner": "",
        "fixed_ips": [
            {
                "subnet_id": "adffaac8-2261-43f7-9e4f-6044230f65f1",
                "ip_address": "192.168.1.12"
            }
        ],
        "allowed_address_pairs": [],
        "extra_dhcp_opts": [],
        "security_groups": [
            "e1c1aa83-7302-4493-9cf4-43c2407e8074"
        ],
        "description": "",
        "binding:vnic_type": "normal",
        "port_security_enabled": true,
        "qos_policy_id": null,
        "qos_network_policy_id": "dfc42ced-02c8-4b1f-bbe6-14cc014f259d",
        "tags": [],
        "created_at": "2025-10-08T08:05:12Z",
        "updated_at": "2025-10-08T08:05:12Z",
        "revision_number": 1,
        "project_id": "f33507157a634f1cac71e06a70fb558e"
    }
}

Xem thêm​