Correct sort_key and sort_dir parameter for flavor

This commits define new parameter sort_key_flavor
and sort_dir_flavor for flavor List API and define
the correct default values for those.

Partially implements blueprint api-ref-in-rst

Change-Id: I2915a5bccebfeddf66c825b0272af86e3fd7da19

api-ref/source/flavors.inc

@@ -26,8 +26,8 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-  - sort_key: sort_key
-  - sort_dir: sort_dir
+  - sort_key: sort_key_flavor
+  - sort_dir: sort_dir_flavor
   - limit: limit
   - marker: marker
   - minDisk: minDisk
@@ -128,8 +128,8 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-  - sort_key: sort_key
-  - sort_dir: sort_dir
+  - sort_key: sort_key_flavor
+  - sort_dir: sort_dir_flavor
   - limit: limit
   - marker: marker
   - minDisk: minDisk

api-ref/source/parameters.yaml

@@ -651,7 +651,16 @@ server_status_query:
   in: query
   required: false
   type: string
-sort_dir:
+sort_dir_flavor:
+  description: |
+    Sort direction. A valid value is ``asc`` (ascending) or ``desc`` (descending).
+    Default is ``asc``. You can specify multiple pairs of sort key and sort direction
+    query parameters. If you omit the sort direction in a pair, the API uses the natural
+    sorting direction of the direction of the flavor ``sort_key`` attribute.
+  in: query
+  required: false
+  type: string
+sort_dir_server:
   description: |
     Sort direction. A valid value is ``asc`` (ascending) or ``desc`` (descending).
     Default is ``desc``. You can specify multiple pairs of sort key and sort direction
@@ -660,7 +669,16 @@ sort_dir:
   in: query
   required: false
   type: string
-sort_key:
+sort_key_flavor:
+  description: |
+    Sorts by a flavor attribute. Default attribute is ``flavorid``. You can specify
+    multiple pairs of sort key and sort direction query parameters. If you omit the
+    sort direction in a pair, the API uses the natural sorting direction of the flavor
+    ``sort_key`` attribute.
+  in: query
+  required: false
+  type: string
+sort_key_server:
   description: |
     Sorts by a server attribute. Default attribute is ``created``. You can specify
     multiple pairs of sort key and sort direction query parameters. If you omit the

api-ref/source/servers.inc

@@ -159,8 +159,8 @@ Request
 
   - limit: limit
   - marker: marker
-  - sort_key: sort_key
-  - sort_dir: sort_dir
+  - sort_key: sort_key_server
+  - sort_dir: sort_dir_server
   - changes-since: changes_since_server
   - image: image_query
   - flavor: flavor_query
@@ -462,8 +462,8 @@ Request
 
   - limit: limit
   - marker: marker
-  - sort_key: sort_key
-  - sort_dir: sort_dir
+  - sort_key: sort_key_server
+  - sort_dir: sort_dir_server
   - changes-since: changes_since_server
   - image: image_query
   - flavor: flavor_query