Reset the progress of a scheduled prefetch task and restart prefetching from the beginning.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| Id |
string |
No |
Scheduled prefetch task ID. |
665d3af3621bccf3fe29e1a4 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
Request ID. |
15C66C7B-671A-4297-9187-2C4477247A74 |
| AliUid |
string |
Alibaba Cloud account ID. |
15685865xxx14622 |
| CreatedAt |
string |
Task creation time. |
2024-06-02T02:23:26Z |
| Domains |
string |
List of prefetch domain names. |
testurl.com |
| ErrorInfo |
string |
Error message. |
invalid domain:test.com |
| FailedFileOss |
string |
OSS address of the failed file. |
https://xxxobject.oss-cn-reginon.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7 |
| FileId |
string |
URL list file ID (used for download). |
665d3b48621bccf3fe29e1a7 |
| Id |
string |
Task ID. |
665d3af3621bccf3fe29e1a4 |
| InsertWay |
string |
URL insertion method. |
oss |
| Name |
string |
Task name. |
example |
| SiteId |
integer |
Site ID. |
190007158391808 |
| TaskSubmitted |
integer |
Number of URLs submitted to the system for prefetching. |
1 |
| TaskType |
string |
Task type (refresh/prefetch). |
preload |
| UrlCount |
integer |
Total number of URLs. |
2 |
| UrlSubmitted |
integer |
Number of submitted URLs. |
1 |
Examples
Success response
JSON format
{
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
"AliUid": "15685865xxx14622",
"CreatedAt": "2024-06-02T02:23:26Z",
"Domains": "testurl.com",
"ErrorInfo": "invalid domain:test.com",
"FailedFileOss": "https://xxxobject.oss-cn-reginon.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7",
"FileId": "665d3b48621bccf3fe29e1a7",
"Id": "665d3af3621bccf3fe29e1a4",
"InsertWay": "oss",
"Name": "example",
"SiteId": 190007158391808,
"TaskSubmitted": 1,
"TaskType": "preload",
"UrlCount": 2,
"UrlSubmitted": 1
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | The end time you entered is earlier than the start time. Please check and try again. |
| 400 | InvalidJob.JobCountOfSiteFull | The maximum number of prefetch tasks for the website has been reached. Delete some unwanted ones and try again. | 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. | Invalid task ID or execution plan ID. |
| 400 | MissingOssUrl | OssUrl missing. Specify a valid URL of the OSS object that stores URLs to prefetch. | OssUrl missing. Specify a valid URL of the OSS object that stores URLs to prefetch. |
| 400 | MissingUrlList | Enter the URLs you want to prefetch. | Enter the URLs you want to prefetch. |
| 400 | TooManyRequests | Too many requests.Please try again later. | Requests are too frequent, 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. | 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. |
| 404 | InvalidJob.NotFound | The task does not exist. Check whether the task ID is correct or whether the task has been deleted. | The task does not exist. Check whether the task ID is correct or whether the task has been deleted. |
| 404 | LogNotFound | Failed to query the log. Check whether the task ID and execution ID are valid. | Failed to query the log. Check whether the task ID and execution ID are valid. |
| 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. | The execution plan does not exist. Check whether the parameters such as the execution ID, start time, and end time are correct. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.