[api-ref] Refactor manila extension API

This patch refactors manila extension API to make it clear
to understand and maintain.

Change-Id: I35b8b135acc02238daf7c2fb9f42bf276806f7d8

api-ref/source/extensions.inc

@@ -22,18 +22,18 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-   - tenant_id: tenant_id_1
+   - tenant_id: tenant_id_path
 
 Response parameters
 -------------------
 
 .. rest_parameters:: parameters.yaml
 
-   - name: name_10
+   - name: extension_name
-   - links: links_2
+   - links: extension_links
-   - description: description_8
+   - description: extension_description
-   - alias: alias
+   - alias: extension_alias
-   - updated: updated
+   - updated: extension_updated
 
 Response example
 ----------------

api-ref/source/parameters.yaml

@@ -1269,6 +1269,50 @@ extend:
   in: body
   required: true
   type: object
+extension_alias:
+  description: |
+    The alias for the extension. For example,
+    "FOXNSOX", "os-availability-zone", "os-extended-quotas", "os-
+    share-unmanage", or "os-used-limits".
+  in: body
+  required: true
+  type: string
+extension_description:
+  description: |
+    The extension description.
+  in: body
+  required: true
+  type: string
+extension_links:
+  description: |
+    The extension links.
+  in: body
+  required: true
+  type: array
+extension_name:
+  description: |
+    The name of the extension. For example, "Fox In Socks."
+  in: body
+  required: true
+  type: string
+extension_updated:
+  description: |
+    The date and time stamp when the extension was last updated.
+
+    The date and time stamp format is `ISO 8601
+    <https://en.wikipedia.org/wiki/ISO_8601>`_:
+
+    ::
+
+       CCYY-MM-DDThh:mm:ss±hh:mm
+
+    The ``±hh:mm`` value, if included, returns the time zone as an
+    offset from UTC.
+
+    For example, ``2015-08-27T09:49:58-05:00``.
+  in: body
+  required: true
+  type: string
 extra-spec-key:
   description: |
     The extra specification key