summaryrefslogtreecommitdiff
path: root/api-ref/source/index.rst
blob: abc762cf294fc94f6b1b69cec33910dafc4773f4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
:tocdepth: 2

==============
 Designate API
==============

This is a reference for the OpenStack DNS API which is provided by
the Designate project.

**Current** API version

    :doc:`Designate API v2<dns-api-v2-index>`

**Supported** API version

    None

.. toctree::
   :hidden:

   dns-api-v2-index

Designate 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
reference in the section the change occurred in. Subsequent minor versions are
a superset of the previous versions of the same major revision.

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 Versions
============

Show all enabled API versions

List all API versions
=====================

.. rest_method::  GET /


.. rest_status_code:: success status.yaml

   - 200


.. rest_status_code:: error status.yaml

   - 400
   - 405
   - 500
   - 503


Request
-------

No parameters needed

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

.. rest_parameters:: parameters.yaml

   - id: api_version_id
   - links: links
   - status: api_version_status
   - updated_at: updated_at

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

.. literalinclude:: samples/versions/get-versions-response.json
   :language: javascript

.. note::
   This is just an example output and does not represent the current API
   versions available.