Monitor the progress of a task
You can use the xConnect Web API to monitor a task.
To track the task progress:
-
Use the following GET request and substitute the
{{TaskId}}parameter with the ID of the ongoing registered task:RequestResponse<instance>/sitecore/api/datatools//tasks/{{TaskId}}/progress
GET response
The GET response contains the following data:
{
"Id": "049cd8b3-b120-4949-a42f-cdc2fe4f3086",
"Created": "2020-08-18T10:59:39.7216673Z",
"Updated": "2020-08-18T10:59:52.0965327Z",
"TaskType": 1,
"Status": 2,
"Progress": 0,
"Total": null,
"Description": "",
"PrerequisiteTaskIds": []
}
The data in the GET response is as follows:
|
Field |
Description |
|---|---|
|
|
The task ID. |
|
|
Date and time of task creation. |
|
|
Date and time of the last status change. |
|
|
DeferredAction = 0 DistributedProcessing = 1 |
|
|
Pending = 0 Processing = 1 Completed = 2 Failed = 3 Expired = 4 Canceled = 5 |
|
|
The number of items processed by the task. |
|
|
The total approximate number of items to process. |
|
|
Gets the human-readable description of the task. If applied. |
|
|
The list of task IDs that are prerequisites for this task. |