api-ref: fix description for subnetpools

Adds/corrects the description request/response parameter as
applicable to core resources (see defect).

Change-Id: I397a05f17527fde31f657e381775a0bf998455a8
Closes-Bug: #1553653

api-ref/source/v2/parameters.yaml

@@ -4748,18 +4748,6 @@ subnetpool:
   in: body
   required: true
   type: object
-subnetpool_description_request:
-  description: |
-      Description of the subnetpool.
-  in: body
-  required: false
-  type: string
-subnetpool_description_response:
-  description: |
-    Description of the subnetpool.
-  in: body
-  required: true
-  type: string
 subnetpool_id_body:
   description: |
     The ID of the subnet.

api-ref/source/v2/samples/subnets/subnetpool-create-response.json

@@ -15,6 +15,7 @@
             "192.168.0.0/16"
         ],
         "ip_version": 4,
-        "shared": false
+        "shared": false,
+        "description": ""
     }
 }

api-ref/source/v2/subnetpools.inc

@@ -51,7 +51,7 @@ Response Parameters
    - shared: shared
    - default_prefixlen: default_prefixlen
    - max_prefixlen: max_prefixlen
-   - description: subnetpool_description_response
+   - description: description
    - is_default: subnetpool_is_default
    - revision_number: subnetpool_revision_number
 
@@ -88,7 +88,7 @@ Request
    - address_scope_id: address_scope_id
    - default_prefixlen: default_prefixlen
    - max_prefixlen: max_prefixlen
-   - description: subnetpool_description_request
+   - description: description-request
 
 Request Example
 ---------------
@@ -116,7 +116,7 @@ Response Parameters
    - shared: shared
    - default_prefixlen: default_prefixlen
    - max_prefixlen: max_prefixlen
-   - description: subnetpool_description_response
+   - description: description
    - is_default: subnetpool_is_default
    - revision_number: subnetpool_revision_number
 
@@ -199,7 +199,7 @@ Response Parameters
    - shared: shared
    - default_prefixlen: default_prefixlen
    - max_prefixlen: max_prefixlen
-   - description: subnetpool_description_response
+   - description: description
    - is_default: subnetpool_is_default
    - revision_number: subnetpool_revision_number
 
@@ -236,7 +236,7 @@ Request
    - shared: shared
    - default_prefixlen: default_prefixlen
    - max_prefixlen: max_prefixlen
-   - description: subnetpool_description_request
+   - description: description-request
 
 Request Example
 ---------------
@@ -264,6 +264,6 @@ Response Parameters
    - shared: shared
    - default_prefixlen: default_prefixlen
    - max_prefixlen: max_prefixlen
-   - description: subnetpool_description_response
+   - description: description
    - is_default: subnetpool_is_default
    - revision_number: subnetpool_revision_number