Start rollup job API

edit

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.

This API starts an existing, stopped rollup job. If the job does not exist an exception will be thrown. Starting an already started job has no action.

Request

edit

POST _rollup/job/<job_id>/_start

Path Parameters

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

Request Body

edit

There is no request body for the Start Job API.

Authorization

edit

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

Examples

edit

If we have already created a rollup job named sensor, it can be started with:

POST _rollup/job/sensor/_start

Which will return the response:

{
  "started": true
}

If however we try to start a job which doesn’t exist:

POST _rollup/job/does_not_exist/_start

A 404 resource_not_found exception will be thrown:

{
    "error" : {
        "root_cause" : [
            {
                "type" : "resource_not_found_exception",
                "reason" : "Task for Rollup Job [does_not_exist] not found",
                "stack_trace": ...
            }
        ],
        "type" : "resource_not_found_exception",
        "reason" : "Task for Rollup Job [does_not_exist] not found",
        "stack_trace": ...
    },
    "status": 404
}