Changes between Version 21 and Version 22 of NewTestbedAPISpec


Ignore:
Timestamp:
Sep 11, 2013 11:01:24 AM (11 years ago)
Author:
faber
Comment:

Project updates

Legend:

Unmodified
Added
Removed
Modified

  • NewTestbedAPISpec

    v21 v22  
    423423     * Members - an array of structures containing
    424424       * Userid - a member's userid
    425        * rights - a 32-bit integer encoding the user's rights (each a flag)
     425       * Permissions - a list of strings encoding the user's rights (each a flag, if present the user has the right)
    426426         * ADD_USER - right to add a user to this project
    427427         * REMOVE_USER - right to remove a user from this project
    … …  
    443443   * ProjectID - the project
    444444   * Uids - the userids to add
    445    * Perms - the permissions to grant the user in this project.  The values are given here.
     445   * Perms - a list of strings giving the permissions to grant the user in this project.  The values are the same as in viewProjects.
    446446   * urlPrefix - a prefix to direct the user to a specific web interface to respond to the challenge.
    447447 * '''Return Values:'''
    … …  
    460460   * true if the user was added.  A fault is thrown on errors.
    461461
     462Once the confirmation is received, the user is actually a member of the project.  If challenges are not responded to in 48 hours, they are no longer valid.
     463
    462464Administrators can add users without going through the confirmation process:
    463465
    … …  
    467469   * ProjectID - the project
    468470   * Uids - the userids to add
    469    * Perms - the permissions to grant the user in this project.  The values are given here.
     471   * Perms - a list of strings that define the user's rights.  They are the same strings as in viewProjects.
    470472 * '''Return Values:'''
    471473   * A list of results of the form
    … …  
    492494 * '''Input Parameters:'''
    493495   * ChallengeID - the challenge being responded to
    494    * Perms - the permissions to grant the user in this project.  The values are given here.
    495  * '''Return Values:'''
    496    * true if the user was subsequently added.  A fault is thrown on errors.
     496   * Perms - a list of strings defining the permissions to grant the user in this project.  The values are as in viewProjects.
     497 * '''Return Values:'''
     498   * true if the user was successfully added.  A fault is thrown on errors.
    497499
    498500
    … …  
    517519   * ProjectName - the project to change
    518520   * Uids - the uids to manipulate
    519    * Rights - a 32-bit integer encoding the user's rights (each a flag)
     521   * Permissions - a list of strings encoding the user's rights (each a flag - the user is assigned the right/permission if the string is present).  The values are as in viewProjects.
    520522 * '''Return Values:'''
    521523   * A list of results of the form
    … …  
    556558       * binary/opaque
    557559     * Value - a string containing the element's value
    558      * Access - a 32-bit integer describing the access values (values at [http://www.isi.edu/~faber/tmp/doc/net/deterlab/testbed/user/UserAttribute.html Attribute's javadoc])
    559        * READ_WRITE
    560        * READ_ONLY
    561        * WRITE_ONLY (e.g., password)
     560     * Access - a string describing the access values (values [http://www.isi.edu/~faber/tmp/DeterAPI/doc/constant-values.html here])
    562561     * Optional - a flag true if the field is optional (must be present but may be empty)
    563562     * Removable - a flag true if the field can be removed
    … …  
    584583       * binary/opaque
    585584     * Value - a string containing the element's value
    586      * Access - a 32-bit integer describing the access values (values at [http://www.isi.edu/~faber/tmp/doc/net/deterlab/testbed/user/UserAttribute.html Attribute's javadoc])
    587        * READ_WRITE
    588        * READ_ONLY
    589        * WRITE_ONLY (e.g., password)
     585     * Access - a string describing the access values (Defined [http://www.isi.edu/~faber/tmp/DeterAPI/doc/constant-values.html here])
    590586     * Optional - a flag true if the field is optional (must be present but may be empty)
    591587     * Removable - a flag true if the field can be removed
    … …  
    625621   * Type - the type (STRING, INT, FLOAT, OPAQUE)
    626622   * Optional - a boolean, true if this attribute is optional
    627    * Access - an integer the user's ability to modify (READ_WRITE, READ_ONLY, WRITE_ONLY, NO_ACCESS)
     623   * Access - a string: the user's ability to modify (READ_WRITE, READ_ONLY, WRITE_ONLY, NO_ACCESS)
    628624   * Description - natural language description of the field (optional)
    629625   * Format - a regular expression describing the format (optional)
    … …  
    652648   * Type - the type (STRING, INT, FLOAT, OPAQUE)
    653649   * Optional - a boolean, true if this attribute is optional
    654    * Access - an integer the user's ability to modify (READ_WRITE, READ_ONLY, WRITE_ONLY, NO_ACCESS)
     650   * Access - a string: the user's ability to modify (READ_WRITE, READ_ONLY, WRITE_ONLY, NO_ACCESS)
    655651   * Description - natural language description of the field (optional)
    656652   * Format - a regular expression describing the format (optional)