List Ports

Verb URI Description
GET /ports Lists ports to which the tenant has access. The binding extended attributes are visible to only administrative users. The binding:vnic_type extended attribute is visible to only port owners and administrative users.

Normal Response Code: 200

Error Response Codes: Unauthorized (401)

This operation lists ports to which the tenant has access.

This operation does not require a request body.

This operation returns a response body.

In addition to any other fields returned in the list port response, the following binding-prefixed fields are visible to administrative users:

Field Description

binding:vif_type

Read-only. The vif type for the specified port.

binding:host_id

The ID of the host where the port is allocated. In some cases different implementations can run on different hosts.

binding:profile

A dictionary that enables the application running on the specified host to pass and receive vif port-specific information to the plug-in.

binding:capabilities

Read-only. A dictionary that enables the application to pass information about functions that Networking API v2.0 provides. Specify the following value: port_filter : Boolean to define whether Networking API v2.0 provides port filtering features such as security group and anti-MAC/IP spoofing.

binding:vnic_type

The vnic type to be bound on the neutron port. Valid values are normal, direct, or macvtap.

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page


loading table of contents...