全部产品
Search
文档中心

边缘安全加速:GetUploadTask - 查询文件上传任务状态

更新时间:Jun 25, 2026

通过文件上传任务ID查询对应任务的执行状态及运行信息。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

SiteId

integer

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

重要 查询上传任务时此参数为必填。

123456****

UploadId

integer

文件上传任务 ID,调用 UploadFile 接口时分配的此字段。

重要 此参数为必填,必须是通过 UploadFile API 返回的有效任务 ID,未提供或提供不存在的 ID 均返回 InvalidParameters(400)。

159253299357****

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

ET5BF670-09D5-4D0B-BEBY-D96A2A52****

Status

string

任务状态。

  • init:任务初始化。

  • activacted:激活。

  • running:运行中。

  • success:成功。

  • partial:部分成功。

  • fail:失败。

running

Description

string

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

invalid url

示例

正常返回示例

JSON格式

{
  "RequestId": "ET5BF670-09D5-4D0B-BEBY-D96A2A52****",
  "Status": "running",
  "Description": "invalid url"
}

错误码

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参数无效。

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

变更历史

更多信息,参考变更详情