Validate Jobsedit

The validate jobs API validates job configuration information.

Requestedit

POST _xpack/ml/anomaly_detectors/_validate

Descriptionedit

This API enables you validate the job configuration before you create the job.

This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.

Request Bodyedit

For a list of the properties that you can specify in the body of this API, see Job Resources.

Authorizationedit

You must have manage_ml, or manage cluster privileges to use this API. For more information, see Cluster Privileges.

Examplesedit

The following example validates job configuration information:

POST _xpack/ml/anomaly_detectors/_validate
{
    "description" : "Unusual response times by airlines",
    "analysis_config" : {
        "bucket_span": "300S",
        "detectors" :[
          {
            "function": "metric",
            "field_name": "responsetime",
            "by_field_name": "airline"}],
            "influencers": [ "airline" ]
    },
    "data_description" : {
       "time_field": "time",
       "time_format": "yyyy-MM-dd'T'HH:mm:ssX"
    }
}

When the validation is complete, you receive the following results:

{
  "acknowledged": true
}