From 1a079a6394b567ea38cc892146ad13829c1c0256 Mon Sep 17 00:00:00 2001
From: jichenjc <jichenjc@cn.ibm.com>
Date: Fri, 8 Jun 2018 14:59:05 +0800
Subject: [PATCH] Mention server status in api-ref when rebuild

Add description about server status in active, shutoff,
error can accept a rebuild action.

Closes-Bug: 1775665

Change-Id: Id52acb9fdb264b337a6a9748049aeecd22901bf4
---
 api-ref/source/servers-actions.inc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/api-ref/source/servers-actions.inc b/api-ref/source/servers-actions.inc
index 1ff5cd631d27..6538e215e1ad 100644
--- a/api-ref/source/servers-actions.inc
+++ b/api-ref/source/servers-actions.inc
@@ -457,6 +457,10 @@ Rebuilds a server.
 
 Specify the ``rebuild`` action in the request body.
 
+**Preconditions**
+
+The server status must be ``ACTIVE``, ``SHUTOFF`` or ``ERROR``.
+
 .. note:: There is a `known limitation`_ where the root disk is not
    replaced for volume-backed instances during a rebuild.