调用DescribePreloadTasks查询缓存预热任务详情-边缘安全加速-阿里云-边缘安全加速(ESA)-阿里云帮助中心

查询任务预热详情，支持按时间、任务状态、预热URL进行分页查询。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
SiteId	long	否	站点 ID，可通过调用 ListSites 接口获取。	123456789****
Content	string	否	查询内容，精确匹配。	http://a.com/1.jpg?b=2
PageNumber	integer	否	页码。取值范围为：1~100000。默认值：1。	1
PageSize	integer	否	分页大小。默认值：20，最大值：50。取值为1~50之间的任意整数。	20
StartTime	string	否	开始时间。日期格式按照 ISO8601 表示法，并使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。	2023-03-22T17:00:00Z
EndTime	string	否	结束时间。日期格式按照 ISO8601 表示法，并使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。说明结束时间需大于起始时间。	2023-03-23T06:23:00Z
Status	string	否	任务执行状态。取值： Complte：完成。 Refreshing：预热中。 Failed：预热失败。	Complete

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	0AEDAF20-4DDF-4165-8750-47FF9C1929C9
PageNumber	long	页码。	1
PageSize	long	整页大小。	10
TotalCount	long	总条数。	83
Tasks	array<object>	任务列表。
Task	object
Status	string	任务状态。 Complete：完成。 Refreshing：预热中。 Failed：预热失败。	Complete
CreateTime	string	创建时间。	2023-03-28 14:28:57
Process	string	任务完成进度百分比。	100%
Description	string	预热失败后返回的错误描述。取值： Internal Error：内部错误。 Origin Timeout：源站响应超时。 Origin Return StatusCode 5XX：源站响应 5xx 错误码。	Internal Error
Content	string	预热对象。	http://a.com/1.jpg?b=2
TaskId	string	查询到的任务 ID。	1597854579687428

示例

正常返回示例

JSON格式

{
  "RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 83,
  "Tasks": [
    {
      "Status": "Complete",
      "CreateTime": "2023-03-28 14:28:57",
      "Process": "100%",
      "Description": "Internal Error",
      "Content": "http://a.com/1.jpg?b=2",
      "TaskId": 1597854579687428
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	MissingTimeParameter	The StartTime and EndTime must be both specified.	请同时提供开始时间和结束时间。
400	InvalidEndTime.Mismatch	The specified EndTime is earlier than the StartTime.	您填入的结束时间早于开始时间，请检查后重试。
400	DomainNameOverLimit	A maximum of 500 domains are supported for each request.	一次最多只支持500个域名，请减少域名重新请求。
400	InvalidTime	The query time cannot exceed the last 3 days.	查询时间不能超过最近3天。
400	MissingParameter.ObjectType	The ObjectType parameter is required if DomainName or ObjectType is specified.	请填写ObjectType参数。
400	InvalidStationParameter	The specified Station is invalid.	指定的节点参数无效。
400	TooManyRequests	Too many requests.Please try again later.	请求过于频繁，请稍后重试。
400	InvalidTaskId.Malformed	The specified taskId is invalid.	指定的任务ID无效。
400	InvalidParameters.InvalidUrls	The specified urls are invalid.	请求的URL参数无效。

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