v2 api: change update user

The PUT /v2.0/users/{userId} route is unnecessarily in the OS-KSADM APIs,
it's not part of that extension. It is already defined correctly in the
v2-admin APIs.

Further, the update example is the v2-ext docs was a bit nicer, so use
that one, update the request and response for that route. Delete the
example in v2-ext since nothing else uses it.

Route link: https://github.com/openstack/keystone/blob/master/keystone/v2_crud/admin_crud.py#L93-L97

Change-Id: I14bdf9a3b4c09a7b48cc52b0ff32f72dcb115178

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

@@ -127,6 +127,7 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
+   - userId: userId
    - username: username
    - enabled: enabled
    - email: email
@@ -144,11 +145,18 @@ Response Parameters
 
 .. rest_parameters:: parameters.yaml
 
+   - users: users
    - enabled: enabled
    - email: email
    - name: name
    - id: id
 
+Response Example
+----------------
+
+.. literalinclude:: samples/admin/user-update-response.json
+   :language: javascript
+
 
 Delete user (admin endpoint)
 ============================

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

@@ -1,9 +1,9 @@
 {
     "user": {
-        "username": "nova",
-        "name": "nova",
-        "enabled": true,
-        "email": null,
-        "id": "405ecdef1a434c70bb1e441cd295245d"
+        "id": "3c9530e",
+        "name": "admin",
+        "email": "admin@example.org",
+        "username": "admin",
+        "enabled": true
     }
 }

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

@@ -1,8 +1,5 @@
 {
     "user": {
-        "username": "nova",
-        "name": "nova",
-        "enabled": false,
-        "email": null
+        "email": "updated_email@example.org"
     }
 }

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

@@ -0,0 +1,9 @@
+{
+    "user": {
+        "id": "a0ae37b",
+        "name": "demo",
+        "email": "updated_email@example.org",
+        "username": "demo",
+        "enabled": true
+    }
+}

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

@@ -571,47 +571,6 @@ Request
    - roleId: roleId
 
 
-Update user (admin extension)
-=============================
-
-.. rest_method::  PUT /v2.0/users/{userId}
-
-Updates a user.
-
-Normal response codes: 200
-Error response codes: 413,415,405,404,403,401,400,503,409
-
-Request
--------
-
-.. rest_parameters:: parameters.yaml
-
-   - userId: userId
-
-Request Example
----------------
-
-.. literalinclude:: samples/OS-KSADM/user-update-request.json
-   :language: javascript
-
-Response Parameters
--------------------
-
-.. rest_parameters:: parameters.yaml
-
-   - users: users
-   - enabled: enabled
-   - email: email
-   - name: name
-   - id: id
-
-Response Example
-----------------
-
-.. literalinclude:: samples/OS-KSADM/user-show-response.json
-   :language: javascript
-
-
 Delete user (admin extension)
 =============================
 

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

@@ -1,8 +0,0 @@
-{
-    "user": {
-        "id": "u1000",
-        "name": "jqsmith",
-        "email": "john.smith@example.org",
-        "enabled": true
-    }
-}