Files
elasticsearch-js/docs/reference-security-get_role.asciidoc
2024-12-05 14:46:52 -06:00

72 lines
4.0 KiB
Plaintext

[[reference-security-get_role]]
////////
===========================================================================================================================
|| ||
|| ||
|| ||
|| ██████╗ ███████╗ █████╗ ██████╗ ███╗ ███╗███████╗ ||
|| ██╔══██╗██╔════╝██╔══██╗██╔══██╗████╗ ████║██╔════╝ ||
|| ██████╔╝█████╗ ███████║██║ ██║██╔████╔██║█████╗ ||
|| ██╔══██╗██╔══╝ ██╔══██║██║ ██║██║╚██╔╝██║██╔══╝ ||
|| ██║ ██║███████╗██║ ██║██████╔╝██║ ╚═╝ ██║███████╗ ||
|| ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚═════╝ ╚═╝ ╚═╝╚══════╝ ||
|| ||
|| ||
|| This file is autogenerated, DO NOT send pull requests that changes this file directly. ||
|| You should update the script that does the generation, which can be found in: ||
|| https://github.com/elastic/elastic-client-generator-js ||
|| ||
|| You can run the script with the following command: ||
|| npm run elasticsearch -- --version <version> ||
|| ||
|| ||
|| ||
===========================================================================================================================
////////
[discrete]
[[client.security.getRole]]
=== client.security.getRole
Get roles. Get roles in the native realm. The role management APIs are generally the preferred way to manage roles, rather than using file-based role management. The get roles API cannot retrieve roles that are defined in roles files.
{ref}/security-api-get-role.html[{es} documentation]
[discrete]
==== Function signature
[source,ts]
----
(SecurityGetRoleRequest, options?): Promise<SecurityGetRoleResponse>
----
[discrete]
==== Request
[pass]
++++
<pre>
++++
interface SecurityGetRoleRequest extends <<RequestBase>> {
name?: <<Names>>
}
[pass]
++++
</pre>
++++
[discrete]
==== Response
[pass]
++++
<pre>
++++
type SecurityGetRoleResponse = Record<string, SecurityGetRoleRole>
[pass]
++++
</pre>
++++