列出站点下的定时预热任务列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
esa:ListScheduledPreloadJobs |
get |
*Site
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SiteId |
integer |
是 |
站点 ID |
190007158391808 |
| StartTime |
integer |
否 |
任务创建时间的查询开始时间范围，毫秒时间戳。 |
1717225276000 |
| EndTime |
integer |
否 |
任务创建时间的查询截止时间范围，毫秒时间戳。 |
1717225277000 |
| PageNumber |
integer |
否 |
取第几页的数据。 |
1 |
| PageSize |
integer |
否 |
分页大小，每页多少条。 |
20 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
CB1A380B-09F0-41BB-A198-72F8FD6DA2FE |
| TotalCount |
string |
过滤后的总记录数。 |
5 |
| Jobs |
array<object> |
预热任务信息列表。 |
|
|
object |
预热任务信息。 |
||
| AliUid |
string |
阿里云账号 ID。 |
15685865xxx14622 |
| CreatedAt |
string |
任务创建时间。 |
2024-06-01T08:53:13Z |
| Domains |
string |
预热域名列表。 |
testurl.com |
| ErrorInfo |
string |
错误信息。 |
invalid domain:test.com |
| FailedFileOss |
string |
失败文件 OSS 地址。 |
https://xxxobject.oss-cn-reginon.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7 |
| FileId |
string |
URL 列表文件 ID（下载时使用）。 |
665d3b48621bccf3fe29e1a7 |
| Id |
string |
任务 ID。 |
665d3af3621bccf3fe29e1a4 |
| InsertWay |
string |
URL 插入方式。 |
oss |
| Name |
string |
任务名称。 |
example |
| SiteId |
integer |
站点 ID |
190007158391808 |
| TaskSubmitted |
integer |
已提交到系统进行预热任务的 URL 数。 |
1 |
| TaskType |
string |
任务类型（刷新/预热）。 |
preload |
| UrlCount |
integer |
URL 总数。 |
2 |
| UrlSubmitted |
integer |
已提交的 URL 数。 |
1 |
| ExecutionCount |
integer |
预热计划个数。 |
1 |
示例
正常返回示例
JSON格式
{
"RequestId": "CB1A380B-09F0-41BB-A198-72F8FD6DA2FE",
"TotalCount": "5",
"Jobs": [
{
"AliUid": "15685865xxx14622",
"CreatedAt": "2024-06-01T08:53:13Z",
"Domains": "testurl.com",
"ErrorInfo": "invalid domain:test.com",
"FailedFileOss": "https://xxxobject.oss-cn-reginon.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7",
"FileId": "665d3b48621bccf3fe29e1a7",
"Id": "665d3af3621bccf3fe29e1a4\n",
"InsertWay": "oss",
"Name": "example",
"SiteId": 190007158391808,
"TaskSubmitted": 1,
"TaskType": "preload",
"UrlCount": 2,
"UrlSubmitted": 1,
"ExecutionCount": 1
}
]
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | 您填入的结束时间早于开始时间，请检查后重试。 |
| 400 | InvalidJob.JobCountOfSiteFull | The maximum number of prefetch tasks for the website has been reached. Delete some unwanted ones and try again. | 站点预热任务已达上限，无法添加更多任务，请先清理多余任务后重试。 |
| 400 | InvalidParameter.ObjectId | Invalid task ID or execution plan ID. | 您提供的任务或执行计划ID不正确，请检查ID是否有效且输入无误。 |
| 400 | MissingOssUrl | OssUrl missing. Specify a valid URL of the OSS object that stores URLs to prefetch. | OssUrl字段缺失，请确保已提供有效的OSS预热任务链接。 |
| 400 | MissingUrlList | Enter the URLs you want to prefetch. | 预热的URL为空，请输入待预热的URL。 |
| 400 | TooManyRequests | Too many requests.Please try again later. | 请求过于频繁，请稍后重试。 |
| 403 | InvalidUid.PermissionDenied | You do not have the permissions to perform this operation on this resource. Check whether the specified UID is correct and has the required permissions. | 您无权操作此资源，请确认UID是否正确且具备相应权限。 |
| 404 | InvalidJob.NotFound | The task does not exist. Check whether the task ID is correct or whether the task has been deleted. | 任务不存在，请检查任务ID是否正确或该任务是否已被删除。 |
| 404 | LogNotFound | Failed to query the log. Check whether the task ID and execution ID are valid. | 未找到日志，请检查任务ID、执行ID等是否正确和有效。 |
| 404 | InvalidExecution.NotFound | The execution plan does not exist. Check whether the parameters such as the execution ID, start time, and end time are correct. | 执行计划不存在，请检查执行ID、开始时间或结束时间等参数是否准确无误。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。