Queries the status of refresh or prefetch tasks by ID for an accelerated domain name.

  • You can query data within the last three days.
  • The maximum number of times that each user can call this operation per second is 30.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeRefreshTaskById

The operation that you want to perform. Set the value to DescribeRefreshTaskById.

TaskId String Yes 12345678

The ID of the task that you want to query.

You can call the RefreshObjectCaches operation to query task IDs. Then, you can use the task IDs to query task status.

You can specify at most 10 task IDs. Separate task IDs with commas (,).

Response parameters

Parameter Type Example Description
RequestId String E0C2EF95-B1EC-4C93-855E-2059A7DA2B7B

The ID of the request.

Tasks Array of CDNTask

A list of tasks.

CreationTime String 2020-08-03T08:54:23Z

The time when the task was created. The time is displayed in UTC.

Description String Internal Error

The error returned when the refresh or prefetch task failed. Valid values:

  • Internal Error: An internal error occurred.
  • Origin Timeout: The response from the origin server timed out.
  • Origin Return StatusCode 5XX: The origin server returned a 5XX error.
ObjectPath String http://example.com/abc.jpg

The path of the object refreshed by the refresh task.

ObjectType String file

The type of the task. Valid values:

  • file: refreshes an individual file.
  • directory: refreshes files under the specified directories.
  • preload: prefetches an individual file.
Process String 100%

The progress of the task, in percentage.

Status String Complete

The status of the task. Valid values:

  • Complete: The task has completed.
  • Pending: The task is in the pending state.
  • Refreshing: The task is in progress.
  • Failed: The task has failed.
TaskId String 12345678

The ID of the task.

TotalCount Long 2

The total number of tasks.


Sample requests

&<Common request parameters>

Sample success responses

XML format


JSON format

    "RequestId": "E0C2EF95-B1EC-4C93-855E-2059A7DA2B7B",
    "Tasks": [
            "CreationTime": "2020-08-03T08:54:23Z",
            "Description": "",
            "ObjectPath": "http://example.com/abc.jpg",
            "ObjectType": "file",
            "Process": "100%",
            "Status": "Complete",
            "TaskId": "12345678"
            "CreationTime": "2020-08-03T09:12:44Z",
            "Description": "",
            "ObjectPath": "http://example.com/bcd.jpg",
            "ObjectType": "file",
            "Process": "99.37%",
            "Status": "Refreshing",
            "TaskId": "23456789"
    "TotalCount": 2

Error codes

For a list of error codes, visit the API Error Center.