[placement] Add api-ref for DELETE RP inventory

This provides simple documentation of the path parameters when deleting
a single inventory record for a resource provider.

Change-Id: Ie7eeb426744bccf5e976ed304fa6f0a58b38ac01

1 files changed, 33 insertions, 1 deletions

diff --git a/placement-api-ref/source/inventory.inc b/placement-api-ref/source/inventory.inc
index aaf5f4cca1..c9b024eeb0 100644
--- a/placement-api-ref/source/inventory.inc
+++ b/placement-api-ref/source/inventory.inc
@@ -93,4 +93,36 @@ Response Example
 ----------------
 
 .. literalinclude:: update-inventory.json
-   :language: javascript
\ No newline at end of file
+   :language: javascript
+
+Delete resource provider inventory
+==================================
+
+Delete the inventory record of the `{resource_class}` for
+the resource provider identified by `{uuid}`.
+
+See `Troubleshooting`_ section in ``Delete resource provider
+inventories`` for a description. In addition, the request returns
+HTTP 409 when there are allocations for the specified resource
+provider and resource class.
+
+.. _Troubleshooting: ?expanded=delete-resource-provider-inventories-detail#delete-resource-provider-inventories
+
+.. rest_method:: DELETE /resource_providers/{uuid}/inventories/{resource_class}
+
+Normal Response Codes: 204
+
+Error response codes: itemNotFound(404), conflict(409)
+
+Request
+-------
+
+.. rest_parameters:: parameters.yaml
+
+  - uuid: resource_provider_uuid_path
+  - resource_class: resource_class_path
+
+Response
+--------
+
+No body content is returned on a successful DELETE.