获取刷新预热任务信息_刷新预热类接口_新版API参考

调用该接口前，请您注意：

支持根据任务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：单文件预热。当指定DomainName或Status时，该参数为必选项。
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"
}

错误码

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