调用DescribeRefreshTasks查询刷新、预热状态是否在全网生效。

调用该接口前,请您注意:
  • 支持根据任务ID查询、URL查询。
  • Taskid与Objectpath都不指定:默认查询3天内第一页的数据(20条)。
  • Taskid与Objectpath可以同时指定。
  • 当指定DomainName或Status时,ObjectType该项为必填。
  • 只可查询3天内的数据。
  • 单用户调用频率:10次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeRefreshTasks

操作接口名,系统规定参数,取值:DescribeRefreshTasks

TaskId String 1234321

按任务ID查询刷新状态。

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

按路径查询,准确匹配。

PageNumber Integer 1

取得第几页,取值范围为:1~100000

ObjectType String file

任务类型。

  • file:单文件刷新。
  • directory:目录刷新。
  • preload:单文件预热。

当指定DomainNameStatus时,该参数为必选项。

DomainName String www.yourdomain.com

加速域名,仅支持单个查询。

默认查询所有加速域名。

Status String Complete

任务状态:

  • Complete:完成。
  • Refreshing:刷新中。
  • Failed:刷新失败。
PageSize Integer 20

分页大小,默认20,最大100。取值:1~100

StartTime String 2017-12-21T08:00:00Z

开始时间。日期格式按照ISO8601表示法,并使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。

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

结束时间。日期格式按照ISO8601表示法,并使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。

结束时间需大于起始时间。

ResourceGroupId String your resourceGroupId

资源组ID。

返回数据

名称 类型 示例值 描述
Tasks Array of CDNTask

TaskItem组成的任务列表。

CDNTask
TaskId String 704225667

任务ID。

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

刷新对象路径。

Status String Complete

状态。

  • Complete:完成。
  • Refreshing:刷新中。
  • Failed:刷新失败。
  • Pending:等待刷新。
Process String 100%

进度百分比。

ObjectType String file

任务类型。

  • file:单文件刷新。
  • directory:目录刷新。
  • preload:单文件预热。
CreationTime String 2014-11-27T08:23:22Z

任务对象创建时间,UTC时间。

Description String Internal Error

刷新预热失败返回错误描述。

  • InternalError:内部错误。
  • OriginTimeout:源站响应超时。
  • OriginReturnStatusCode 5XX:源站响应5xx错误码。
PageSize Long 1

整页大小。

PageNumber Long 10

页码。

TotalCount Long 2

总条数。

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

请求ID。

示例

请求示例

https://cdn.aliyuncs.com?&Action=DescribeRefreshTasks
&ObjectPath=http://aaa.com/1.txt
&PageNumber=1
&PageSize=10
&<公共请求参数>

正常返回示例

XML 格式

<DescribeRefreshTasksResponse>	
	  <Tasks>
		    <CDNTask>
			      <CreationTime>2014-11-27T08:23:22Z</CreationTime>
			      <ObjectPath>http://aaa.com/1.txt</ObjectPath>
			      <Status>Complete</Status>
			      <TaskId>704225667</TaskId>
			      <ObjectType>file</ObjectType>
			      <Process>100%</Process>
		    </CDNTask>
		    <CDNTask>
			      <CreationTime>2014-11-27T08:18:38Z</CreationTime>
			      <ObjectPath>http://bbb.com/1.txt</ObjectPath>
			      <Status>Complete</Status>
			      <TaskId>704222904</TaskId>
			      <ObjectType>file</ObjectType>
			      <Process>100%</Process>
		    </CDNTask>
	  </Tasks>
	  <PageNumber>1</PageNumber>
	  <PageSize>10</PageSize>
	  <TotalCount>2</TotalCount>
	  <RequestId>174F6032-AA26-470D-B90E-36F0EB205BEE</RequestId>
</DescribeRefreshTasksResponse>

JSON 格式

{
	"Tasks": {
		"CDNTask": [
            {
			"CreationTime": "2014-11-27T08:23:22Z",
			"ObjectPath": "http://aaa.com/1.txt",
			"Status": "Complete",
			"TaskId": "704225667",
			"ObjectType": "file",
			"Process": "100%"
		}, {
			"CreationTime": "2014-11-27T08:18:38Z",
			"ObjectPath": "http://bbb.com/1.txt",
			"Status": "Complete",
			"TaskId": "704222904",
			"ObjectType": "file",
			"Process": "100%"
		}
      ]
	},
	"PageNumber": 1,
	"PageSize": 10,
	"TotalCount": 2,
	"RequestId": "174F6032-AA26-470D-B90E-36F0EB205BEE"
}

错误码

访问错误中心查看更多错误码。