mirror of
https://github.com/honeymoose/OpenSearch.git
synced 2025-02-05 20:48:22 +00:00
9d16a7b7f0
This change adds support for enable and disable user APIs to the high level rest client. There is a common request base class for both requests with specific requests that simplify the use of these APIs. The response for these APIs is simply an empty object so a new response class has been created for cases where we expect an empty response to be returned. Finally, the put user documentation has been moved to the proper location that is not within an x-pack sub directory and the document tags no longer contain x-pack. See #29827
47 lines
1.8 KiB
Plaintext
47 lines
1.8 KiB
Plaintext
[[java-rest-high-security-enable-user]]
|
|
=== Enable User API
|
|
|
|
[[java-rest-high-security-enable-user-execution]]
|
|
==== Execution
|
|
|
|
Enabling a disabled user can be performed using the `security().enableUser()`
|
|
method:
|
|
|
|
["source","java",subs="attributes,callouts,macros"]
|
|
--------------------------------------------------
|
|
include-tagged::{doc-tests}/SecurityDocumentationIT.java[enable-user-execute]
|
|
--------------------------------------------------
|
|
|
|
[[java-rest-high-security-enable-user-response]]
|
|
==== Response
|
|
|
|
The returned `EmptyResponse` does not contain any fields. The return of this
|
|
response indicates a successful request.
|
|
|
|
[[java-rest-high-security-enable-user-async]]
|
|
==== Asynchronous Execution
|
|
|
|
This request can be executed asynchronously:
|
|
|
|
["source","java",subs="attributes,callouts,macros"]
|
|
--------------------------------------------------
|
|
include-tagged::{doc-tests}/SecurityDocumentationIT.java[enable-user-execute-async]
|
|
--------------------------------------------------
|
|
<1> The `EnableUser` request to execute and the `ActionListener` to use when
|
|
the execution completes.
|
|
|
|
The asynchronous method does not block and returns immediately. Once the request
|
|
has completed the `ActionListener` is called back using the `onResponse` method
|
|
if the execution successfully completed or using the `onFailure` method if
|
|
it failed.
|
|
|
|
A typical listener for a `EmptyResponse` looks like:
|
|
|
|
["source","java",subs="attributes,callouts,macros"]
|
|
--------------------------------------------------
|
|
include-tagged::{doc-tests}/SecurityDocumentationIT.java[enable-user-execute-listener]
|
|
--------------------------------------------------
|
|
<1> Called when the execution is successfully completed. The response is
|
|
provided as an argument.
|
|
<2> Called in case of failure. The raised exception is provided as an argument.
|