nova/releasenotes/notes/support-to-query-nova-resources-filter-by-changes-before-e4942cde61070e28.yaml
zhangbailin 28c1075b59 Resource retrieving: add changes-before filter
This adds the changes-before filter to the servers,
os-instance-actions and os-migrations APIs for
filtering resources which were last updated before
or equal to the given time. The changes-before filter,
like the changes-since filter, will return deleted
server resources.

Part of bp support-to-query-nova-resources-filter-by-changes-before
Change-Id: If91c179e3823c8b0da744a9363906b0f7b05c326
2018-09-19 09:56:56 -04:00

25 lines
971 B
YAML

---
features:
- |
Microversion 2.66 adds the optional filter parameter ``changes-before``
which can be used to get resources changed before or equal to the
specified date and time.
Like the ``changes-since`` filter, the ``changes-before`` filter will
also return deleted servers.
This parameter (``changes-before``) does not change any read-deleted
behavior in the os-instance-actions or os-migrations APIs.
The os-instance-actions API with the 2.21 microversion allows retrieving
instance actions for a deleted server resource. The os-migrations API
takes an optional ``instance_uuid`` filter parameter but does not support
returning deleted migration records.
The ``changes-before`` request parameter can be passed to the servers,
os-instance-action and os-migrations APIs:
* ``GET /servers``
* ``GET /servers/detail``
* ``GET /servers/{server_id}/os-instance-actions``
* ``GET /os-migrations``