GET'> PUT'> POST'> DELETE'> '> '> ]>
The <literal>binding</literal> Extended Attributes for Ports Use the &APIv2; with the binding extended attributes to get information about, create, and update port objects. The binding-prefixed extended attributes for ports are:
binding Extended Attributes for Ports
Attribute Type Required CRUD C. Use the attribute in create operations. R. This attribute is returned in response to show and list operations. U. You can update the value of this attribute. D. You can delete the value of this attribute. Default Value Validation Constraints Notes
binding:vif_type String N/A R None N/A Read-only. The vif type for the specified port.
binding:host_id uuid-str N/A CRU None N/A The ID of the host where the port is allocated. In some cases different implementations can run on different hosts.
binding:profile list(dict) N/A CRU None N/A 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 list(dict) N/A R None N/A Read-only. A dictionary that enables the application to pass information about functions that &APIv2; provides. Specify the following value: port_filter : Boolean to define whether &APIv2; provides port filtering features such as security group and anti-MAC/IP spoofing.
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. 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 &APIv2; provides. Specify the following value: port_filter : Boolean to define whether &APIv2; provides port filtering features such as security group and anti-MAC/IP spoofing.
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. 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 &APIv2; provides. Specify the following value: port_filter : Boolean to define whether &APIv2; provides port filtering features such as security group and anti-MAC/IP spoofing.
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.
Update Port Verb URI Description &PUT; /ports/port-id Updates a specified port. Only administrative users can update the binding extended attributes. Normal Response Code: 200 Error Response Codes: Bad Request (400), Unauthorized (401), Forbidden (403), Not Found (404), Conflict (409) Use this operation to update information for a port. This operation requires a request body. This operation returns a response body. In addition to any attributes that can be updated in the update port operation, administrative users can also update 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.