Skip to content

根据主任务UUID列表获得主任务列表 ​

根据主任务 UUID 列表批量查询主任务信息。

接口地址:

text
/papi/zw/task/list

请求方式:

text
POST

请求数据类型:

text
application/json

Header 参数:

参数类型必填说明
X-Access-Keystring是API 访问密钥 ID,鉴权方式见 接口规则
X-Signaturestring是签名值,Base64 编码的 HMAC-SHA256 计算结果
X-Timestampstring是毫秒级 Unix 时间戳(13 位)
X-Noncestring是随机字符串,10~32 位小写字母+数字

Body 参数:

参数类型必填说明
taskIdListarray[string]是主任务 UUID 列表

请求示例:

json
{
  "taskIdList": [
    "5350ac07-254f-4757-b65b-3790bb968687"
  ]
}

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataarray[object]返回数据
├─ subtaskIdstring子任务 UUID
├─ sequenceNointeger执行序号
├─ operationNamestring操作名称
├─ statusinteger子任务状态:1-执行中 2-执行成功 3-执行失败
├─ resultstring执行结果
├─ msgstring错误信息
├─ ctimeinteger创建时间戳
├─ finishedTimeinteger完成时间戳
├─ platformstring平台
├─ ctrIdstring云机 CtrId
├─ ctrAliasstring云机别称
msgstring错误提示

响应示例:

json
{
  "code": 0,
  "data": [
    {
      "subtaskId": "c5cb406f-b7ce-41fc-be4c-4d3fdf9cde74",
      "sequenceNo": 1,
      "operationName": "云机重启",
      "status": 2,
      "result": "success",
      "msg": "",
      "ctime": 1700000000000,
      "finishedTime": 1700000001000,
      "platform": "android",
      "ctrId": "ctr-xxx",
      "ctrAlias": "测试设备"
    }
  ],
  "msg": ""
}

OpenAPI Docs