根据主任务UUID获得子任务列表
根据主任务 UUID 查询该主任务下的所有子任务。
接口地址:
text
/papi/zw/subtask/list请求方式:
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 位小写字母+数字 |
Body 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | string | 是 | 主任务 UUID |
请求示例:
json
{
"taskId": "5350ac07-254f-4757-b65b-3790bb968687"
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | 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 |
| msg | string | 错误提示 |
响应示例:
json
{
"code": 0,
"data": [
{
"taskUuid": "5350ac07-254f-4757-b65b-3790bb968687",
"subtaskId": "c5cb406f-b7ce-41fc-be4c-4d3fdf9cde74",
"sequenceNo": 1,
"operationName": "云机重启",
"status": 2,
"result": "success",
"msg": "",
"ctime": 1700000000000,
"finishedTime": 1700000001000,
"platform": "android",
"ctrId": "ctr-xxx",
"ctrAlias": "测试设备",
"resData": "{}"
}
],
"msg": ""
}