# openstack.compute.v2.server_migration

## The ServerMigration Class

The `ServerMigration` class inherits from `Resource`.

class openstack.compute.v2.server_migration.ServerMigration(_synchronized=False, connection=None, **attrs)

  The base resource

  Parameters:

    - _synchronized (bool) – This is not intended to be used directly. See `new()` and `existing()`.

    - connection (openstack.connection.Connection) – Reference to the Connection being used. Defaults to None to allow Resource objects to be used without an active Connection, such as in unit tests. Use of `self._connection` in Resource code should protect itself with a check for None.

  resource_key = 'migration'

    Singular form of key for resource.

  resources_key = 'migrations'

    Plural form of key for resource.

  base_path = '/servers/%(server_id)s/migrations'

    The base part of the URI for this resource.

  allow_fetch = True

    Allow get operation for this resource.

  allow_list = True

    Allow list operation for this resource.

  allow_delete = True

    Allow delete operation for this resource.

  server_id

    The ID for the server from the URI of the resource

  created_at

    The date and time when the resource was created.

  dest_host

    The target host of the migration.

  dest_compute

    The target compute of the migration.

  dest_node

    The target node of the migration.

  disk_processed_bytes

    The amount of disk, in bytes, that has been processed during the migration.

  disk_remaining_bytes

    The amount of disk, in bytes, that still needs to be migrated.

  disk_total_bytes

    The total amount of disk, in bytes, that needs to be migrated.

  memory_processed_bytes

    The amount of memory, in bytes, that has been processed during the migration.

  memory_remaining_bytes

    The amount of memory, in bytes, that still needs to be migrated.

  memory_total_bytes

    The total amount of memory, in bytes, that needs to be migrated.

  project_id

    The ID of the project that initiated the server migration (since microversion 2.80)

  server_uuid

    The UUID of the server from the response body

  source_compute

    The source compute of the migration.

  source_node

    The source node of the migration.

  status

    The current status of the migration.

  updated_at

    The date and time when the resource was last updated.

  user_id

    The ID of the user that initiated the server migration (since microversion 2.80)

  uuid

    The UUID of the migration (since microversion 2.59)

  force_complete(session)

    Force on-going live migration to complete.

this page last updated: 2026-01-16 23:06:19

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