Monitor the progress of a task

Version: 10.4

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:

RequestResponse
{
    "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

Id

The task ID.

Created

Date and time of task creation.

Updated

Date and time of the last status change.

TaskType

DeferredAction = 0

DistributedProcessing = 1

Status

Pending = 0

Processing = 1

Completed = 2

Failed = 3

Expired = 4

Canceled = 5

Progress

The number of items processed by the task.

Total

The total approximate number of items to process.

Description

Gets the human-readable description of the task. If applied.

PrerequisiteTaskIds

The list of task IDs that are prerequisites for this task.

Do you have some feedback for us?

If you have suggestions for improving this article,