获得子任务分页
按条件分页查询子任务列表。
接口地址:
text
/papi/zw/subtask/page请求方式:
text
POST请求数据类型:
text
application/jsonHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-Access-Key | string | 是 | API 访问密钥 ID,鉴权方式见 接口规则 |
| X-Signature | string | 是 | 签名值,Base64 编码的 HMAC-SHA256 计算结果 |
| X-Timestamp | string | 是 | 毫秒级 Unix 时间戳(13 位) |
| X-Nonce | string | 是 | 随机字符串,10~32 位小写字母+数字 |
Query 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | string | 是 | 编号列表,多个用逗号分隔,如:1024,2048 |
Body 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| pageNo | integer | 否 | 页码,从 1 开始,默认 1 |
| pageSize | integer | 否 | 每页条数,最大值为 1000,默认 10 |
| status | integer | 否 | 子任务状态:1-执行中 2-执行成功 3-执行失败 |
| taskSid | string | 否 | 主任务 ID |
| operationName | string | 否 | 操作名称 |
请求示例:
json
{
"pageNo": 1,
"pageSize": 10,
"status": 0,
"taskSid": "c5cb406f-b7ce-41fc-be4c-4d3fdf9cde74",
"operationName": "异步安装应用"
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | object | 返回数据 |
| ├─ list | array[object] | 数据列表 |
| ├─├─ taskUuid | string | 主任务 ID |
| ├─├─ subtaskId | string | 子任务 UUID |
| ├─├─ sequenceNo | integer | 执行序号 |
| ├─├─ operationName | string | 操作名称 |
| ├─├─ status | integer | 子任务状态:1-执行中 2-执行成功 3-执行失败 |
| ├─├─ result | string | 执行结果 |
| ├─├─ msg | string | 错误信息 |
| ├─├─ ctime | integer | 创建时间戳 |
| ├─├─ finishedTime | integer | 完成时间戳 |
| ├─├─ platform | string | 平台 |
| ├─├─ ctrId | string | 云机 CtrId |
| ├─├─ ctrAlias | string | 云机别称 |
| ├─├─ resData | string | 返回 JSON |
| ├─ total | integer | 数据总量 |
| msg | string | 错误提示 |
响应示例:
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": ""
}