From cb70f9cb8b022c34dee222b921b4d541c4b1f07f Mon Sep 17 00:00:00 2001
From: Anusha Unnam <anusha.unnam@intel.com>
Date: Fri, 24 Mar 2017 17:47:58 +0000
Subject: [PATCH] Add description to nova/policies/shelve.py

The 'discoverable' policy is not documented as it will be removed in a
future change.

blueprint policy-docs

Change-Id: Ie44ced1a5551ed085fd48ec6c55547ca423d3278
---
 nova/policies/shelve.py | 39 ++++++++++++++++++++++++++++++---------
 1 file changed, 30 insertions(+), 9 deletions(-)

diff --git a/nova/policies/shelve.py b/nova/policies/shelve.py
index 8fb4f430c2a..4c032d177e9 100644
--- a/nova/policies/shelve.py
+++ b/nova/policies/shelve.py
@@ -22,15 +22,36 @@
 
 
 shelve_policies = [
-    policy.RuleDefault(
-        name=POLICY_ROOT % 'shelve',
-        check_str=base.RULE_ADMIN_OR_OWNER),
-    policy.RuleDefault(
-        name=POLICY_ROOT % 'unshelve',
-        check_str=base.RULE_ADMIN_OR_OWNER),
-    policy.RuleDefault(
-        name=POLICY_ROOT % 'shelve_offload',
-        check_str=base.RULE_ADMIN_API),
+    base.create_rule_default(
+        POLICY_ROOT % 'shelve',
+        base.RULE_ADMIN_OR_OWNER,
+        "Shelve Server",
+        [
+            {
+                'method': 'POST',
+                'path': '/servers/{server_id}/action (shelve)'
+            }
+        ]),
+    base.create_rule_default(
+        POLICY_ROOT % 'unshelve',
+        base.RULE_ADMIN_OR_OWNER,
+        "Unshelve (Restore) Shelved Server",
+        [
+            {
+                'method': 'POST',
+                'path': '/servers/{server_id}/action (unshelve)'
+            }
+        ]),
+    base.create_rule_default(
+        POLICY_ROOT % 'shelve_offload',
+        base.RULE_ADMIN_API,
+        "Shelf-Offload (Remove) Server",
+        [
+            {
+                'method': 'POST',
+                'path': '/servers/{server_id}/action (shelveOffload)'
+            }
+        ]),
     policy.RuleDefault(
         name=POLICY_ROOT % 'discoverable',
         check_str=base.RULE_ANY),