app-operations_manager

On this page:

getTask

Summary

Get a task by ID

Description

Get a task by ID. Include or exclude fields with the 'include' and 'exclude' parameters. Dereference foreign references with the 'dereference' parameter. Note on dereference parameter: The main function of this parameter is to retrieve extra information on a task that would not ordinarily be included. If information is needed on the task's parent job, the dereference parameter may be given a value of 'job'. This will look up the full job document and place it under the 'job' property in the task document. If the output of a child job task is needed, the dereference parameter may be given a value of 'child-job-output'. This will look up the output of the job initiated by the child job task. If the child job has loop settings each individual output will be provided in an array under the property 'variables.outgoing.job_details.loop'. If the child job does not have loop settings, the output of the single job document will be provided under the property 'variables.outgoing.job_details.output'.

Route

GET /operations-manager/tasks/:id

Roles

admin engineering apiread operations

Parameters

DetailsExampleSchema
Name Type Required Description
id string yes ObjectId specifying a task.
queryParameters object yes Optional parameters for projecting fields in the task document.

Return

DetailsExampleSchema
Name Type Description
task object Job document