From b22f64a8a2d1935379d41edc94586a479639e1bf Mon Sep 17 00:00:00 2001
From: Andrey Volkov <avolkov@mirantis.com>
Date: Mon, 3 Apr 2017 13:54:26 +0300
Subject: [PATCH] [placement] Add api-ref for DELETE RP inventories

This provides simple documentation of the path
parameters when deleting resource provider inventories.

Change-Id: Ia1f787fb9def8473a9698a9bf1ab1990a1c21f48
---
 placement-api-ref/source/inventories.inc | 31 ++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/placement-api-ref/source/inventories.inc b/placement-api-ref/source/inventories.inc
index a82bcefaec..f9acd830b4 100644
--- a/placement-api-ref/source/inventories.inc
+++ b/placement-api-ref/source/inventories.inc
@@ -95,3 +95,34 @@ Response Example
 .. literalinclude:: update-inventories.json
    :language: javascript
 
+
+Delete resource provider inventories
+====================================
+
+Deletes all inventory records for the resource provider identified by `{uuid}`.
+
+**Troubleshooting**
+
+The request returns an HTTP 409 when there are alllocations against
+the provider or if the provider's inventory is updated by another
+thread while attempting the operation.
+
+.. note:: Method is availiable starting from version 1.5.
+
+.. rest_method:: DELETE /resource_providers/{uuid}/inventories
+
+Normal Response Codes: 204
+
+Error response codes: itemNotFound(404), conflict(409)
+
+Request
+-------
+
+.. rest_parameters:: parameters.yaml
+
+  - uuid: resource_provider_uuid_path
+
+Response
+--------
+
+No body content is returned on a successful DELETE.