From 40e3366ea35823b43e97bcd27ed25fef222d3989 Mon Sep 17 00:00:00 2001 From: Lee Yarwood Date: Tue, 28 Apr 2020 10:38:13 +0100 Subject: [PATCH] docs: Add evacuation pre-conditions around the src host These were previously not listed but are important to re-enforce to avoid corruption of instances during an evacuation. Change-Id: Ia80dba0ade98940a5c4f94a9d2095e3c9ef21f97 --- api-ref/source/servers-action-evacuate.inc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/api-ref/source/servers-action-evacuate.inc b/api-ref/source/servers-action-evacuate.inc index 301de999b6a..8ae3d22093c 100644 --- a/api-ref/source/servers-action-evacuate.inc +++ b/api-ref/source/servers-action-evacuate.inc @@ -11,6 +11,12 @@ Evacuates a server from a failed host to a new host. - In the request body, if ``onSharedStorage`` is set, then do not set ``adminPass``. - The target host should not be the same as the instance host. +**Preconditions** + +- The failed host must be fenced and no longer running the original server. +- The failed host must be reported as down or marked as forced down using + `Update Forced Down`_. + Starting from API version 2.68, the ``force`` parameter is no longer accepted as this could not be meaningfully supported by servers with complex resource allocations.