Showing Roles

Use the ShowRoles endpoint to retrieve a list of roles you can assign to your users, and the number of users assigned to each role.

https://www.glance.net/PAPI/ShowRoles.asp

Parameters

Be sure to include the required authentication parameters with each request. This request takes no other parameters.

Responses

Each ShowRoles request returns an XML response document.

If your request fails, it returns a failure document, described here. The most likely reason for a ShowRoles request to fail is an authentication failure.

If your request succeeds the document contains the requested information. It looks something like this example. Each role is represented by a <role> item. The <name> of the role is shown along with counts of <activeusers> assigned to that role, <inactiveusers> and total <users>. Inactive users are users formerly associated with the partner group, but have been deprovisioned.

When users have no role assigned, they are included in the item with the of ‘-none-’.

<?xml version="1.0" standalone="yes"?>
<response>
  <status>OK</status>
  <roles>
    <role>
      <name>-none-</name>
      <activeusers>145</activeusers>
      <inactiveusers>17</inactiveusers>
      <users>162</users>
    </role>
    <role>
      <name>Role 2</name>
      <activeusers>1</activeusers>
      <inactiveusers>0</inactiveusers>
      <users>1</users>
    </role>
    <role>
      <name>Role-3</name>
      <activeusers>0</activeusers>
      <inactiveusers>1</inactiveusers>
      <users>1</users>
    </role>
    <role>
      <name>Role1</name>
      <activeusers>1</activeusers>
      <inactiveusers>2</inactiveusers>
      <users>3</users>
    </role>
  </roles>
</response>
Info

Only roles with users provisioned (active or inactive) will be returned. If a role does not have any users, it will not be returned.