Create Port

Verb URI Description
POST /ports Creates a port on a specified network. Only administrative users can add the binding extended attributes.

Normal Response Code: 201

Error Response Codes: Bad Request (400), Unauthorized (401), Forbidden (403), Not Found (404), Conflict (409), MAC generation failure (503)

This operation creates an OpenStack Networking port. You must specify the network where the port is to created on the network_id attribute in the request body.

This operation requires a request body.

This operation returns a response body.

In addition to any attributes that can be set in a create port operation, administrative users can also set the following binding-prefixed extended attributes:

Field Description

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: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...