Show Port

Verb URI Description
GET /ports/port-id Shows information for a specified port. The binding extended attributes are visible to only administrative users. The binding:vnic_type extended attribute is visible to only port owners or administrative users.

Normal Response Code: 200

Error Response Codes: Unauthorized (401), Not Found (404)

This operation returns information for the port specified in the request URI.

This operation does not require a request body.

This operation returns a response body.

In addition to any fields returned in the show port response, the following binding-prefixed extended attributes 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 requested vnic type to be bound on neutron port (can be either normal, direct or macvtap).

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


loading table of contents...