Lists the execution status and runtime information of file upload tasks by time and type.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| SiteId |
integer |
No |
The site ID. You can obtain this value by calling the ListSites operation. Important This parameter is required when you call the ListUploadTasks operation. |
123456**** |
| StartTime |
string |
No |
The start time in ISO 8601 format (for example, 2024-01-01T00:00:00+Z). Important StartTime and EndTime must be provided together to define the query time window. An error is returned if either one is missing. |
2018-11-29T00:00:00Z |
| EndTime |
string |
No |
The end time in ISO 8601 format (for example, 2024-01-01T00:00:00+Z). Important StartTime and EndTime must be provided together to define the query time window. An error is returned if either one is missing. |
2019-12-06T12:00:00Z |
| Type |
string |
No |
The task type. Valid values:
|
file |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response parameters. |
||
| RequestId |
string |
The request ID. |
CB1A380B-09F0-41BB-A198-72F8FD6D**** |
| Tasks |
array<object> |
The list of file upload tasks. |
|
|
object |
|||
| UploadTaskName |
string |
The name of the file upload task. |
purge_file_task |
| UploadId |
string |
The ID of the file upload task. |
159253299357**** |
| CreateTime |
string |
The creation time in ISO 8601 format (for example, 2024-01-01T00:00:00+Z). |
2023-07-26T01:56:15Z |
| Status |
string |
The task status. Valid values:
|
Complete |
| Type |
string |
The task type. Valid values:
|
file |
| Description |
string |
The error message returned when the file upload task fails. |
invalid url |
| ErrorCode |
string |
The error code. Multiple error codes are separated by commas. Valid values:
|
InvalidUrl,InvalidDomain |
Examples
Success response
JSON format
{
"RequestId": "CB1A380B-09F0-41BB-A198-72F8FD6D****",
"Tasks": [
{
"UploadTaskName": "purge_file_task",
"UploadId": "159253299357****",
"CreateTime": "2023-07-26T01:56:15Z",
"Status": "Complete",
"Type": "file",
"Description": "invalid url",
"ErrorCode": "InvalidUrl,InvalidDomain"
}
]
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | MissingTimeParameter | The StartTime and EndTime must be both specified. | Please provide both a start time and an end time. |
| 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 | DomainNameOverLimit | A maximum of 500 domains are supported for each request. | Only 500 domain names are supported at a time. Please reduce the number of domain names to request again. |
| 400 | InvalidTime | The query time cannot exceed the last 3 days. | The query time cannot exceed the last 3 days. |
| 400 | MissingParameter.ObjectType | The ObjectType parameter is required if DomainName or ObjectType is specified. | Specify the ObjectType parameter. |
| 400 | InvalidStationParameter | The specified Station is invalid. | The specified node parameter is invalid. |
| 400 | TooManyRequests | Too many requests.Please try again later. | Requests are too frequent, please try again later. |
| 400 | InvalidTaskId.Malformed | The specified taskId is invalid. | The specified task ID is invalid. |
| 400 | InvalidParameters.InvalidUrls | The specified urls are invalid. | The requested URL parameter is invalid. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.