Changes between Version 8 and Version 9 of NewTestbedAPISpec


Ignore:
Timestamp:
Jul 21, 2013 7:48:18 AM (11 years ago)
Author:
faber
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • NewTestbedAPISpec

    v8 v9  
    254254   * None
    255255
    256 === Creation ===
     256=== Creation and Deletion ===
    257257
    258258Finally a user can request access to the testbed by creating a profile.  The user has no privileges and consumes minimal resources until they join a vetted project.  This is an unauthenticated call, but the user profile is not created until an automated e-mail exchange is made between the testbed and the proto-user.
    259259
    260260 * '''Service:''' Users
    261  * '''Operation:''' getProfileDescription
    262  * '''Input Parameters:'''
    263    * Userid - the requested userid
     261 * '''Operation:''' createUser
     262 * '''Input Parameters:'''
     263   * Userid - the requested userid (optional)
    264264   * A list of profile elements each containing
    265265     * Name - a string, the element's name
    266266     * StringValue - a string containing the element's value, unless it is binary/opaque
    267267 * '''Return Values:'''
    268   * None
     268  * The userid actually created
    269269
    270270Note that all non-optional fields must be provided, so this is best preceeded by a call to getProfileDescription to learn the fields.
     271
     272A base userid is constructed, either from the userid presented or from a required field in the profile.  If that base userid is available, that a user with that userid is created.  Otherwise the userid is disambiguated until there are no collisions.  The userid actually created is returned.
     273
     274The user is created without membership in any projects and without a password.  A password reset challenge (equivalent to one issued by requestPasswordReset) is issued and the challenge e-mailed to the user at the address in the profile.
     275
     276Removing a user is accomplished using
     277 * '''Service:''' Users
     278 * '''Operation:''' removeUser
     279 * '''Input Parameters:'''
     280   * Userid - the requested userid
     281 * '''Return Values:'''
     282  * a boolean, true if the user was removed
     283
     284Most users are unlikely to use this service, and policy may allow only administrators to remove users.
    271285
    272286== Projects ==