neutron-lib/api-ref/source/v2/fip-port-forwarding.inc

.. -*- rst -*-

============================
Floating IPs port forwarding
============================

Lists, creates, shows details for, updates, and deletes floating IPs port
forwardings.

Show port forwarding
====================

.. rest_method::  GET /v2.0/floatingips/{floatingip_id}/port_forwardings/{port_forwarding_id}

Shows information for a floating IP port forwarding.

Use the ``fields`` query parameter to control which fields are returned in the response body.
For information, see `Filtering and Column Selection <https://wiki.openstack.org/wiki/Neutron/APIv2
-specification#Filtering_and_Column_Selection>`__.

Normal response codes: 200

Error response codes: 400, 404

Request
-------

.. rest_parameters:: parameters.yaml

   - floatingip_id: floatingip-id-path
   - port_forwarding_id: fip_port_forwarding_id-path
   - fields: fields

Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - port_forwarding: fip_port_forwarding
   - id: fip_port_forwarding_id-body
   - internal_port_id: internal_port_id
   - internal_ip_address: internal_ip_address-response
   - internal_port: internal_port
   - external_port: external_port
   - protocol: fip_port_forwarding_protocol-body

Response Example
----------------

.. literalinclude:: samples/port_forwardings/port-fowarding-show-response.json
   :language: javascript


Update a port forwarding
========================

.. rest_method::  PUT /v2.0/floatingips/{floatingip_id}/port_forwardings/{port_forwarding_id}

Updates a floating IP port forwarding.

Normal response codes: 200

Error response codes: 400, 404

Request
-------

.. rest_parameters:: parameters.yaml

   - floatingip_id: floatingip-id-path
   - port_forwarding_id: fip_port_forwarding_id-path
   - port_forwarding: fip_port_forwarding
   - internal_port_id: internal_port_id-update
   - internal_ip_address: internal_ip_address
   - internal_port: internal_port-update
   - external_port: external_port-update
   - protocol: fip_port_forwarding_protocol-update

Request Example
---------------

.. literalinclude:: samples/port_forwardings/port-fowarding-update-request.json
   :language: javascript

Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - port_forwarding: fip_port_forwarding
   - id: fip_port_forwarding_id-body
   - internal_port_id: internal_port_id
   - internal_ip_address: internal_ip_address-response
   - internal_port: internal_port
   - external_port: external_port
   - protocol: fip_port_forwarding_protocol-body

Response Example
----------------

.. literalinclude:: samples/port_forwardings/port-fowarding-update-response.json
   :language: javascript

Delete a floating IP port forwarding
====================================

.. rest_method::  DELETE /v2.0/floatingips/{floatingip_id}/port_forwardings/{port_forwarding_id}

Deletes a floating IP port forwarding.

Normal response codes: 204

Error response codes: 404

Request
-------

.. rest_parameters:: parameters.yaml

   - floatingip_id: floatingip-id-path
   - port_forwarding_id: fip_port_forwarding_id-path

Response
--------

There is no body content for the response of a successful DELETE request.

List floating IP port forwardings
=================================

.. rest_method::  GET /v2.0/floatingips/{floatingip_id}/port_forwardings

Lists floating IP port forwardings that the project has access to.

Default policy settings return only the port forwardings associated to floating
IPs owned by the project of the user submitting the request, unless the
user has administrative role.

Use the ``fields`` query parameter to control which fields are returned in the response body.
Additionally, you can filter results by using query string parameters.
For information, see `Filtering and Column Selection <https://wiki.openstack.org/wiki/Neutron/APIv2
-specification#Filtering_and_Column_Selection>`__.

Normal response codes: 200

Error response codes: 400, 404

Request
-------

.. rest_parameters:: parameters.yaml

   - floatingip_id: floatingip-id-path
   - id: id-query
   - internal_port_id: internal_port_id-query
   - external_port: external_port-query
   - protocol: fip_port_forwarding_protocol-query
   - sort_key: fip_port_forwarding-sort_key
   - sort_dir: sort_dir
   - fields: fields

Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - port_forwardings: fip_port_forwardings
   - id: fip_port_forwarding_id-body
   - internal_port_id: internal_port_id
   - internal_ip_address: internal_ip_address-response
   - internal_port: internal_port
   - external_port: external_port
   - protocol: fip_port_forwarding_protocol-body

Response Example
----------------

.. literalinclude:: samples/port_forwardings/port-fowarding-list-response.json
   :language: javascript

Create port forwarding
======================

.. rest_method::  POST /v2.0/floatingips/{floatingip_id}/port_forwardings

Creates a floating IP port forwarding.

Normal response codes: 201

Error response codes: 400, 404

Request
-------

.. rest_parameters:: parameters.yaml

   - floatingip_id: floatingip-id-path
   - port_forwarding: fip_port_forwarding
   - internal_port_id: internal_port_id
   - internal_ip_address: internal_ip_address
   - internal_port: internal_port
   - external_port: external_port
   - protocol: fip_port_forwarding_protocol-body

Request Example
---------------

.. literalinclude:: samples/port_forwardings/port-fowarding-create-request.json
   :language: javascript

Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - port_forwarding: fip_port_forwarding
   - id: fip_port_forwarding_id-body
   - internal_port_id: internal_port_id
   - internal_ip_address: internal_ip_address-response
   - internal_port: internal_port
   - external_port: external_port
   - protocol: fip_port_forwarding_protocol-body

Response Example
----------------

.. literalinclude:: samples/port_forwardings/port-fowarding-create-response.json
   :language: javascript