openstack Verified current stable Not installed? Networking

Openstack / List All Ports

List All Ports

List all ports in the OpenStack project.

$
Terminal
openstack port list

When To Use

During routine network audit to check port availability across instances.

Pro Tip

Use `--format json` for a machine-readable format to pipe into scripts.

Anatomy of Output

Understanding the result

+--------------------------------------+------+------------------------------------+-------------------+-----------+------------------------------------+ Output Header

Column headers for port properties.

| ID | Name | Network ID | MAC Address | Status | Device ID | Column Details

Shows ID, name, network ID, MAC address, port status, and connected device.

| 12345678-abcd-ef00-1111-223344556677 | test-port | 87654321-dcba-9876-5432-abcdef012345 | 02:42:ac:11:00:02 | ACTIVE | None | Port Entry

An example entry showing active status and unassigned device.

Power User Variants

Optimized versions

openstack port list --sort-key created

Sort ports by creation date.

openstack port list --format yaml

Output in YAML format for compatibility with Ansible.

Troubleshooting

Common pitfalls

No service available

Solution: Ensure that the OpenStack Networking (Neutron) service is running.

Unauthorized (HTTP 401)

Solution: Check your OpenStack credentials and ensure proper permissions.

Invalid input

Solution: Verify that the project context is set correctly using `--project <project_id>`.

Command Breakdown

What each part is doing

openstack
Base Command
The executable that performs this operation. Here it runs Openstack before the shell applies any redirect operators.

Alternative Approaches

Comparable commands in other tools

Alternative networking tools for the same job.