de6e2b9948
JSON body examples of Placement API reference are in the same directroy where *.inc files exist. This patch moves JSON body examples to an isolated directory in order to make it easier to maintain the API reference. Change-Id: I8fd587100d22bd10dd4b2b2f1b25c5ecc7fc8537
50 lines
1.3 KiB
PHP
50 lines
1.3 KiB
PHP
============
|
|
API Versions
|
|
============
|
|
|
|
In order to bring new features to users over time, the Placement API
|
|
supports microversioning. Microversions allow use of certain features on a
|
|
per-request basis via the ``OpenStack-API-Version`` header. For example, to
|
|
request microversion 1.10, specify the header::
|
|
|
|
OpenStack-API-Version: placement 1.10
|
|
|
|
For more details about Microversions, please reference:
|
|
`Microversions
|
|
<https://developer.openstack.org/api-guide/compute/microversions.html>`_
|
|
|
|
.. note:: The maximum microversion supported by each release varies.
|
|
Please reference:
|
|
`REST API Version History
|
|
<https://docs.openstack.org/nova/latest/user/placement.html#rest-api-version-history>`__
|
|
for API microversion history details.
|
|
|
|
List Versions
|
|
=============
|
|
|
|
.. rest_method:: GET /
|
|
|
|
Fetch information about all known major versions of the placement API,
|
|
including information about the minimum and maximum microversions.
|
|
|
|
.. note:: At this time there is only one major version of the placement API:
|
|
version 1.0.
|
|
|
|
Normal Response Codes: 200
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- versions: versions
|
|
- id: version_id
|
|
- min_version: version_min
|
|
- max_version: version_max
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: ./samples/root/get-root.json
|
|
:language: javascript
|