Summary
Get a task by ID
Description
Get a Task.
Route
GET /operations-manager/tasks/:id
Roles
Parameters
Name | Type | Required | Description |
---|---|---|---|
id | string | yes | The id of the Task to get. |
queryParameters | object | yes | Optional parameters for projecting fields in the Task document. |
{ "queryParameters": { "include": "name", "exclude": "description", "dereference": "accounts.metrics.owner" } }
{ "type": "object", "properties": { "queryParameters": { "title": "queryParameters", "type": "object", "properties": { "include": { "type": "string", "description": "Inclusive projection operator formatted as a comma-delineated list. '_id' will be included implicitly unless excluded with 'exclude=_id'. May only be used in conjunction with 'exclude' when 'exclude=_id'.", "examples": [ "name", "description", "name,description" ] }, "exclude": { "type": "string", "description": "Exclusive projection operator formatted as a comma-delineated list. May only be used in conjunction with 'include' when 'exclude=_id'.", "examples": [ "_id", "description", "_id,description" ] }, "dereference": { "type": "string", "description": "Designates foreign key fields to dereference in the API output. 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'.", "examples": [ "job", "accounts.metrics.owner" ] } } } }, "required": [ "queryParameters" ], "additionalProperties": false }
Return
Name | Type | Description |
---|---|---|
task | object | The requested Task. |
{ "message": "Successfully retrieved search results", "data": { "_id": "EBfDA62B-13b5-ccC2-b42d-A2Ee9D6cEb0D", "location": "Application", "view": "in laborum veniam ea ex", "status": "complete", "app": "sit aliquip velit ipsum", "name": "elit cupidatat dolor exercitation labore", "variables": { "decorators": [ { "type": "encryption", "pointer": "/~1/XFFjl/FH+0R/c2/W7b,-/jRVQFupD" }, { "type": "encryption", "pointer": "/~1/Wc-DQj6//xQEUspgQ3D/~0/~0/~0/yh" }, { "type": "encryption", "pointer": "/~0/~1/~0/OVR/iLikgAMD-I/kQ/~1/~1/~0/ptzbX1FVXgJ/DoFg7hdN88." }, { "type": "encryption", "pointer": "/~1/~0" } ] }, "last_updated": "2016-08-17T00:28:27.718Z", "encodingVersion": 1, "job": { "_id": "08f49f4b6b95b9fa010eeeda", "task": "b4f", "name": "myCoolDocumentName", "description": "Some helpful information about the document", "ancestors": [ "66aa2ee53b08c16190784eb5", "4accff5e8c8144914ecbf33a", "5ce65965afc02f5bbf369967", "a74d3c4d2610313a05645f76", "e3a3fe25bf6c1a54f38c57fd" ] }, "groups": [ { "_id": "6d819b39b6d3dcf954648823", "provenance": "consequat ut quis", "name": "aute", "description": "deserunt fugiat ad commodo ut", "memberOf": [ { "groupId": "7db5b793c122601d66a65a9a", "aaaManaged": true }, { "groupId": "fbf619196bda251aec2d7aa6", "aaaManaged": false }, { "groupId": "d6c1af58750a644b98493363", "aaaManaged": false }, { "groupId": "77921984a6716ad06973697d", "aaaManaged": false } ], "assignedRoles": [ { "roleId": "aute magna" } ], "inactive": false, "_meta": { "created": "2010-11-11T14:03:13.27Z", "updated": "1972-01-20T17:41:50.288Z", "migrationVersion": 92703974 } }, "01899db7118d233f9add06fc", { "_id": "93b0264f593d5163c5c394bf", "provenance": "ea exercitation nostrud ut", "name": "amet ad et cillum", "description": "sit tempor et", "memberOf": [ { "groupId": "359c67aacafa330497eb14f5", "aaaManaged": false } ], "assignedRoles": [ { "roleId": "ex sed" }, { "roleId": "amet do magna" }, { "roleId": "ullamco sit" }, { "roleId": "Excepteur reprehenderit ut nisi" } ], "inactive": false, "_meta": { "created": "1981-01-31T01:18:05.013Z", "updated": "2022-06-02T18:52:48.422Z", "migrationVersion": -78904522 } }, { "_id": "2657bac29a3a278237354ea0", "provenance": "est consectetur et", "name": "labore proident", "description": "dolor quis in", "memberOf": [ { "groupId": "413586283f174c450e4a8c4e", "aaaManaged": true }, { "groupId": "92239bbcf857be62eb33305b", "aaaManaged": true }, { "groupId": "9c396762361d4ff49c23e973", "aaaManaged": false }, { "groupId": "a2b09a29ed2f6dd2b27962a2", "aaaManaged": false } ], "assignedRoles": [ { "roleId": "aliqua" }, { "roleId": "voluptate cupidatat" }, { "roleId": "culpa qui dolor veniam aute" } ], "inactive": true, "_meta": { "created": "1996-09-13T07:31:00.334Z", "updated": "1959-07-17T17:39:21.64Z", "migrationVersion": -94910675 } }, { "_id": "681bec348ac1514db3285a5c", "provenance": "enim", "name": "incididunt aliqua", "description": "velit amet laborum et", "memberOf": [ { "groupId": "17bc77675eb7c057fdd5f029", "aaaManaged": true }, { "groupId": "3c4bf36d56084b6d26e423ab", "aaaManaged": false }, { "groupId": "9fc6557d95ca7cbaf8d72be5", "aaaManaged": true }, { "groupId": "3082d2d2fc2335b7a86cd04b", "aaaManaged": false }, { "groupId": "ca1684c9f9c052245173843d", "aaaManaged": true } ], "assignedRoles": [ { "roleId": "cillum non aliquip" }, { "roleId": "irure dolore laborum laboris" }, { "roleId": "qui non pariatur" }, { "roleId": "adipisicing" }, { "roleId": "veniam anim ad eu in" } ], "inactive": false, "_meta": { "created": "1945-05-04T19:49:31.822Z", "updated": "2020-01-16T00:51:32.824Z", "migrationVersion": -35383779 } } ], "type": "manual", "metrics": { "start_time": "sit voluptate", "claim_time": "1981-03-20T08:05:16.014Z", "end_time": 1785036.9167314619, "server_id": "exercitation", "finish_state": "canceled", "run_time": -48817714.468814045, "user": "Pronghorn", "owner": { "_id": "311265eab7bf5c00f45b258d", "provenance": "mollit proident", "username": "aliqua est Lorem occaecat", "firstname": "eu", "memberOf": [ { "groupId": "da997807e154ba4d7c858d9d", "aaaManaged": false }, { "groupId": "3291ed8ccbd5566c39dd27e0", "aaaManaged": false } ], "assignedRoles": [ { "roleId": "tempor esse Lorem in aute" }, { "roleId": "qui aliquip" }, { "roleId": "Ut nisi cupidatat" }, { "roleId": "pariatur laborum fugiat deserunt sed" } ], "inactive": true, "lastLogin": "1960-09-14T14:40:07.508Z", "_meta": { "created": "1965-09-21T13:45:53.975Z", "updated": "1995-05-19T16:44:45.254Z", "migrationVersion": -8859713 }, "email": "pariatur Ut" } } } }
{ "title": "task", "allOf": [ { "$ref": "common-api#/definitions/success-response" }, { "type": "object", "properties": { "data": { "$ref": "task-api" } } } ] }