# Migrate

## Synopsis

action name: `migrate`

Migrates a server to a destination nova compute host

This action will allow you to migrate a server to another compute destination host. Migration type ‘live’ can only be used for migrating active VMs. Migration type ‘cold’ can be used for migrating non-active VMs as well active VMs, which will be shut down while migrating.

Note

Nova API version must be 2.56 or above if `destination_node` parameter is given.

## Configuration

Action parameters:

parameter | type | required | description
--- | --- | --- | ---
`resource_id` | string | yes | UUID of the server to migrate
`migration_type` | string | yes | Type of migration: “live” or “cold”
`source_node` | string | yes | Source compute hostname
`destination_node` | string | no | Destination compute hostname. If not specified, nova-scheduler will determine the destination

## Skipping conditions

Migrate actions will be automatically skipped in the pre_condition phase in the following cases:

- The server does not exist

- The server is not running on the source_node

On other conditions the action will be FAILED in the pre_condition check:

- Destination node (if specified) does not exist or is disabled

- The server status is not ACTIVE for live migration

this page last updated: 2026-04-01 21:51:00

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug