2017-02-13 15:28:29 -08:00
|
|
|
:tocdepth: 2
|
2017-02-10 14:04:20 -08:00
|
|
|
|
|
|
|
=============
|
|
|
|
Octavia API
|
|
|
|
=============
|
|
|
|
|
|
|
|
This is a reference for the OpenStack Load Balancing API which is provided by
|
|
|
|
the Octavia project.
|
|
|
|
|
2020-07-20 09:36:11 -07:00
|
|
|
**Current** API version
|
2017-02-10 14:04:20 -08:00
|
|
|
|
2018-04-06 19:55:01 -07:00
|
|
|
:doc:`Octavia API v2<v2/index>`
|
2017-02-10 14:04:20 -08:00
|
|
|
|
2020-07-20 09:36:11 -07:00
|
|
|
**Supported** API version
|
2017-06-28 16:04:16 -07:00
|
|
|
|
2018-04-06 19:55:01 -07:00
|
|
|
None
|
2017-06-28 16:04:16 -07:00
|
|
|
|
2017-02-10 14:04:20 -08:00
|
|
|
.. toctree::
|
|
|
|
:hidden:
|
|
|
|
|
|
|
|
v2/index
|
2017-06-28 16:04:16 -07:00
|
|
|
|
2018-04-06 19:55:01 -07:00
|
|
|
Octavia API minor releases are additive to the API major revision and share
|
|
|
|
the same URL path. Minor revision changes to the API are called out in the API
|
2018-12-16 16:11:37 +08:00
|
|
|
reference in the section the change occurred in. Subsequent minor versions are a
|
2018-04-06 19:55:01 -07:00
|
|
|
superset of the previous versions of the same major revision.
|
|
|
|
|
2017-06-28 16:04:16 -07:00
|
|
|
The API status reflects the state of the endpoint on the service.
|
|
|
|
|
2020-07-20 09:36:11 -07:00
|
|
|
* *Current* indicates a stable version that is up-to-date, recent, and might
|
2017-06-28 16:04:16 -07:00
|
|
|
receive future versions. This endpoint should be prioritized over all
|
|
|
|
others.
|
2020-07-20 09:36:11 -07:00
|
|
|
* *Supported* is a stable version that is available on the server. However, it
|
2017-06-28 16:04:16 -07:00
|
|
|
is not likely the most recent available and might not be updated or might
|
|
|
|
be deprecated at some time in the future.
|
2020-07-20 09:36:11 -07:00
|
|
|
* *Deprecated* is a stable version that is still available but is being
|
2017-06-28 16:04:16 -07:00
|
|
|
deprecated and might be removed in the future.
|
2020-07-20 09:36:11 -07:00
|
|
|
* *Experimental* is not a stable version. This version is under development or
|
2017-06-28 16:04:16 -07:00
|
|
|
contains features that are otherwise subject to change. For more
|
|
|
|
information about API status values and version information, see
|
|
|
|
`Version Discovery <https://wiki.openstack.org/wiki/VersionDiscovery>`__.
|
2017-02-13 15:28:29 -08:00
|
|
|
|
|
|
|
.. rest_expand_all::
|
|
|
|
|
|
|
|
-------------
|
|
|
|
API Discovery
|
|
|
|
-------------
|
|
|
|
|
2018-04-06 19:55:01 -07:00
|
|
|
List All Versions
|
2017-02-13 15:28:29 -08:00
|
|
|
=======================
|
|
|
|
|
|
|
|
.. rest_method:: GET /
|
|
|
|
|
2018-04-06 19:55:01 -07:00
|
|
|
This fetches all the information about all known API versions in the
|
2017-02-13 15:28:29 -08:00
|
|
|
deployment.
|
|
|
|
|
2017-02-13 15:28:29 -08:00
|
|
|
Response codes
|
|
|
|
--------------
|
|
|
|
|
|
|
|
.. rest_status_code:: success http-status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error http-status.yaml
|
|
|
|
|
|
|
|
- 500
|
|
|
|
|
2017-02-13 15:28:29 -08:00
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- id: api_version_id
|
2018-04-06 19:55:01 -07:00
|
|
|
- links: links
|
2017-02-13 15:28:29 -08:00
|
|
|
- status: api_version_status
|
|
|
|
- updated_at: updated_at
|
|
|
|
|
|
|
|
Response Example
|
|
|
|
----------------
|
|
|
|
|
|
|
|
.. literalinclude:: examples/versions-get-resp.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
This is just an example output and does not represent the current API
|
|
|
|
versions available.
|