根据时间及类型列出文件上传任务的执行状态及运行信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SiteId |
integer |
否 |
站点 ID，可通过调用 ListSites 接口获取。 重要 调用 ListUploadTasks 时本参数为实际必填项。 |
123456**** |
| StartTime |
string |
否 |
开始时间，格式为 ISO 8601（如 2024-01-01T00:00:00+Z）。 重要 StartTime 与 EndTime 须同时提供以限定查询时间窗口。缺一则返回错误。 |
2018-11-29T00:00:00Z |
| EndTime |
string |
否 |
结束时间，格式为 ISO 8601（如 2024-01-01T00:00:00+Z）。 重要 StartTime 与 EndTime 须同时提供以限定查询时间窗口。缺一则返回错误。 |
2019-12-06T12:00:00Z |
| Type |
string |
否 |
任务类型：
|
file |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
CB1A380B-09F0-41BB-A198-72F8FD6D**** |
| Tasks |
array<object> |
文件上传任务列表。 |
|
|
object |
|||
| UploadTaskName |
string |
文件上传任务名。 |
purge_file_task |
| UploadId |
string |
文件上传任务 ID。 |
159253299357**** |
| CreateTime |
string |
创建时间，格式为 ISO 8601（如 2024-01-01T00:00:00+Z）。 |
2023-07-26T01:56:15Z |
| Status |
string |
任务状态。
|
Complete |
| Type |
string |
任务类型：
|
file |
| Description |
string |
文件上传任务执行失败后的错误提示信息。 |
invalid url |
| ErrorCode |
string |
错误码，多个用逗号隔开：
|
InvalidUrl,InvalidDomain |
示例
正常返回示例
JSON格式
{
"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"
}
]
}错误码
|
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参数无效。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。