From 901308d12df3f4d17ef6529e0030d0e10fb61abe Mon Sep 17 00:00:00 2001
From: shaoxj <shaoxj@inspur.com>
Date: Fri, 9 Feb 2018 17:21:20 +0800
Subject: [PATCH] Document the preconditions for deleting a share

Document both the share status that allows deletion and
dependencies of the share that prevent share deletion.

Change-Id: I5f076112e66a2d50394639dce50390d8cfb4922b
---
 api-ref/source/shares.inc | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/api-ref/source/shares.inc b/api-ref/source/shares.inc
index fd81fa2735..fc98fcfcde 100644
--- a/api-ref/source/shares.inc
+++ b/api-ref/source/shares.inc
@@ -584,6 +584,16 @@ Delete share
 
 Deletes a share.
 
+Preconditions
+
+- Share status must be ``available``, ``error`` or ``inactive``
+
+- You cannot already have a snapshot of the share.
+
+- You cannot already have a group snapshot of the share.
+
+- You cannot already have a replica of the share.
+
 Response codes
 --------------