mirror of
https://github.com/elastic/kibana.git
synced 2025-04-25 02:09:32 -04:00
205 lines
13 KiB
Text
205 lines
13 KiB
Text
////
|
|
This content is generated from the open API specification.
|
|
Any modifications made to this file will be overwritten.
|
|
////
|
|
|
|
++++
|
|
<div class="openapi">
|
|
<h2>Access</h2>
|
|
<ol>
|
|
<li>APIKey KeyParamName:ApiKey KeyInQuery:false KeyInHeader:true</li>
|
|
<li>HTTP Basic Authentication</li>
|
|
</ol>
|
|
|
|
<h2><a name="__Methods">Methods</a></h2>
|
|
[ Jump to <a href="#__Models">Models</a> ]
|
|
|
|
<h3>Table of Contents </h3>
|
|
<div class="method-summary"></div>
|
|
<h4><a href="#Ml">Ml</a></h4>
|
|
<ul>
|
|
<li><a href="#mlSync"><code><span class="http-method">get</span> /s/{spaceId}/api/ml/saved_objects/sync</code></a></li>
|
|
</ul>
|
|
|
|
<h1><a name="Ml">Ml</a></h1>
|
|
<div class="method"><a name="mlSync"/>
|
|
<div class="method-path">
|
|
<a class="up" href="#__Methods">Up</a>
|
|
<pre class="get"><code class="huge"><span class="http-method">get</span> /s/{spaceId}/api/ml/saved_objects/sync</code></pre></div>
|
|
<div class="method-summary">Synchronizes Kibana saved objects for machine learning jobs and trained models. (<span class="nickname">mlSync</span>)</div>
|
|
<div class="method-notes">You must have <code>all</code> privileges for the <strong>Machine Learning</strong> feature in the <strong>Analytics</strong> section of the Kibana feature privileges. This API runs automatically when you start Kibana and periodically thereafter.</div>
|
|
|
|
<h3 class="field-label">Path parameters</h3>
|
|
<div class="field-items">
|
|
<div class="param">spaceId (required)</div>
|
|
|
|
<div class="param-desc"><span class="param-type">Path Parameter</span> — An identifier for the space. If <code>/s/</code> and the identifier are omitted from the path, the default space is used. default: null </div>
|
|
</div> <!-- field-items -->
|
|
|
|
|
|
|
|
|
|
<h3 class="field-label">Query parameters</h3>
|
|
<div class="field-items">
|
|
<div class="param">simulate (optional)</div>
|
|
|
|
<div class="param-desc"><span class="param-type">Query Parameter</span> — When true, simulates the synchronization by returning only the list of actions that would be performed. default: null </div>
|
|
</div> <!-- field-items -->
|
|
|
|
|
|
<h3 class="field-label">Return type</h3>
|
|
<div class="return-type">
|
|
<a href="#mlSync200Response">mlSync200Response</a>
|
|
|
|
</div>
|
|
|
|
<!--Todo: process Response Object and its headers, schema, examples -->
|
|
|
|
<h3 class="field-label">Example data</h3>
|
|
<div class="example-data-content-type">Content-Type: application/json</div>
|
|
<pre class="example"><code>{
|
|
"datafeedsAdded" : {
|
|
"key" : {
|
|
"success" : true
|
|
}
|
|
},
|
|
"savedObjectsCreated" : {
|
|
"anomaly-detector" : {
|
|
"key" : {
|
|
"success" : true
|
|
}
|
|
},
|
|
"data-frame-analytics" : {
|
|
"key" : {
|
|
"success" : true
|
|
}
|
|
},
|
|
"trained-model" : {
|
|
"key" : {
|
|
"success" : true
|
|
}
|
|
}
|
|
},
|
|
"savedObjectsDeleted" : {
|
|
"anomaly-detector" : {
|
|
"key" : {
|
|
"success" : true
|
|
}
|
|
},
|
|
"data-frame-analytics" : {
|
|
"key" : {
|
|
"success" : true
|
|
}
|
|
},
|
|
"trained-model" : {
|
|
"key" : {
|
|
"success" : true
|
|
}
|
|
}
|
|
},
|
|
"datafeedsRemoved" : {
|
|
"key" : {
|
|
"success" : true
|
|
}
|
|
}
|
|
}</code></pre>
|
|
|
|
<h3 class="field-label">Produces</h3>
|
|
This API call produces the following media types according to the <span class="header">Accept</span> request header;
|
|
the media type will be conveyed by the <span class="header">Content-Type</span> response header.
|
|
<ul>
|
|
<li><code>application/json</code></li>
|
|
</ul>
|
|
|
|
<h3 class="field-label">Responses</h3>
|
|
<h4 class="field-label">200</h4>
|
|
Indicates a successful call
|
|
<a href="#mlSync200Response">mlSync200Response</a>
|
|
<h4 class="field-label">401</h4>
|
|
Authorization information is missing or invalid.
|
|
<a href="#mlSync4xxResponse">mlSync4xxResponse</a>
|
|
</div> <!-- method -->
|
|
<hr/>
|
|
|
|
<h2><a name="__Models">Models</a></h2>
|
|
[ Jump to <a href="#__Methods">Methods</a> ]
|
|
|
|
<h3>Table of Contents</h3>
|
|
<ol>
|
|
<li><a href="#mlSync200Response"><code>mlSync200Response</code> - Successful sync API response</a></li>
|
|
<li><a href="#mlSync4xxResponse"><code>mlSync4xxResponse</code> - Unsuccessful sync API response</a></li>
|
|
<li><a href="#mlSyncResponseAnomalyDetectors"><code>mlSyncResponseAnomalyDetectors</code> - Sync API response for anomaly detection jobs</a></li>
|
|
<li><a href="#mlSyncResponseDataFrameAnalytics"><code>mlSyncResponseDataFrameAnalytics</code> - Sync API response for data frame analytics jobs</a></li>
|
|
<li><a href="#mlSyncResponseDatafeeds"><code>mlSyncResponseDatafeeds</code> - Sync API response for datafeeds</a></li>
|
|
<li><a href="#mlSyncResponseSavedObjectsCreated"><code>mlSyncResponseSavedObjectsCreated</code> - Sync API response for created saved objects</a></li>
|
|
<li><a href="#mlSyncResponseSavedObjectsDeleted"><code>mlSyncResponseSavedObjectsDeleted</code> - Sync API response for deleted saved objects</a></li>
|
|
<li><a href="#mlSyncResponseTrainedModels"><code>mlSyncResponseTrainedModels</code> - Sync API response for trained models</a></li>
|
|
</ol>
|
|
|
|
<div class="model">
|
|
<h3><a name="mlSync200Response"><code>mlSync200Response</code> - Successful sync API response</a> <a class="up" href="#__Models">Up</a></h3>
|
|
<div class='model-description'></div>
|
|
<div class="field-items">
|
|
<div class="param">datafeedsAdded (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseDatafeeds">map[String, mlSyncResponseDatafeeds]</a></span> If a saved object for an anomaly detection job is missing a datafeed identifier, it is added when you run the sync machine learning saved objects API. </div>
|
|
<div class="param">datafeedsRemoved (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseDatafeeds">map[String, mlSyncResponseDatafeeds]</a></span> If a saved object for an anomaly detection job references a datafeed that no longer exists, it is deleted when you run the sync machine learning saved objects API. </div>
|
|
<div class="param">savedObjectsCreated (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseSavedObjectsCreated">mlSyncResponseSavedObjectsCreated</a></span> </div>
|
|
<div class="param">savedObjectsDeleted (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseSavedObjectsDeleted">mlSyncResponseSavedObjectsDeleted</a></span> </div>
|
|
</div> <!-- field-items -->
|
|
</div>
|
|
<div class="model">
|
|
<h3><a name="mlSync4xxResponse"><code>mlSync4xxResponse</code> - Unsuccessful sync API response</a> <a class="up" href="#__Models">Up</a></h3>
|
|
<div class='model-description'></div>
|
|
<div class="field-items">
|
|
<div class="param">error (optional)</div><div class="param-desc"><span class="param-type"><a href="#string">String</a></span> </div>
|
|
<div class="param">message (optional)</div><div class="param-desc"><span class="param-type"><a href="#string">String</a></span> </div>
|
|
<div class="param">statusCode (optional)</div><div class="param-desc"><span class="param-type"><a href="#integer">Integer</a></span> </div>
|
|
</div> <!-- field-items -->
|
|
</div>
|
|
<div class="model">
|
|
<h3><a name="mlSyncResponseAnomalyDetectors"><code>mlSyncResponseAnomalyDetectors</code> - Sync API response for anomaly detection jobs</a> <a class="up" href="#__Models">Up</a></h3>
|
|
<div class='model-description'>The sync machine learning saved objects API response contains this object when there are anomaly detection jobs affected by the synchronization. There is an object for each relevant job, which contains the synchronization status.</div>
|
|
<div class="field-items">
|
|
<div class="param">success (optional)</div><div class="param-desc"><span class="param-type"><a href="#boolean">Boolean</a></span> The success or failure of the synchronization. </div>
|
|
</div> <!-- field-items -->
|
|
</div>
|
|
<div class="model">
|
|
<h3><a name="mlSyncResponseDataFrameAnalytics"><code>mlSyncResponseDataFrameAnalytics</code> - Sync API response for data frame analytics jobs</a> <a class="up" href="#__Models">Up</a></h3>
|
|
<div class='model-description'>The sync machine learning saved objects API response contains this object when there are data frame analytics jobs affected by the synchronization. There is an object for each relevant job, which contains the synchronization status.</div>
|
|
<div class="field-items">
|
|
<div class="param">success (optional)</div><div class="param-desc"><span class="param-type"><a href="#boolean">Boolean</a></span> The success or failure of the synchronization. </div>
|
|
</div> <!-- field-items -->
|
|
</div>
|
|
<div class="model">
|
|
<h3><a name="mlSyncResponseDatafeeds"><code>mlSyncResponseDatafeeds</code> - Sync API response for datafeeds</a> <a class="up" href="#__Models">Up</a></h3>
|
|
<div class='model-description'>The sync machine learning saved objects API response contains this object when there are datafeeds affected by the synchronization. There is an object for each relevant datafeed, which contains the synchronization status.</div>
|
|
<div class="field-items">
|
|
<div class="param">success (optional)</div><div class="param-desc"><span class="param-type"><a href="#boolean">Boolean</a></span> The success or failure of the synchronization. </div>
|
|
</div> <!-- field-items -->
|
|
</div>
|
|
<div class="model">
|
|
<h3><a name="mlSyncResponseSavedObjectsCreated"><code>mlSyncResponseSavedObjectsCreated</code> - Sync API response for created saved objects</a> <a class="up" href="#__Models">Up</a></h3>
|
|
<div class='model-description'>If saved objects are missing for machine learning jobs or trained models, they are created when you run the sync machine learning saved objects API.</div>
|
|
<div class="field-items">
|
|
<div class="param">anomalyMinusdetector (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseAnomalyDetectors">map[String, mlSyncResponseAnomalyDetectors]</a></span> If saved objects are missing for anomaly detection jobs, they are created. </div>
|
|
<div class="param">dataMinusframeMinusanalytics (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseDataFrameAnalytics">map[String, mlSyncResponseDataFrameAnalytics]</a></span> If saved objects are missing for data frame analytics jobs, they are created. </div>
|
|
<div class="param">trainedMinusmodel (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseTrainedModels">map[String, mlSyncResponseTrainedModels]</a></span> If saved objects are missing for trained models, they are created. </div>
|
|
</div> <!-- field-items -->
|
|
</div>
|
|
<div class="model">
|
|
<h3><a name="mlSyncResponseSavedObjectsDeleted"><code>mlSyncResponseSavedObjectsDeleted</code> - Sync API response for deleted saved objects</a> <a class="up" href="#__Models">Up</a></h3>
|
|
<div class='model-description'>If saved objects exist for machine learning jobs or trained models that no longer exist, they are deleted when you run the sync machine learning saved objects API.</div>
|
|
<div class="field-items">
|
|
<div class="param">anomalyMinusdetector (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseAnomalyDetectors">map[String, mlSyncResponseAnomalyDetectors]</a></span> If there are saved objects exist for nonexistent anomaly detection jobs, they are deleted. </div>
|
|
<div class="param">dataMinusframeMinusanalytics (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseDataFrameAnalytics">map[String, mlSyncResponseDataFrameAnalytics]</a></span> If there are saved objects exist for nonexistent data frame analytics jobs, they are deleted. </div>
|
|
<div class="param">trainedMinusmodel (optional)</div><div class="param-desc"><span class="param-type"><a href="#mlSyncResponseTrainedModels">map[String, mlSyncResponseTrainedModels]</a></span> If there are saved objects exist for nonexistent trained models, they are deleted. </div>
|
|
</div> <!-- field-items -->
|
|
</div>
|
|
<div class="model">
|
|
<h3><a name="mlSyncResponseTrainedModels"><code>mlSyncResponseTrainedModels</code> - Sync API response for trained models</a> <a class="up" href="#__Models">Up</a></h3>
|
|
<div class='model-description'>The sync machine learning saved objects API response contains this object when there are trained models affected by the synchronization. There is an object for each relevant trained model, which contains the synchronization status.</div>
|
|
<div class="field-items">
|
|
<div class="param">success (optional)</div><div class="param-desc"><span class="param-type"><a href="#boolean">Boolean</a></span> The success or failure of the synchronization. </div>
|
|
</div> <!-- field-items -->
|
|
</div>
|
|
</div>
|
|
++++
|