Start Job APIedit
This functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features 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.
Requestedit
POST _xpack/rollup/job/<job_id>/_start
Path Parametersedit
-
job_id(required) - (string) Identifier for the job
Request Bodyedit
There is no request body for the Start Job API.
Authorizationedit
You must have manage or manage_rollup cluster privileges to use this API.
For more information, see
Security Privileges.
Examplesedit
If we have already created a rollup job named sensor, it can be started with:
POST _xpack/rollup/job/sensor/_start
Which will return the response:
{
"started": true
}If however we try to start a job which doesn’t exist:
POST _xpack/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
}