Skip to content

获得子任务分页 ​

按条件分页查询子任务列表。

接口地址:

text
/papi/zw/subtask/page

请求方式:

text
POST

请求数据类型:

text
application/json

Header 参数:

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

Query 参数:

参数类型必填说明
idsstring是编号列表,多个用逗号分隔,如:1024,2048

Body 参数:

参数类型必填说明
pageNointeger否页码,从 1 开始,默认 1
pageSizeinteger否每页条数,最大值为 1000,默认 10
statusinteger否子任务状态:1-执行中 2-执行成功 3-执行失败
taskSidstring否主任务 ID
operationNamestring否操作名称

请求示例:

json
{
  "pageNo": 1,
  "pageSize": 10,
  "status": 0,
  "taskSid": "c5cb406f-b7ce-41fc-be4c-4d3fdf9cde74",
  "operationName": "异步安装应用"
}

响应参数:

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

响应示例:

json
{
  "code": 0,
  "data": {
    "list": [
      {
        "taskUuid": "c5cb406f-b7ce-41fc-be4c-4d3fdf9cde74",
        "subtaskId": "5350ac07-254f-4757-b65b-3790bb968687",
        "sequenceNo": 1,
        "operationName": "异步安装应用",
        "status": 2,
        "result": "success",
        "msg": "",
        "ctime": 1700000000000,
        "finishedTime": 1700000001000,
        "platform": "android",
        "ctrId": "ctr-xxx",
        "ctrAlias": "测试设备",
        "resData": "{}"
      }
    ],
    "total": 50
  },
  "msg": ""
}

OpenAPI Docs