Merge "Fix discrepancy in api-ref for volume_types APIs"

api-ref/source/v3/parameters.yaml

@@ -1043,7 +1043,7 @@ extra_specs_1:
     include capabilities, capacity, compression, and so on, depending
     on the storage driver in use.
   in: body
-  required: true
+  required: false
   type: object
 fail_reason:
   description: |
@@ -1834,6 +1834,12 @@ name_9:
   in: body
   required: true
   type: string
+name_10:
+  description: |
+    The name of the volume type.
+  in: body
+  required: false
+  type: string
 name_optional:
   description: |
     The name of the Volume Backup.

api-ref/source/v3/samples/volume-type-create-request.json

@@ -2,6 +2,9 @@
     "volume_type": {
         "name": "vol-type-001",
         "description": "volume type 0001",
-        "is_public": true,
+        "os-volume-type-access:is_public": true,
+        "extra_specs": {
+            "capabilities": "gpu"
+        }
     }
 }

api-ref/source/v3/samples/volume-type-update-request.json

@@ -2,9 +2,6 @@
     "volume_type": {
         "name": "vol-type-001",
         "description": "volume type 0001",
-        "is_public": true,
-        "extra_specs": {
-            "capabilities": "gpu"
-        }
+        "is_public": true
     }
 }

api-ref/source/v3/volumes-v3-types.inc

@@ -36,10 +36,9 @@ Request
    - project_id: project_id_path
    - volume_type_id: volume_type_id
    - volume_type: volume_type_1
-   - name: name_7
+   - name: name_10
    - description: description_15
    - is_public: is_public
-   - extra_specs: extra_specs
 
 Request Example
 ---------------
@@ -355,8 +354,9 @@ Request
    - volume_type: volume_type_1
    - project_id: project_id_path
    - name: name_7
-   - is_public: is_public
+   - os-volume-type-access:is_public: is_public
    - description: description_15
+   - extra_specs: extra_specs_1
 
 Request Example
 ---------------