1f67ce2496
Introduce API microversion 2.88, which makes the following changes to a number of 'os-hypervisors'. Specifically, the following fields are dropped from both the '/os-hypervisors/detail' (detailed list) and '/os-hypervisors/{hypervisor_id}' (show) APIs: - current_workload - cpu_info - vcpus - vcpus_used - free_disk_gb - local_gb - local_gb_used - disk_available_least - free_ram_mb - memory_mb - memory_mb_used - running_vms In addition, the '/os-hypervisors/statistics' API, which provided a summary of the above stats but for all hypervisors in the deployment, is dropped entirely. Finally, the '/os-hypervisors/{hypervisor}/uptime' API, which provided a similar response to the '/os-hypervisors/{hypervisor}' API but with an additional 'uptime' field, has been removed in favour of including this field in the primary '/os-hypervisors/{hypervisor}' API. A small tweak to 'tox.ini' that allows us to share some venvs is included. Part of blueprint modernize-os-hypervisors-api Change-Id: I515e484ade6c6455f82a3067940a418a0d7d965a Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
34 lines
1.2 KiB
YAML
34 lines
1.2 KiB
YAML
---
|
|
deprecations:
|
|
- |
|
|
The 2.88 API microversion has been added. This microversion removes a
|
|
number of fields have been removed from the ``GET /os-hypervisors/detail``
|
|
(detailed list) and ``GET /os-hypervisors/{hypervisor_id}`` (show) APIs::
|
|
|
|
- ``current_workload``
|
|
- ``cpu_info``
|
|
- ``vcpus``
|
|
- ``vcpus_used``
|
|
- ``free_disk_gb``
|
|
- ``local_gb``
|
|
- ``local_gb_used``
|
|
- ``disk_available_least``
|
|
- ``free_ram_mb``
|
|
- ``memory_mb``
|
|
- ``memory_mb_used``
|
|
- ``running_vms``
|
|
|
|
The fields have been removed as the information they provided was
|
|
frequently misleading or outright wrong, and more accurate information can
|
|
now be queried from placement.
|
|
|
|
In addition, the ``GET /os-hypervisors/statistics`` API, which provided a
|
|
summary view with just the fields listed above, has been removed entirely
|
|
and will now raise a HTTP 404 with microversion 2.88 or greater.
|
|
|
|
Finally, the ``GET /os-hypervisors/{hypervisor}/uptime`` API, which
|
|
provided a similar response to the ``GET /os-hypervisors/{hypervisor}`` API
|
|
but with an additional ``uptime`` field, has been removed in favour of
|
|
including this field in the primary ``GET /os-hypervisors/{hypervisor}``
|
|
API.
|