GET /roles/<rid>

Fetches information about a single role indentified by its role ID (rid). Authentication is required.

Request format

When Forming RBAC API requests to this endpoint, provide authentication and specify a role ID, such as:

curl "https://$(puppet config print server):4433/rbac-api/v1/roles/1234" -H "X-Authentication:$(puppet-access show)"

Response format

Returns a 200 OK response with a JSON object containing information about the requested role. For example:

{"id": 123,
 "permissions": [{"object_type":"node_groups",
                  "action":"edit_rules",
                  "instance":"*"}, ...],
 "user_ids": ["1cadd0e0-5887-11e4-8ed6-0800200c9a66","5c1ab4b0-588b-11e4-8ed6-0800200c9a66"],
 "group_ids": ["2ca57e30-5887-11e4-8ed6-0800200c9a66"],
 "display_name": "A role",
 "description": "Edit node group rules"}

For information about keys in the response, refer to User roles endpoints keys.

For error responses, refer to RBAC service errors .