Add upload-only parameter to dcmanager api-ref docs

Updates the api-ref parameter list and the request/response examples
to include the new upload-only option from the DC patch orchestration
strategy.

Story: 2010584
Task: 47650

Signed-off-by: Gustavo Herzmann <gustavo.herzmann@windriver.com>
Change-Id: I2bba78d5db1a876df3324a333925a9f75fdd8625

api-ref/source/api-ref-dcmanager-v1.rst

@@ -1204,6 +1204,7 @@ serviceUnavailable (503)
   - stop-on-failure: stop_on_failure
   - subcloud-apply-type: subcloud_apply_type
   - type: sw_update_strategy_type
+  - upload-only: patch_strategy_upload_only
 
 Request Example
 ----------------

api-ref/source/parameters.yaml

@@ -304,6 +304,13 @@ openstack_installed:
   in: body
   required: true
   type: boolean
+patch_strategy_upload_only:
+  description: |
+    Flag to indicate whether patches should only be uploaded to the subclouds
+    or not. This parameter is only used by 'patch' type strategies.
+  in: body
+  required: false
+  type: boolean
 region_name:
   description: |
     The name provisioned for the subcloud (synonym for subcloud name).

api-ref/source/samples/sw-update-strategy/sw-update-strategy-get-response.json

@@ -5,7 +5,9 @@
   "stop-on-failure": true,
   "max-parallel-subclouds": "2",
   "subcloud-apply-type": "serial",
-  "extra-args": null,
+  "extra-args": {
+    "upload-only": true
+  },
   "created-at": "2018-02-25T23:23:53.852473",
   "updated-at": null
 }

api-ref/source/samples/sw-update-strategy/sw-update-strategy-post-request.json

@@ -2,5 +2,6 @@
      "subcloud-apply-type": "serial",
      "type": "patch",
      "stop-on-failure": "true",
-     "max-parallel-subclouds": 2
+     "max-parallel-subclouds": 2,
+     "upload-only": "true"
 }

api-ref/source/samples/sw-update-strategy/sw-update-strategy-post-response.json

@@ -5,7 +5,9 @@
   "stop-on-failure": true,
   "max-parallel-subclouds": "2",
   "subcloud-apply-type": "serial",
-  "extra-args": null,
+  "extra-args": {
+    "upload-only": true
+  },
   "created-at": "2018-02-25T23:23:53.852473",
   "updated-at": null
 }