mirror of
https://github.com/elastic/kibana.git
synced 2025-04-25 02:09:32 -04:00
89 lines
No EOL
2.9 KiB
Text
89 lines
No EOL
2.9 KiB
Text
[[machine-learning-api-sync]]
|
|
=== Sync {ml} saved objects API
|
|
++++
|
|
<titleabbrev>Sync {ml} saved objects</titleabbrev>
|
|
++++
|
|
|
|
Synchronizes {kib} saved objects for {ml} jobs and trained models.
|
|
|
|
[[machine-learning-api-sync-request]]
|
|
==== {api-request-title}
|
|
|
|
`GET <kibana host>:<port>/api/ml/saved_objects/sync`
|
|
|
|
`GET <kibana host>:<port>/s/<space_id>/api/ml/saved_objects/sync`
|
|
|
|
[[machine-learning-api-sync-prereq]]
|
|
==== {api-prereq-title}
|
|
|
|
You must have `all` privileges for the *Machine Learning* feature in the *Analytics* section of the
|
|
<<kibana-feature-privileges,{kib} feature privileges>>.
|
|
|
|
[[machine-learning-api-sync-desc]]
|
|
==== {api-description-title}
|
|
|
|
This API runs automatically when you start {kib} and periodically thereafter.
|
|
|
|
[[machine-learning-api-sync-path-params]]
|
|
==== {api-path-parms-title}
|
|
|
|
`space_id`::
|
|
(Optional, string) An identifier for the space. If `space_id` is not provided in
|
|
the URL the default space is used.
|
|
|
|
[[machine-learning-api-sync-query-params]]
|
|
==== {api-query-parms-title}
|
|
|
|
`simulate`::
|
|
(Optional, boolean) When `true`, simulates the synchronization by only returning
|
|
the list actions that _would_ be performed.
|
|
|
|
[[machine-learning-api-sync-response-body]]
|
|
==== {api-response-body-title}
|
|
|
|
`datafeedsAdded`::
|
|
(array) If a saved object for an {anomaly-job} is missing a {dfeed} identifier,
|
|
it is added. This list contains the {dfeed} identifiers and indicates whether
|
|
the synchronization was successful.
|
|
|
|
`datafeedsRemoved`::
|
|
(array) If a saved object for an anomaly detection job references a datafeed
|
|
that no longer exists, it is deleted. This list contains the {dfeed} identifiers
|
|
and indicates whether the synchronization was successful.
|
|
|
|
`savedObjectsCreated`::
|
|
(array) If saved objects are missing for {ml} jobs or trained models, they are
|
|
created. This list contains the job and model identifiers and indicates whether
|
|
the synchronization was successful.
|
|
|
|
`savedObjectsDeleted`::
|
|
(array) If saved objects exist for {ml} jobs or trained models that no longer
|
|
exist, they are deleted. This list contains the job and model identifiers and
|
|
indicates whether the synchronization was successful.
|
|
|
|
[[machine-learning-api-sync-codes]]
|
|
==== {api-response-codes-title}
|
|
|
|
`200`::
|
|
Indicates a successful call.
|
|
|
|
[[machine-learning-api-sync-example]]
|
|
==== {api-examples-title}
|
|
|
|
Retrieve the list of {ml} saved objects that require synchronization:
|
|
|
|
[source,sh]
|
|
--------------------------------------------------
|
|
GET api/ml/saved_objects/sync?simulate=true
|
|
--------------------------------------------------
|
|
// KIBANA
|
|
|
|
If there are two jobs that need to be synchronized, for example, the API returns
|
|
the following response:
|
|
|
|
[source,sh]
|
|
--------------------------------------------------
|
|
{"savedObjectsCreated":{"anomaly_detector":{"myjob1":{"success":true},"myjob2":{"success":true}}},"savedObjectsDeleted":{},"datafeedsAdded":{},"datafeedsRemoved":{}}
|
|
--------------------------------------------------
|
|
|
|
To perform the synchronization, re-run the API and omit the `simulate` parameter. |