A server migration provides a way to move an instance from one host to another. There are four types of migration operation supported: live migration, cold migration, resize and evacuation.
Compute v2
Cancel an ongoing live migration.
This command requires --os-compute-api-version
2.24 or greater.
openstack server migration abort <server> <migration>
Server (name or ID)
Migration (ID)
Confirm server migration.
Confirm (verify) success of the migration operation and release the old server.
openstack server migration confirm <server>
Server (name or ID)
Force an ongoing live migration to complete.
This command requires --os-compute-api-version
2.22 or greater.
openstack server migration force complete <server> <migration>
Server (name or ID)
Migration (ID)
List server migrations
openstack server migration list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--server <server>]
[--host <host>]
[--status <status>]
[--type <type>]
[--marker <marker>]
[--limit <limit>]
[--changes-since <changes-since>]
[--changes-before <changes-before>]
[--project <project>]
[--project-domain <project-domain>]
[--user <user>]
[--user-domain <user-domain>]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
Filter migrations by server (name or ID)
Filter migrations by source or destination host
Filter migrations by status
Filter migrations by type
The last migration of the previous page; displays list of migrations after ‘marker’. Note that the marker is the migration UUID. (supported with –os-compute-api-version 2.59 or above)
Maximum number of migrations to display. Note that there is a configurable max limit on the server, and the limit that is used will be the minimum of what is requested here and what is configured in the server. (supported with –os-compute-api-version 2.59 or above)
List only migrations changed later or equal to a certain point of time. The provided time should be an ISO 8061 formatted time, e.g. 2016-03-04T06:27:59Z
. (supported with –os-compute-api-version 2.59 or above)
List only migrations changed earlier or equal to a certain point of time. The provided time should be an ISO 8061 formatted time, e.g. 2016-03-04T06:27:59Z
. (supported with –os-compute-api-version 2.66 or above)
Filter migrations by project (name or ID) (supported with –os-compute-api-version 2.80 or above)
Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
Filter migrations by user (name or ID) (supported with –os-compute-api-version 2.80 or above)
Domain the user belongs to (name or ID). This can be used in case collisions between user names exist.
Revert server migration.
Revert the migration operation. Release the new server and restart the old one.
openstack server migration revert <server>
Server (name or ID)
Show an in-progress live migration for a given server.
Note that it is not possible to show cold migrations or completed live-migrations. Use ‘openstack server migration list’ to get details for these.
openstack server migration show <server> <migration>
Server (name or ID)
Migration (ID)
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.