//lcawley Verified example output 2017-04-11 [[ml-get-job]] ==== Get Jobs The get jobs API enables you to retrieve configuration information for jobs. ===== Request `GET _xpack/ml/anomaly_detectors/` + `GET _xpack/ml/anomaly_detectors/` //===== Description ===== Path Parameters `job_id`:: (string) Identifier for the job. This parameter does not support wildcards, but you can specify `_all` or omit the `job_id` to get information about all jobs. ===== Results The API returns the following information: `jobs`:: (array) An array of job resources. For more information, see <>. ===== Authorization You must have `monitor_ml`, `monitor`, `manage_ml`, or `manage` cluster privileges to use this API. For more information, see <>. ===== Examples The following example gets configuration information for the `farequote` job: [source,js] -------------------------------------------------- GET _xpack/ml/anomaly_detectors/farequote -------------------------------------------------- // CONSOLE // TEST[skip:todo] In this example, the API returns a single result that matches the specified score and time constraints: [source,js] ---- { "count": 1, "jobs": [ { "job_id": "farequote", "job_type": "anomaly_detector", "description": "Multi-metric job", "create_time": 1491948149563, "finished_time": 1491948166289, "analysis_config": { "bucket_span": "5m", "detectors": [ { "detector_description": "mean(responsetime)", "function": "mean", "field_name": "responsetime", "partition_field_name": "airline", "detector_rules": [] } ], "influencers": [ "airline" ] }, "data_description": { "time_field": "@timestamp", "time_format": "epoch_ms" }, "model_snapshot_retention_days": 1, "model_snapshot_id": "1491948163", "results_index_name": "shared" } ] } ----