ListUploadTasks - 列出文件上传任务

根据时间及类型列出文件上传任务的执行状态及运行信息。

调试

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

授权信息

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

请求参数

名称类型必填描述示例值
SiteIdlong

站点 ID,可通过调用 ListSites 接口获取。

123456****
StartTimestring

开始时间,格式为:YYYY-MM-DDThh:mm:ssZ。

2018-11-29T00:00:00Z
EndTimestring

结束时间,格式为:YYYY-MM-DDThh:mm:ssZ。

2019-12-06T12:00:00Z
Typestring

任务类型:

  • file:url 文件刷新。
  • preload:文件预热。
  • directory:目录刷新。
  • ignoreparams:去参数刷新。
file

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

CB1A380B-09F0-41BB-A198-72F8FD6D****
Tasksarray<object>

文件上传任务列表。

TaskItemsobject
UploadTaskNamestring

文件上传任务名。

purge_file_task
UploadIdstring

文件上传任务 ID。

159253299357****
CreateTimestring

创建时间。

2023-07-26T01:56:15Z
Statusstring

任务状态。

  • Complete:完成。
  • Refreshing:执行中。
  • Failed:执行失败。
Complete
Typestring

任务类型:

  • file:url 文件刷新。
  • preload:文件预热。
  • directory:目录刷新。
  • ignoreparams:去参数刷新。
file
Descriptionstring

文件上传任务执行失败后的错误提示信息。

invalid url
ErrorCodestring

错误码,多个用逗号隔开:

  • InvalidUrl:链接格式不正确。
  • InvalidDomain:域名归属校验不通过。
  • QuotaExcess:超出配额上限。
  • OtherErrors:其它错误。
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错误码错误信息描述
400MissingTimeParameterThe StartTime and EndTime must be both specified.请同时提供开始时间和结束时间。
400InvalidEndTime.MismatchThe specified EndTime is earlier than the StartTime.您填入的结束时间早于开始时间,请检查后重试。
400DomainNameOverLimitA maximum of 500 domains are supported for each request.一次最多只支持500个域名,请减少域名重新请求。
400InvalidTimeThe query time cannot exceed the last 3 days.查询时间不能超过最近3天。
400MissingParameter.ObjectTypeThe ObjectType parameter is required if DomainName or ObjectType is specified.请填写ObjectType参数。
400InvalidStationParameterThe specified Station is invalid.指定的节点参数无效。
400TooManyRequestsToo many requests.Please try again later.请求过于频繁,请稍后重试。
400InvalidTaskId.MalformedThe specified taskId is invalid.指定的任务ID无效。
400InvalidParameters.InvalidUrlsThe specified urls are invalid.请求的URL参数无效。

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