OpenSearch/docs/java-rest/high-level/ml/delete-expired-data.asciidoc

42 lines
1.3 KiB
Plaintext

--
:api: delete-expired-data
:request: DeleteExpiredRequest
:response: DeleteExpiredResponse
--
[role="xpack"]
[id="{upid}-{api}"]
=== Delete expired data API
Deletes expired {ml} data.
The API accepts a +{request}+ and responds
with a +{response}+ object.
[id="{upid}-{api}-request"]
==== Delete expired data request
A `DeleteExpiredDataRequest` object does not require any arguments.
["source","java",subs="attributes,callouts,macros"]
---------------------------------------------------
include-tagged::{doc-tests-file}[{api}-request]
---------------------------------------------------
<1> Constructing a new request.
<2> Optionally set a job ID. Use `null` for the default wild card all `*`.
<3> Providing requests per second throttling for the
deletion processes. Default is no throttling.
<4> Setting how long the deletion processes will be allowed
to run before they are canceled. Default value is `8h` (8 hours).
[id="{upid}-{api}-response"]
==== Delete expired data response
The returned +{response}+ object indicates the acknowledgement of the request:
["source","java",subs="attributes,callouts,macros"]
---------------------------------------------------
include-tagged::{doc-tests-file}[{api}-response]
---------------------------------------------------
<1> `getDeleted` acknowledges the deletion request.
include::../execution.asciidoc[]