Apache
/
druid
mirror of https://github.com/apache/druid.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
druid/docs/api-reference/tasks-api.md

3.6 KiB
Raw Blame History

id title sidebar_label
tasks-api Tasks API Tasks

This document describes the API endpoints for task retrieval, submission, and deletion for Apache Druid.

Tasks

Note that all interval URL parameters are ISO 8601 strings delimited by a _ instead of a / as in 2016-06-27_2016-06-28.

GET /druid/indexer/v1/tasks

Retrieve list of tasks. Accepts query string parameters state, datasource, createdTimeInterval, max, and type.

Query Parameter Description
state filter list of tasks by task state, valid options are running, complete, waiting, and pending.
datasource return tasks filtered by Druid datasource.
createdTimeInterval return tasks created within the specified interval.
max maximum number of "complete" tasks to return. Only applies when state is set to "complete".
type filter tasks by task type. See task documentation for more details.

GET /druid/indexer/v1/completeTasks

Retrieve list of complete tasks. Equivalent to /druid/indexer/v1/tasks?state=complete.

GET /druid/indexer/v1/runningTasks

Retrieve list of running tasks. Equivalent to /druid/indexer/v1/tasks?state=running.

GET /druid/indexer/v1/waitingTasks

Retrieve list of waiting tasks. Equivalent to /druid/indexer/v1/tasks?state=waiting.

GET /druid/indexer/v1/pendingTasks

Retrieve list of pending tasks. Equivalent to /druid/indexer/v1/tasks?state=pending.

GET /druid/indexer/v1/task/{taskId}

Retrieve the 'payload' of a task.

GET /druid/indexer/v1/task/{taskId}/status

Retrieve the status of a task.

GET /druid/indexer/v1/task/{taskId}/segments

This API is deprecated and will be removed in future releases.

Retrieve information about the segments of a task.

GET /druid/indexer/v1/task/{taskId}/reports

Retrieve a task completion report for a task. Only works for completed tasks.

POST /druid/indexer/v1/task

Endpoint for submitting tasks and supervisor specs to the Overlord. Returns the taskId of the submitted task.

POST /druid/indexer/v1/task/{taskId}/shutdown

Shuts down a task.

POST /druid/indexer/v1/datasources/{dataSource}/shutdownAllTasks

Shuts down all tasks for a dataSource.

POST /druid/indexer/v1/taskStatus

Retrieve list of task status objects for list of task id strings in request body.

DELETE /druid/indexer/v1/pendingSegments/{dataSource}

Manually clean up pending segments table in metadata storage for datasource. Returns a JSON object response with numDeleted and count of rows deleted from the pending segments table. This API is used by the druid.coordinator.kill.pendingSegments.on coordinator setting which automates this operation to perform periodically.