diff options
author | Takashi NATSUME <natsume.takashi@lab.ntt.co.jp> | 2016-12-09 14:03:32 +0900 |
---|---|---|
committer | Matt Riedemann <mriedem.os@gmail.com> | 2017-11-29 20:48:16 -0500 |
commit | d2ce4ca9ec7501c4ecb1edfacf421d2231c6edef (patch) | |
tree | 9309903dbcc800a5b939e2df780cbc0aa4aa21c6 /api-ref/source/servers-admin-action.inc | |
parent | 05c6b54eec650ed641256a39cc85ca1efe70f9ea (diff) | |
download | nova-d2ce4ca9ec7501c4ecb1edfacf421d2231c6edef.tar.gz |
Enable cold migration with target host(2/2)
This function enables users to specify a target host
when cold migrating a VM instance.
This patch modifies the migration API.
APIImpact
Add an optional parameter 'host' in cold migration action.
Change-Id: Iee356c4dd097c846b6ca8617ead6a061300c83f8
Implements: blueprint cold-migration-with-target-queens
Diffstat (limited to 'api-ref/source/servers-admin-action.inc')
-rw-r--r-- | api-ref/source/servers-admin-action.inc | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/api-ref/source/servers-admin-action.inc b/api-ref/source/servers-admin-action.inc index 9c3e6da8d3..f266b557e5 100644 --- a/api-ref/source/servers-admin-action.inc +++ b/api-ref/source/servers-admin-action.inc @@ -56,10 +56,15 @@ Migrate Server (migrate Action) .. rest_method:: POST /servers/{server_id}/action -Migrates a server to a host. The scheduler chooses the host. +Migrates a server to a host. Specify the ``migrate`` action in the request body. +Up to microversion 2.55, the scheduler chooses the host. +Starting from microversion 2.56, the ``host`` parameter is available +to specify the destination host. If you specify ``null`` or don't specify +this parameter, the scheduler chooses a host. + Policy defaults enable only users with the administrative role to perform this operation. Cloud providers can change these permissions through the ``policy.json`` file. @@ -76,12 +81,18 @@ Request - server_id: server_id_path - migrate: migrate + - host: host_migration_2_56 -**Example Migrate Server (migrate Action)** +**Example Migrate Server (migrate Action) (v2.1)** .. literalinclude:: ../../doc/api_samples/os-migrate-server/migrate-server.json :language: javascript +**Example Migrate Server (migrate Action) (v2.56)** + +.. literalinclude:: ../../doc/api_samples/os-migrate-server/v2.56/migrate-server.json + :language: javascript + Response -------- |