mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-29 01:44:36 -04:00
b9dc522cb4
* [ML] adding for_export flag for ml plugin GET resource APIs (#63092) This adds the new `for_export` flag to the following APIs: - GET _ml/anomaly_detection/<job_id> - GET _ml/datafeeds/<datafeed_id> - GET _ml/data_frame/analytics/<analytics_id> The flag is designed for cloning or exporting configuration objects to later be put into the same cluster or a separate cluster. The following fields are not returned in the objects: - any field that is not user settable (e.g. version, create_time) - any field that is a calculated default value (e.g. datafeed chunking_config) - any field that would effectively require changing to be of use (e.g. datafeed job_id) - any field that is automatically set via another Elastic stack process (e.g. anomaly job custom_settings.created_by) closes https://github.com/elastic/elasticsearch/issues/63055 * [ML] adding new flag exclude_generated that removes generated fields in GET config APIs (#63899) When exporting and cloning ml configurations in a cluster it can be frustrating to remove all the fields that were generated by the plugin. Especially as the number of these fields change from version to version. This flag, exclude_generated, allows the GET config APIs to return configurations with these generated fields removed. APIs supporting this flag: - GET _ml/anomaly_detection/<job_id> - GET _ml/datafeeds/<datafeed_id> - GET _ml/data_frame/analytics/<analytics_id> The following fields are not returned in the objects: - any field that is not user settable (e.g. version, create_time) - any field that is a calculated default value (e.g. datafeed chunking_config) - any field that is automatically set via another Elastic stack process (e.g. anomaly job custom_settings.created_by) relates to #63055
42 lines
1.5 KiB
Text
42 lines
1.5 KiB
Text
--
|
|
:api: get-datafeed
|
|
:request: GetDatafeedRequest
|
|
:response: GetDatafeedResponse
|
|
--
|
|
[role="xpack"]
|
|
[id="{upid}-{api}"]
|
|
=== Get datafeeds API
|
|
|
|
Retrieves configuration information about {ml} datafeeds in the cluster.
|
|
It accepts a +{request}+ object and responds with a +{response}+ object.
|
|
|
|
[id="{upid}-{api}-request"]
|
|
==== Get datafeeds request
|
|
|
|
A +{request}+ object gets can have any number of `datafeedId` entries. However,
|
|
they all must be non-null. An empty list is the same as requesting for all
|
|
datafeeds.
|
|
|
|
["source","java",subs="attributes,callouts,macros"]
|
|
--------------------------------------------------
|
|
include-tagged::{doc-tests-file}[{api}-request]
|
|
--------------------------------------------------
|
|
<1> Constructing a new request referencing existing `datafeedIds`. It can
|
|
contain wildcards.
|
|
<2> Whether to ignore if a wildcard expression matches no datafeeds.
|
|
(This includes `_all` string or when no datafeeds have been specified).
|
|
<3> Optional boolean value for requesting the datafeed in a format that can
|
|
then be put into another cluster. Certain fields that can only be set when
|
|
the datafeed is created are removed.
|
|
|
|
[id="{upid}-{api}-response"]
|
|
==== Get datafeeds response
|
|
|
|
["source","java",subs="attributes,callouts,macros"]
|
|
--------------------------------------------------
|
|
include-tagged::{doc-tests-file}[{api}-response]
|
|
--------------------------------------------------
|
|
<1> The count of retrieved datafeeds.
|
|
<2> The retrieved datafeeds.
|
|
|
|
include::../execution.asciidoc[]
|