Add pagination and Changes-since filter support for os-migrations.

This patch adds pagination support and changes-since filter
for os-migrations API.

Users can now use 'limit' and 'marker' to perform paginate
query of running migrations list. Users can also filter the
results according to the migrations' updated time.

The ``GET /os-migrations`` and server migrations APIs will now
return a uuid value in addition to the migrations id in the response,
and the query parameter schema of the ``GET /os-migrations`` API no
longer allows additional properties.

Co-Authored-By: Yikun Jiang <yikunkero@gmail.com>

Implement: blueprint add-pagination-and-change-since-for-migration-list
Change-Id: I7e01f95d7173d9217f76e838b3ea71555151ef56

nova/api/openstack/api_version_request.py

@@ -139,6 +139,9 @@ REST_API_VERSION_HISTORY = """REST API Version History:
              related limits and quota resources are also removed.
     * 2.58 - Add pagination support and changes-since filter for
              os-instance-actions API.
+    * 2.59 - Add pagination support and changes-since filter for os-migrations
+             API. And the os-migrations API now returns both the id and the
+             uuid in response.
 """
 
 # The minimum and maximum versions of the API supported
@@ -147,7 +150,7 @@ REST_API_VERSION_HISTORY = """REST API Version History:
 # Note(cyeoh): This only applies for the v2.1 API once microversions
 # support is fully merged. It does not affect the V2 API.
 _MIN_API_VERSION = "2.1"
-_MAX_API_VERSION = "2.58"
+_MAX_API_VERSION = "2.59"
 DEFAULT_API_VERSION = _MIN_API_VERSION
 
 # Almost all proxy APIs which are related to network, images and baremetal