From 40e3366ea35823b43e97bcd27ed25fef222d3989 Mon Sep 17 00:00:00 2001
From: Lee Yarwood <lyarwood@redhat.com>
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 301de999b6a2..8ae3d22093cf 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.