This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
Get specific role API
editGet specific role API
edit[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Retrieve a specific role.
Prerequisite
editTo use the get specific role API, you must have the manage_security
cluster privilege.
Request
editGET <kibana host>:<port>/api/security/role/my_restricted_kibana_role
Response code
edit-
200
- Indicates a successful call.
Example
editThe API returns the following:
{ "name": "my_restricted_kibana_role", "description": "My restricted kibana role description", "metadata" : { "version" : 1 }, "transient_metadata": { "enabled": true }, "elasticsearch": { "cluster": [ ], "indices": [ ], "run_as": [ ] }, "kibana": [ { "base": [ "read" ], "feature": {}, "spaces": [ "marketing" ] }, { "base": [], "feature": { "discover": [ "all" ], "visualize": [ "all" ], "dashboard": [ "all" ], "dev_tools": [ "read" ], "advancedSettings": [ "read" ], "indexPatterns": [ "read" ], "graph": [ "all" ], "apm": [ "read" ], "maps": [ "read" ], "canvas": [ "read" ], "infrastructure": [ "all" ], "logs": [ "all" ], "uptime": [ "all" ] }, "spaces": [ "sales", "default" ] } ] }