The GET method with a role ID retrieves a single role descriptor containing the role properties.
| • | In the community edition of the server, or commercial editions without organizations, use the first form of the URL. |
| • | In commercial editions with organizations, use the second URL to specify the role’s organization. When specifying the organization, use its unique ID, not its path. When logged in as the system admin (superuser), use the first URL to specify roles of the root organization. |
|
Method |
URL |
||
|
GET |
http://<host>:<port>/jasperserver[-pro]/rest_v2/roles/roleID http://<host>:<port>/jasperserver[-pro]/rest_v2/organizations/orgID/roles/roleID |
||
|
Options |
|||
|
accept: application/xml (default) accept: application/json |
|||
|
Return Value on Success |
Typical Return Values on Failure |
||
|
200 OK – The content is the descriptor for the given role. |
404 Not Found – When the role ID or organization ID does not match any role or organization. The content includes an error message. |
||
After adding roles to an organization, the following example shows the simple role descriptor for an organization role in JSON format:
GET http://localhost:8080/jasperserver-pro/rest_v2/organizations/Finance/rol...
{
"name":"ROLE_MANAGER",
"externallyDefined":false,
"tenantId":"Finance"
} |
