<div dir="ltr">I just noticed you suggested "<verb> <subject>"; if that's the prevailing form, then I'd suggest "Change password (self-service)".<br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Dec 8, 2015 at 9:31 PM, Dolph Mathews <span dir="ltr"><<a href="mailto:dolph.mathews@gmail.com" target="_blank">dolph.mathews@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">This is implemented as a "self-service user password change" on the v2 public API. The user is required to have a token for the password they are changing, and is required to know the original password before a new one can be set.<div><br></div><div>There is a similar "administrative password reset" call on the v2 admin API (contrib.admin_crud) which does not require the original password:<div><br></div><div> <a href="https://github.com/openstack/keystone/blob/master/keystone/contrib/admin_crud/core.py#L104-L114" target="_blank">https://github.com/openstack/keystone/blob/master/keystone/contrib/admin_crud/core.py#L104-L114</a></div></div></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Dec 8, 2015 at 8:56 PM, Ken'ichi Ohmichi <span dir="ltr"><<a href="mailto:ken1ohmichi@gmail.com" target="_blank">ken1ohmichi@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Keystone-team,<br>
<br>
TL;DR:<br>
Keystone v2 API supports PATCH on '/OS-KSCRUD/users/{user_id}',<br>
What should we name the operation for?<br>
<br>
We are adding the api-site link to Tempest docstring for explaining<br>
how to use each REST APIs of each project.<br>
This work comes from previous discussion on openstack-dev[1].<br>
We can find problems on Tempest and the api-site and solve them, that<br>
is good thing for improving the quality.<br>
During this work[2], we are facing a problem difficult to distinguish<br>
what title is the best for OS-KSCRUD extension on Keystone v2 API.<br>
<br>
Keystone v2 API provides an API on "OS-KSCRUD/users/<user-id>" with PATCH.<br>
That seems "Update user" from REST design, but according to the<br>
following Keystone implementation, that seems "Set user password".<br>
<br>
keystone/contrib/user_crud/core.py<br>
131 mapper.connect('/OS-KSCRUD/users/{user_id}',<br>
132 controller=user_controller,<br>
133 action='set_user_password', <HERE><br>
134 conditions=dict(method=['PATCH']))<br>
<br>
Which is the best for this API?<br>
<br>
The api-site doesn't contain this API description[3], so it will be<br>
great to get feedback for improving both the api-site and Tempest.<br>
<br>
Thanks<br>
Ken Ohmichi<br>
<br>
---<br>
[1]: <a href="http://lists.openstack.org/pipermail/openstack-dev/2015-July/068864.html" rel="noreferrer" target="_blank">http://lists.openstack.org/pipermail/openstack-dev/2015-July/068864.html</a><br>
[2]: <a href="https://review.openstack.org/#/c/253806/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/253806/</a><br>
[3]: <a href="https://bugs.launchpad.net/openstack-api-site/+bug/1524153" rel="noreferrer" target="_blank">https://bugs.launchpad.net/openstack-api-site/+bug/1524153</a><br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</blockquote></div><br></div>
</div></div></blockquote></div><br></div></div>