Add documentation on how to set a user's tenant.

Change-Id: I61b98891336ca1ed096f013ff1ed1a89d7854886
Closes-Bug: #1609161

api-ref/source/v2-admin/admin-users.inc

@@ -132,6 +132,7 @@ Request
    - enabled: enabled
    - email: email
    - name: name
+   - tenantId: tenantId
 
 Request Example
 ---------------
@@ -149,6 +150,7 @@ Response Parameters
    - email: email
    - name: name
    - id: id
+   - tenantId: tenantId
 
 Response Example
 ----------------

api-ref/source/v2-admin/samples/admin/user-update-request.json

@@ -1,5 +1,6 @@
 {
     "user": {
-        "email": "updated_email@example.org"
+        "email": "updated_email@example.org",
+        "tenantId": "1ca8e0"
     }
 }

api-ref/source/v2-admin/samples/admin/user-update-response.json

@@ -4,6 +4,7 @@
         "name": "demo",
         "email": "updated_email@example.org",
         "username": "demo",
-        "enabled": true
+        "enabled": true,
+        "tenantId": "1ca8e0"
     }
 }

api-ref/source/v2-ext/ksadm-admin.inc

@@ -92,6 +92,50 @@ Response Example
    :language: javascript
 
 
+Update user tenant
+==================
+
+.. rest_method:: PUT /v2.0/users/{userId}/OS-KSADM/tenant
+
+Sets a user's tenant
+
+Normal response codes: 200
+
+Error response codes: 413, 415, 405, 404, 403, 401, 400, 503, 409
+
+Request
+-------
+
+.. rest_parameters:: parameters.yaml
+
+   - userId: userId
+   - tenantId: tenantId
+
+Request Example
+---------------
+
+.. literalinclude:: samples/OS-KSADM/user-update-tenant-request.json
+   :language: javascript
+
+Response Parameters
+-------------------
+
+.. rest_parameters:: parameters.yaml
+
+   - email: email
+   - enabled: enabled
+   - tenantId: tenantId
+   - id: id
+   - name: name
+   - username: username
+
+Response Example
+----------------
+
+.. literalinclude:: samples/OS-KSADM/user-show-response.json
+   :language: javascript
+
+
 Create service (admin extension)
 ================================
 

api-ref/source/v2-ext/samples/OS-KSADM/user-show-response.json

@@ -4,6 +4,7 @@
         "name": "admin",
         "email": "admin@example.org",
         "username": "admin",
-        "enabled": true
+        "enabled": true,
+        "tenantId": "1ca8e0"
     }
 }

api-ref/source/v2-ext/samples/OS-KSADM/user-update-tenant-request.json

@@ -0,0 +1,5 @@
+{
+    "user": {
+        "tenantId": "1ca8e0"
+    }
+}