Query whether or not refresh and push status have taken effect for the whole site.

  • Support task ID query and URL query.
  • If neither the taskid nor objectpath are specified, it will query the first page of data (20 items) within past 3 days by default.
  • A taskid and objectpath can be specified at the same time, with a logical relationship of AND.
  • Only the data within the past 3 days can be queried.

Request parameters

Parameters Type Required Example values Description
Action String Yes DescribeRefreshTasks

The name of this interface. Value:

DescribeRefreshTasks

DomainName String No www.yourdomain.com

The domain name.

EndTime String No 2017-12-22T08:00:00:00Z

The end time, the format is 2017-01-01T12:12:20Z.

ObjectPath String No http://aaa.com/1.txt

Query through an object path with exact match.

ObjectType String No file
The task type.
  • file
  • path
  • preload
When the DomainName or TaskStatus is specified, the task type is required.
PageNumber Integer No 1

Page number.

Value range: 1~100000Scope of value: 1 ~ 100000

PageSize Integer No 20

Paging size. Maximum: 50.

Value range: random integer between 1 and 50.

Default value: 20

ResourceGroupId String No Your maid The resource group ID.
StartTime String No 2017-12-21T08:00:00:00Z

The start time, the format is 2017-01-01T12:12:20Z.

Status String No Complete
The task status.
  • Complete
  • Refreshing
  • Failed
TaskId String No 1234321

Query refresh status by task ID.

Return Parameters

Parameters Type Example values Description
Tasks

The task list consisting of TaskItem.

└TaskId String 704225667

The task ID.

└ObjectPath String http://aaa.com/1.txt

Refresh the object path.

 └Status String Complete
Status. Value:
  • Complete
  • Refreshing
  • Failed
  • Pending
└Process String 100%

Process percentage.

  └ ObjectType String File
Task type.
  • file
  • path
  • preload
└ CreationTime String 2014-11-27T08: 23: 22Z

Task object creation time, in UTC time.

 └Description String Internal Error
Returned error description when push and refresh failed, currently including three errors:
  • Internal Error
  • Origin timeout
  • Origin Return StatusCode 5XX
PageSize Long 1

The whole page size.

Pagenumber Long 10

The page number.

TotalCount Long 2

The total number of items.

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

The ID of the request. 

Examples

Request example

https://cdn.aliyuncs.com?&Action=DescribeRefreshTasks&ObjectPath=&PageNumber=1&PageSize=10&Public request parameter
Normal return example
  • JSON format

    
        "PageNumber": 1,
        "PageSize": 10,
        "RequestId":"174F6032-AA26-470D-B90E-36F0EB205BEE",
        "Tasks":{
            "CDNTask":[
                
                    "CreationTime": "2018-01-10T09:48:29Z",
                    "ObjectPath":"http://aaa.com/1.txt",
                    "ObjectType":"file",
                    "Process":"100%",
                    "Status":"Complete",
                    "TaskId":"704225667"
                
                
                    "CreationTime": "2018-01-10T09:48:29Z",
                    "Objectpath": "maid ",
                    "ObjectType":"file",
                    "Process":"100%",
                    "Status":"Complete",
                    "TaskId":"704222904"
                
            
        
        "TotalCount":2
    
Exception return example
  • JSON format

    
        "Code":"InternalError",
        "HostId":"cdn.aliyuncs.com",
        "Message":"The request processing has failed due to some unknown error.",
        "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"