# GPU network ports

GPU Network Ports is a Region Networking page for system admins.
Open it from **Region Networking > GPU Network Ports**.

The GPU Network Ports page shows GPU network port records in a central
place.
It helps you review port identity, network addressing, hardware mapping,
and linked resources.

Use the GPU Network Ports page when you need to:

* Review GPU network port records across the region.
* Identify which VM uses a port.
* See which node and GPU network switch are linked to a port.
* Check addressing values such as port IP and peer IP.
* Review hardware values such as MAC address, PCI device ID,
  ENI device index, and rail ID.

## GPU network ports management

### Open the page

Use this page when you need to review GPU network port records.

1. In the left menu, open **Region Networking**.
2. Select **GPU Network Ports**.
3. Review the list of existing GPU network port records.

### Review the list

The current UI provides a list view with a column picker.

1. Open **Region Networking > GPU Network Ports**.
2. Review the default columns.
3. Use the column picker when you need optional audit fields.
4. Select a linked VM, node, or GPU network switch when you need more
   details about a related resource.

### Empty page behavior

When no records exist, the page shows an empty-state message.

1. Open **Region Networking > GPU Network Ports**.
2. Check whether the page shows that no GPU Network Ports are defined.

### Linked views

This page includes links to related resources.

1. Select the **Associated VM** link to open the related VM.
2. Select the **Node** link to open the related node.
3. Select the **GPU Network Switch** link to open the related GPU
   network switch.

The same GPU network port collection can also appear in a VM page under
its **Ports** tab.

## List view fields

The list shows these default columns:

* **Name**

  Shows the GPU network port record name. Use it to identify the port
  in the list.
* **Switch Port Name**

  Shows the port name on the GPU network switch side. Use it to match
  the record to the switch-facing port name.
* **Associated VM**

  Shows the name of the linked VM when one is resolved in the UI. Use
  it to identify which VM is associated with the port. This value is a
  link to the VM details page.
* **Node**

  Shows the linked node name when one is resolved in the UI. Use it to
  identify the node related to the port. This value is a link to the
  node details page.
* **Project**

  Shows the linked project name when one is resolved in the UI. Use it
  to identify the project that owns or contains the related resource.
* **GPU Network Switch**

  Shows the linked GPU network switch name when one is resolved in the
  UI. Use it to identify the switch related to the port. This value is
  a link to the GPU network switch page.
* **Port IP**

  Shows the IP address assigned to the GPU network port. Use it to
  review the port-side addressing value.
* **Peer IP**

  Shows the peer IP address for the port. Use it to review the paired
  addressing value.
* **MAC Address**

  Shows the MAC address saved for the GPU network port. Use it to
  verify the Layer 2 hardware address.
* **PCI Device ID**

  Shows the PCI device identifier saved for the port. Use it to relate
  the port record to the hardware device identifier.
* **ENI Device Index**

  Shows the ENI device index saved for the port. Use it to review the
  device index value associated with the port.
* **Rail ID**

  Shows the rail identifier saved for the port. Use it to review the
  rail value assigned to the port record.

You can also add these optional columns:

* **Created At**

  Shows when the record was created. Use it for audit and tracking
  work.
* **Updated At**

  Shows when the record was last updated. Use it for audit and
  tracking work.
* **ID**

  Shows the unique record ID. Use it when you need the exact identifier
  for a specific GPU network port record.

## What is not available on this page

The current collection view exposes no row or page actions.

* There is no verified add action on this page.
* There is no verified modify action on this page.
* There is no verified delete action on this page.
* There is no verified single-entity details component wired into the
  Region Networking service for GPU Network Ports.

## Recommended best practices

Use this page as a review and cross-reference tool. The UI exposes
linked names for the VM, node, and GPU network switch, so it works well
for tracing a port to related resources.

Check both addressing fields together. **Port IP** and **Peer IP** are
most useful when reviewed as a pair.

Use hardware identifiers during troubleshooting. **MAC Address**,
**PCI Device ID**, **ENI Device Index**, and **Rail ID** help you match
an entry in the UI to lower-level inventory or diagnostics.

Use optional audit columns when needed. **Created At**, **Updated At**,
and **ID** can help with record tracking.

Open related records from the links in the table. This is the fastest
way to move from a port record to its associated VM, node, or GPU
network switch.

## Troubleshooting

### The page does not appear in the menu

GPU Network Ports is part of the Region Networking menu for system
administrators.

* Confirm that you are using an account with system admin access.
* Open **Region Networking** and check the left navigation again.

### The list stays empty

An empty list can be normal when no records are defined.

* Check whether the page shows that no GPU Network Ports are defined.
* Refresh the page if you expect existing data.
* Verify the related backend data source for GPU network ports.

### A linked VM, node, or switch name is missing

The UI resolves related names from other models. A missing name can mean
that the related resource was not resolved in the current data set.

* Refresh the page and allow the data to load.
* Check whether the related VM, node, project, or GPU network switch
  exists and is accessible.
* Review the raw port fields that are still visible in the list.

### You need to create or edit a GPU network port

The current Region Networking page is read-only in the verified UI.

* Use this page to review records.
* Use the related linked resources for more investigation.
* Check whether port creation or update is handled in another workflow
  outside this page.