Updates the API reference for some share operations

Added missing `user_id` field to the response of share create,
show and manage operations.

Change-Id: I1e7244185d44bff2df85b09c4566836a26c84376
Closes-Bug: #1821837

api-ref/source/parameters.yaml

@@ -1249,6 +1249,13 @@ manage_share_server_id:
   required: true
   type: string
   min_version: 2.49
+managed_share_user_id:
+  description: |
+    ID of the user who brought the share under manila management.
+  in: body
+  required: true
+  type: string
+  min_version: 2.16
 maxTotalReplicaGigabytes:
     description: |
       The maximum number of replica gigabytes that are allowed in a project.
@@ -2566,6 +2573,13 @@ share_unmanage:
   in: body
   required: true
   type: string
+share_user_id:
+  description: |
+    ID of the user that the share was created by.
+  in: body
+  required: true
+  type: string
+  min_version: 2.16
 shrink:
   description: |
     The ``shrink`` object.

api-ref/source/samples/share-manage-response.json

@@ -25,6 +25,7 @@
         "metadata": {},
         "status": "manage_starting",
         "description": "Lets manage share.",
+        "user_id": "66ffd308757e44b9a8bec381322b0b88",
         "host": "manila2@unmanage1#UNMANAGE1",
         "access_rules_status": "active",
         "has_replicas": false,

api-ref/source/samples/share-show-response.json

@@ -30,6 +30,7 @@
         "progress": "100%",
         "description": "My custom share London",
         "host": "manila2@generic1#GENERIC1",
+        "user_id": "66ffd308757e44b9a8bec381322b0b88",
         "access_rules_status": "active",
         "has_replicas": false,
         "replication_type": null,

api-ref/source/samples/share-update-response.json

@@ -35,6 +35,7 @@
         "name": "share_London",
         "created_at": "2015-09-18T10:25:24.000000",
         "share_proto": "NFS",
-        "volume_type": "default"
+        "volume_type": "default",
+        "user_id": "66ffd308757e44b9a8bec381322b0b88"
     }
 }

api-ref/source/samples/shares-list-detailed-response.json

@@ -32,6 +32,7 @@
             "task_state": null,
             "is_public": true,
             "snapshot_support": true,
+            "user_id": "66ffd308757e44b9a8bec381322b0b88",
             "name": "my_share4",
             "has_replicas": false,
             "replication_type": null,
@@ -76,6 +77,7 @@
             "has_replicas": false,
             "replication_type": null,
             "created_at": "2015-09-16T17:26:28.000000",
+            "user_id": "66ffd308757e44b9a8bec381322b0b88",
             "share_proto": "NFS",
             "volume_type": "default"
         }

api-ref/source/shares.inc

@@ -237,6 +237,7 @@ Response parameters
    - share_proto: share_proto
    - volume_type: volume_type
    - count: count
+   - user_id: share_user_id
 
 Response example
 ----------------
@@ -308,6 +309,7 @@ Response parameters
    - created_at: created_at
    - share_proto: share_proto
    - volume_type: volume_type
+   - user_id: share_user_id
 
 Response example
 ----------------
@@ -398,6 +400,7 @@ Response parameters
    - share_server_id: share_server_id
    - snapshot_support: snapshot_support
    - created_at: created_at
+   - user_id: share_user_id
 
 Response example
 ----------------
@@ -496,6 +499,7 @@ Response parameters
    - created_at: created_at
    - share_proto: share_proto
    - volume_type: volume_type
+   - user_id: managed_share_user_id
 
 Response example
 ----------------
@@ -587,6 +591,7 @@ Response parameters
    - created_at: created_at
    - share_proto: share_proto
    - volume_type: volume_type
+   - user_id: share_user_id
 
 Response example
 ----------------