api-ref: Parameter verification for servers-actions (4/4)

This patch fixes the parameters of the following actions.

* os-start
* os-stop
* suspend
* unlock
* unpause
* unrescue

A subsequent patch will fix the patameters and the examples
of the 'rebuild' and 'rescue' actions in servers-actions.inc.

Change-Id: I8f699c75c5cbfd9046258f593c1437b87dc9c3fe
Implements: blueprint api-ref-in-rst-pike

api-ref/source/parameters.yaml

@@ -3773,13 +3773,13 @@ OS-SRV-USG:terminated_at:
   type: string
 os-start:
   description: |
-    The action.
+    The action to start a stopped server.
   in: body
   required: true
   type: none
 os-stop:
   description: |
-    The action.
+    The action to stop a running server.
   in: body
   required: true
   type: none
@@ -4714,7 +4714,7 @@ subnet_id:
   type: string
 suspend:
   description: |
-    The action.
+    The action to suspend a server.
   in: body
   required: true
   type: none
@@ -4808,19 +4808,19 @@ type-os-assisted-volume-snapshot:
   type: string
 unlock:
   description: |
-    The action.
+    The action to unlock a locked server.
   in: body
   required: true
   type: none
 unpause:
   description: |
-    The action.
+    The action to unpause a paused server.
   in: body
   required: true
   type: none
 unrescue:
   description: |
-    The action.
+    The action to unrescue a server in rescue mode.
   in: body
   required: true
   type: none