api-ref: Fix missing parameters in API Versions

Add 'updated' and 'media-types' explicitly
in parameter tables.

Change-Id: I3e9f3374d4183d7ef7d3cb55cc95a4499ab20d49
Closes-Bug: #1634668

api-ref/source/parameters.yaml

@@ -3415,6 +3415,18 @@ md5hash:
   in: body
   required: true
   type: string
+media_types:
+  description: |
+    The `media types
+    <https://www.iana.org/assignments/media-types/media-types.xhtml>`_.
+    It is an array of a fixed dict.
+
+    .. note::
+      It is vestigial and provide no useful information.
+      It will be deprecated and removed in the future.
+  in: body
+  required: true
+  type: array
 members:
   description: |
     A list of members in the server group.
@@ -5153,6 +5165,17 @@ updated_consider_null:
   in: body
   required: true
   type: string
+updated_version:
+  description: |
+    This is a fixed string. It is ``2011-01-21T11:33:21Z`` in version 2.0,
+    ``2013-07-23T11:33:21Z`` in version 2.1.
+
+    .. note::
+      It is vestigial and provides no useful information.
+      It will be deprecated and removed in the future.
+  in: body
+  required: true
+  type: string
 uptime:
   description: |
     The total uptime of the hypervisor and information about average

api-ref/source/versions.inc

@@ -44,15 +44,12 @@ Response
 
   - versions: versions
   - id: version_id
-  - status: version_status
   - links: links
-  - version: version_max
   - min_version: version_min
+  - status: version_status
+  - updated: updated_version
+  - version: version_max
 
-.. note::
-
-   The ``updated`` parameter in the response is vestigial and provides
-   no useful information.
 
 Response Example
 ----------------
@@ -94,16 +91,12 @@ Response
 
   - version: version
   - id: version_id
-  - status: version_status
   - links: links
-  - version: version_max
+  - media-types: media_types
   - min_version: version_min
-
+  - status: version_status
-.. note::
+  - updated: updated_version
-
+  - version: version_max
-   The ``updated`` and ``media-types`` parameters in the response are
-   vestigial and provide no useful information. They will probably be
-   deprecated and removed in the future.
 
 
 Response Example