summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMatt Riedemann <mriedem.os@gmail.com>2019-08-07 09:11:14 -0400
committerMatt Riedemann <mriedem.os@gmail.com>2019-08-08 18:13:33 -0400
commit0e7c99c8ead42326d8660103b0c78df70b775fe4 (patch)
treeac3a7d3392f63a889dbc850eb3124e0c23133654 /doc
parente281368c9679b385ecfb05737e614a05a9bab291 (diff)
downloadpython-novaclient-0e7c99c8ead42326d8660103b0c78df70b775fe4.tar.gz
Add --migration-type and --source-compute to migration-list
The GET /os-migrations API take a migration_type and source_compute filter parameter on the request since the v2.0 API. This adds support for specifying those parameters in the "nova migration-list" CLI and related MigrationManager.list() python API binding methods. A functional test is added which will cover the new options on all three of the decorated do_migration_list shell methods with lower bounds on 2.1, 2.59 and 2.66. Since the only type of migration we can safely generate in a single-node CI job is a resize the test does a resize. As such, _pick_alternate_flavor is moved into the base test class for re-use. Implements blueprint more-migration-list-filters Change-Id: I4be9a06df3e0d40d3990d067ce112247a81b45b4
Diffstat (limited to 'doc')
-rw-r--r--doc/source/cli/nova.rst30
1 files changed, 27 insertions, 3 deletions
diff --git a/doc/source/cli/nova.rst b/doc/source/cli/nova.rst
index 1a0081eb..c0d80eda 100644
--- a/doc/source/cli/nova.rst
+++ b/doc/source/cli/nova.rst
@@ -2556,13 +2556,26 @@ nova migration-list
.. code-block:: console
- usage: nova migration-list [--instance-uuid <instance_uuid>] [--host <host>]
- [--status <status>] [--marker <marker>]
- [--limit <limit>] [--changes-since <changes_since>]
+ usage: nova migration-list [--instance-uuid <instance_uuid>]
+ [--host <host>]
+ [--status <status>]
+ [--migration-type <migration_type>]
+ [--source-compute <source_compute>]
+ [--marker <marker>]
+ [--limit <limit>]
+ [--changes-since <changes_since>]
[--changes-before <changes_before>]
Print a list of migrations.
+**Examples**
+
+To see the list of evacuation operations *from* a compute service host:
+
+.. code-block:: console
+
+ nova migration-list --migration-type evacuation --source-compute host.foo.bar
+
**Optional arguments:**
``--instance-uuid <instance_uuid>``
@@ -2574,6 +2587,17 @@ Print a list of migrations.
``--status <status>``
Fetch migrations for the given status.
+``--migration-type <migration_type>``
+ Filter migrations by type. Valid values are:
+
+ * evacuation
+ * live-migration
+ * migration
+ * resize
+
+``--source-compute <source_compute>``
+ Filter migrations by source compute host name.
+
``--marker <marker>``
The last migration of the previous page; displays list of migrations after
"marker". Note that the marker is the migration UUID.