Open Jobs API

edit

Opens one or more jobs. A job must be opened in order for it to be ready to receive and analyze data. A job can be opened and closed multiple times throughout its lifecycle.

Request

edit

POST _xpack/ml/anomaly_detectors/{job_id}/_open

Description

edit

When you open a new job, it starts with an empty model.

When you open an existing job, the most recent model state is automatically loaded. The job is ready to resume its analysis from where it left off, once new data is received.

Path Parameters

edit
job_id (required)
(string) Identifier for the job

Request Body

edit
timeout
(time) Controls the time to wait until a job has opened. The default value is 30 minutes.

Authorization

edit

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

Examples

edit

The following example opens the total-requests job and sets an optional property:

POST _xpack/ml/anomaly_detectors/total-requests/_open
{
  "timeout": "35m"
}

When the job opens, you receive the following results:

{
  "opened": true
}