调用DescribeTask查询一个异步任务。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeTask

系统规定参数。取值:DescribeTask

TaskId String t-*********************

任务ID。

返回数据

名称 类型 示例值 描述
Code String 200

HttpCode

CompletedTime Long 1615607706

任务完成时间。UNIX时间,单位秒。

CreatedTime Long 1615607706

任务创建时间。UNIX时间,单位秒。

Description String completed

任务状态。取值范围:

  • created:表示任务已创建。
  • expired:表示任务已过期。
  • completed:表示任务已完成。
  • cancelled:表示任务已取消。
Message String successful

返回信息描述,成功一般返回successful,错误时会返回相应错误信息。

Name String InstallBackupClientsTask

任务名称。

Progress Integer 100

任务进度。取值范围为0~100,单位为百分比(%)。任务失败时直接返回-1。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

Result String {}

任务结果。

Success Boolean true

请求是否成功。

  • true表示成功。
  • false表示失败。
UpdatedTime Long 1615607706

任务更新时间。UNIX时间,单位秒。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeTask
&<公共请求参数>

正常返回示例

XML格式

<DescribeTaskResponse>
  <Progress>100</Progress>
  <CreatedTime>1615607706</CreatedTime>
  <Description>completed</Description>
  <Message>successful</Message>
  <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  <CompletedTime>1615607706</CompletedTime>
  <UpdatedTime>1615607706</UpdatedTime>
  <Code>200</Code>
  <Success>true</Success>
  <Name>InstallBackupClientsTask</Name>
  <Result>{}</Result>
</DescribeTaskResponse>

JSON格式

{
    "Progress": 100,
    "CreatedTime": 1615607706,
    "Description": "completed",
    "Message": "successful",
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "CompletedTime": 1615607706,
    "UpdatedTime": 1615607706,
    "Code": 200,
    "Success": true,
    "Name": "InstallBackupClientsTask",
    "Result": "{}"
}

错误码

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