mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-30 10:23:41 -04:00
7242267f5d
This PR adds the reference documentation pages of the data frame analytics APIs (PUT, START, STOP, GET, GET stats, DELETE, Evaluate) to the ML APIs pool.
61 lines
No EOL
1.7 KiB
Text
61 lines
No EOL
1.7 KiB
Text
[role="xpack"]
|
|
[testenv="platinum"]
|
|
[[start-dfanalytics]]
|
|
=== Start {dfanalytics-jobs} API
|
|
|
|
[subs="attributes"]
|
|
++++
|
|
<titleabbrev>Start {dfanalytics-jobs}</titleabbrev>
|
|
++++
|
|
|
|
experimental[]
|
|
|
|
Starts a {dfanalytics-job}.
|
|
|
|
[[ml-start-dfanalytics-request]]
|
|
==== {api-request-title}
|
|
|
|
`POST _ml/data_frame/analytics/<data_frame_analytics_id>/_start`
|
|
|
|
[[ml-start-dfanalytics-prereq]]
|
|
==== {api-prereq-title}
|
|
|
|
* You must have `machine_learning_admin` built-in role to use this API. You must
|
|
also have `read` and `view_index_metadata` privileges on the source index and
|
|
`read`, `create_index`, and `index` privileges on the destination index. For
|
|
more information, see {stack-ov}/security-privileges.html[Security privileges]
|
|
and {stack-ov}/built-in-roles.html[Built-in roles].
|
|
|
|
[[ml-start-dfanalytics-path-params]]
|
|
==== {api-path-parms-title}
|
|
|
|
`<data_frame_analytics_id>` (Required)::
|
|
(string) Identifier for the {dfanalytics-job}. This identifier can contain
|
|
lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It
|
|
must start and end with alphanumeric characters.
|
|
|
|
`timeout` (Optional)::
|
|
(time) Controls the amount of time to wait until the {dfanalytics-job} starts.
|
|
The default value is 20 seconds.
|
|
|
|
[[ml-start-dfanalytics-example]]
|
|
==== {api-examples-title}
|
|
|
|
The following example starts the `loganalytics` {dfanalytics-job}:
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
POST _ml/data_frame/analytics/loganalytics/_start
|
|
--------------------------------------------------
|
|
// CONSOLE
|
|
// TEST[skip:setup:logdata_job]
|
|
|
|
When the {dfanalytics-job} starts, you receive the following results:
|
|
|
|
[source,js]
|
|
----
|
|
{
|
|
"acknowledged" : true
|
|
}
|
|
----
|
|
// TESTRESPONSE |