octavia/api-ref/source/index.rst
Michael Johnson 93c8e006ce Update Octavia docs for documentation migration
This patch updates the Octavia documentation in support of the
OpenStack documentation migration[1].

[1] https://specs.openstack.org/openstack/docs-specs/specs \
    /pike/os-manuals-migration.html

Change-Id: I97fd038b8050bfe776c3fca8336d9090f8236362
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454
2017-07-03 11:43:40 -07:00

86 lines
1.9 KiB
ReStructuredText

:tocdepth: 2
=============
Octavia API
=============
This is a reference for the OpenStack Load Balancing API which is provided by
the Octavia project.
Current API version
:doc:`Octavia API v2.0<v2/index>`
Supported API version
:doc:`v1/octaviaapi`
Deprecated API version
None
.. toctree::
:hidden:
v2/index
v1/octaviaapi
The API status reflects the state of the endpoint on the service.
* Current indicates a stable version that is up-to-date, recent, and might
receive future versions. This endpoint should be prioritized over all
others.
* Supported is a stable version that is available on the server. However, it
is not likely the most recent available and might not be updated or might
be deprecated at some time in the future.
* Deprecated is a stable version that is still available but is being
deprecated and might be removed in the future.
* Experimental is not a stable version. This version is under development or
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>`__.
.. rest_expand_all::
-------------
API Discovery
-------------
List All Major Versions
=======================
.. rest_method:: GET /
This fetches all the information about all known major API versions in the
deployment.
Response codes
--------------
.. rest_status_code:: success http-status.yaml
- 200
.. rest_status_code:: error http-status.yaml
- 500
Response
--------
.. rest_parameters:: parameters.yaml
- id: api_version_id
- 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.