mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-04-25 07:37:19 -04:00
5c75d004fa
Co-authored-by: debadair <debadair@elastic.co> Co-authored-by: Lisa Cawley <lcawley@elastic.co> Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
37 lines
1.1 KiB
Text
37 lines
1.1 KiB
Text
|
|
--
|
|
:api: put-role
|
|
:request: PutRoleRequest
|
|
:response: PutRoleResponse
|
|
--
|
|
[role="xpack"]
|
|
[id="{upid}-{api}"]
|
|
=== Create or update role API
|
|
|
|
[id="{upid}-{api}-request"]
|
|
==== Request
|
|
|
|
The +{request}+ class is used to create or update a role in the Native Roles
|
|
Store. The request contains a single role, which encapsulates privileges over
|
|
resources. A role can be assigned to an user using the
|
|
<<{upid}-put-role-mapping,Create or update role mapping API>>.
|
|
|
|
["source","java",subs="attributes,callouts,macros"]
|
|
--------------------------------------------------
|
|
include-tagged::{doc-tests-file}[{api}-request]
|
|
--------------------------------------------------
|
|
|
|
include::../execution.asciidoc[]
|
|
|
|
[id="{upid}-{api}-response"]
|
|
==== Response
|
|
|
|
The returned +{response}+ contains a single field, `created`. This field
|
|
serves as an indication if the role was created or if an existing entry was
|
|
updated.
|
|
|
|
["source","java",subs="attributes,callouts,macros"]
|
|
--------------------------------------------------
|
|
include-tagged::{doc-tests-file}[{api}-response]
|
|
--------------------------------------------------
|
|
<1> `created` is a boolean indicating whether the role was created or updated
|