/auth/v1/roles/<role_ID >: GET

Gets the details of a specific user role.

The following table shows which roles can access this REST API endpoint:
Table 1. Access by role
Data admin Data user Collection Admin Admin Service user
✓1 ✓1 ✓1 ✓ ✓1
1The specified role must be one that is assigned to the requesting user ID. Otherwise the command fails with error 403, "Not authorized".

Synopsis of the request URL

curl -k  -H ‘Authorization: Bearer <token>’ https://<spectrum_discover_host>/auth/v1/roles/<role_ID>

Supported request types and response formats

Supported request types:
  • GET
Supported response formats:
  • JSON

Examples

The following example shows how to get the details of a specific user role.

Request: 
curl -k  -H ‘Authorization: Bearer <token>’ https://<spectrum_discover_host>/auth/v1/roles/4a5415cb9cc5460aafe12a6f6206448e

Response:

200 (OK): 
{ 
    "domain_id": null, 
    "id": "4a5415cb9cc5460aafe12a6f6206448e", 
    "name": "datauser" 
}