From fba7dacffea56044ea9116b9fd3875cd7d83c756 Mon Sep 17 00:00:00 2001
From: jichenjc <jichenjc@cn.ibm.com>
Date: Sun, 22 Nov 2015 03:36:20 +0800
Subject: [PATCH] Add DELETE method for os-server-password

os-server-password has DELETE method to clear the password,
it's not in the microversion, so we should add it

Change-Id: Ie9ab5f612303fe1b16537d7a29c73f848e390167
Partial-Bug: #1515222
---
 api-ref/src/docbkx/ch_compute-v2.1.xml        |  5 +--
 .../v2.1/wadl/os-server-password-v2.1.wadl    | 34 ++++++++++++++++---
 2 files changed, 32 insertions(+), 7 deletions(-)

diff --git a/api-ref/src/docbkx/ch_compute-v2.1.xml b/api-ref/src/docbkx/ch_compute-v2.1.xml
index d87738ba8..dd71a35da 100644
--- a/api-ref/src/docbkx/ch_compute-v2.1.xml
+++ b/api-ref/src/docbkx/ch_compute-v2.1.xml
@@ -358,8 +358,9 @@
   <section xml:id="os-server-password-v2.1">
       <title>Servers password (servers, os-server-password)</title>
       <para>
-         Gets the encrypted administrative password set through the metadata
-         service.
+         Gets the encrypted administrative password. Also, clears the
+         encrypted administrative password for a server, which removes it from
+         the metadata server.
       </para>
       <wadl:resources
          href="../wadls/compute-api/src/v2.1/wadl/os-server-password-v2.1.wadl"
diff --git a/api-ref/src/wadls/compute-api/src/v2.1/wadl/os-server-password-v2.1.wadl b/api-ref/src/wadls/compute-api/src/v2.1/wadl/os-server-password-v2.1.wadl
index 11d170541..2e518de8d 100644
--- a/api-ref/src/wadls/compute-api/src/v2.1/wadl/os-server-password-v2.1.wadl
+++ b/api-ref/src/wadls/compute-api/src/v2.1/wadl/os-server-password-v2.1.wadl
@@ -22,6 +22,7 @@
                         <resource id="os-server-password"
                             path="os-server-password">
                             <method href="#getPassword"/>
+                            <method href="#clearPassword"/>
                         </resource>
                     </resource>
                 </resource>
@@ -31,12 +32,14 @@
     <method name="GET" id="getPassword">
         <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN"
             title="Get server password">
-            <para role="shortdesc">Gets the administrative password
-                for a server.</para>
+            <para role="shortdesc">
+                Gets the administrative password for a server.
+            </para>
             <para>
-              Policy defaults enable only users with the administrative role
-              or the owner of the server to perform this operation. Cloud providers can change
-              these permissions through the <code>policy.json</code> file.
+                Policy defaults enable only users with the administrative role
+                or the owner of the server to perform this operation. Cloud
+                providers can change these permissions through the
+                <code>policy.json</code> file.
             </para>
         </wadl:doc>
         <response status="200">
@@ -50,4 +53,25 @@
             </representation>
         </response>
     </method>
+    <method name="DELETE" id="clearPassword">
+        <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN"
+            title="Clear admin password">
+            <para role="shortdesc">
+                Clears the encrypted administrative password for a server,
+                which removes it from the metadata server.
+            </para>
+            <para>
+                This action does not actually change the instance server
+                password.
+            </para>
+            <para>
+                Policy defaults enable only users with the administrative role
+                or the owner of the server to perform this operation. Cloud
+                providers can change these permissions through the
+                <code>policy.json</code> file.
+            </para>
+        </wadl:doc>
+        <response status="204">
+        </response>
+    </method>
 </application>