# salt.modules.rallydev

Support for RallyDev

Added in version 2015.8.0.

Requires a `username` and a `password` in `/etc/salt/minion`:

    rallydev:
      username: myuser@example.com
      password: 123pass

salt.modules.rallydev.list_items(name)

  List items of a particular type

  CLI Examples:

      salt myminion rallydev.list_<item name>s
      salt myminion rallydev.list_users
      salt myminion rallydev.list_artifacts

salt.modules.rallydev.list_users()

  List the users

  CLI Example:

      salt myminion rallydev.list_users

salt.modules.rallydev.query_item(name, query_string, order='Rank')

  Query a type of record for one or more items. Requires a valid query string. See https://rally1.rallydev.com/slm/doc/webservice/introduction.jsp for information on query syntax.

  CLI Example:

      salt myminion rallydev.query_<item name> <query string> [<order>]
      salt myminion rallydev.query_task '(Name contains github)'
      salt myminion rallydev.query_task '(Name contains reactor)' Rank

salt.modules.rallydev.query_user(query_string, order='UserName')

  Update a user

  CLI Example:

      salt myminion rallydev.query_user '(Name contains Jo)'

salt.modules.rallydev.show_artifact(id_)

  Show an artifact

  CLI Example:

      salt myminion rallydev.show_artifact <artifact id>

salt.modules.rallydev.show_item(name, id_)

  Show an item

  CLI Example:

      salt myminion rallydev.show_<item name> <item id>

salt.modules.rallydev.show_user(id_)

  Show a user

  CLI Example:

      salt myminion rallydev.show_user <user id>

salt.modules.rallydev.update_item(name, id_, field=None, value=None, postdata=None)

  Update an item. Either a field and a value, or a chunk of POST data, may be used, but not both.

  CLI Example:

      salt myminion rallydev.update_<item name> <item id> field=<field> value=<value>
      salt myminion rallydev.update_<item name> <item id> postdata=<post data>

salt.modules.rallydev.update_user(id_, field, value)

  Update a user

  CLI Example:

      salt myminion rallydev.update_user <user id> <field> <new value>