87 lines
2.2 KiB
Plaintext
87 lines
2.2 KiB
Plaintext
|
[[ml-get-bucket]]
|
||
|
|
==== Get Buckets
|
||
|
|
|
||
|
|
The get bucket API allows you to retrieve information about buckets in the results from a job.
|
||
|
|
|
||
|
|
===== Request
|
||
|
|
|
||
|
|
`GET _xpack/ml/anomaly_detectors/<job_id>/results/buckets` +
|
||
|
|
|
||
|
|
`GET _xpack/ml/anomaly_detectors/<job_id>/results/buckets/<timestamp>`
|
||
|
|
////
|
||
|
|
===== Description
|
||
|
|
|
||
|
|
OUTDATED?: The get job API can also be applied to all jobs by using `_all` as the job name.
|
||
|
|
////
|
||
|
|
===== Path Parameters
|
||
|
|
|
||
|
|
`job_id`::
|
||
|
|
(+string+) Identifier for the job
|
||
|
|
|
||
|
|
`timestamp`::
|
||
|
|
(+string+) The timestamp of a single bucket result. If you do not specify this optional parameter,
|
||
|
|
the API returns information about all buckets that you have authority to view in the job.
|
||
|
|
|
||
|
|
////
|
||
|
|
===== Results
|
||
|
|
|
||
|
|
The API returns information about the job resource. For more information, see
|
||
|
|
<<ml-job-resource,job resources>>.
|
||
|
|
|
||
|
|
===== Query Parameters
|
||
|
|
|
||
|
|
`_stats`::
|
||
|
|
(+boolean+; default: ++true++) If true (default false), will just validate the cluster definition but will not perform the creation
|
||
|
|
|
||
|
|
===== Responses
|
||
|
|
|
||
|
|
200
|
||
|
|
(EmptyResponse) The cluster has been successfully deleted
|
||
|
|
404
|
||
|
|
(BasicFailedReply) The cluster specified by {cluster_id} cannot be found (code: clusters.cluster_not_found)
|
||
|
|
412
|
||
|
|
(BasicFailedReply) The Elasticsearch cluster has not been shutdown yet (code: clusters.cluster_plan_state_error)
|
||
|
|
|
||
|
|
===== Examples
|
||
|
|
|
||
|
|
.Example results for a single job
|
||
|
|
----
|
||
|
|
{
|
||
|
|
"count": 1,
|
||
|
|
"jobs": [
|
||
|
|
{
|
||
|
|
"job_id": "it-ops-kpi",
|
||
|
|
"description": "First simple job",
|
||
|
|
"create_time": 1491007356077,
|
||
|
|
"finished_time": 1491007365347,
|
||
|
|
"analysis_config": {
|
||
|
|
"bucket_span": "5m",
|
||
|
|
"latency": "0ms",
|
||
|
|
"summary_count_field_name": "doc_count",
|
||
|
|
"detectors": [
|
||
|
|
{
|
||
|
|
"detector_description": "low_sum(events_per_min)",
|
||
|
|
"function": "low_sum",
|
||
|
|
"field_name": "events_per_min",
|
||
|
|
"detector_rules": []
|
||
|
|
}
|
||
|
|
],
|
||
|
|
"influencers": [],
|
||
|
|
"use_per_partition_normalization": false
|
||
|
|
},
|
||
|
|
"data_description": {
|
||
|
|
"time_field": "@timestamp",
|
||
|
|
"time_format": "epoch_ms"
|
||
|
|
},
|
||
|
|
"model_plot_config": {
|
||
|
|
"enabled": true
|
||
|
|
},
|
||
|
|
"model_snapshot_retention_days": 1,
|
||
|
|
"model_snapshot_id": "1491007364",
|
||
|
|
"results_index_name": "shared"
|
||
|
|
}
|
||
|
|
]
|
||
|
|
}
|
||
|
|
----
|
||
|
|
////
|