# 查询设备关联的任务\&子任务列表（API名称：getSceneTaskList） #### 功能介绍 用于用户系统查询设备关联的任务、子任务列表。 #### 相关接口 | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 | #### URL | **请求方式** | **HTTPS地址** | **服务架构** | **消息体类型** | |:---|:---|:---|:---| | POST | https://***isdp+域名***/openapi/v1/openSceneTaskObject/getSceneTaskList | OpenAPI | application/json | #### 请求头 | **KEY** | VALUE | 是否必填 | **描述** | |:---|:---|:---|:---| | Content-Type | application/json | 是 | 无 | | Authorization | bearer ${access_token} | 是 | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 | #### 请求参数 | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | page.start | int | 是 | 分页起始行 | | page.count | int | 是 | 分页大小 | | queryType | int | 是 | 查询类型(1:查询巡检计划列表；2：查询巡检历史列表) | | status | String | 否 | 任务、子任务状态(仅支持1：待执行；2：执行中；3：已完成状态。)多个任务状态用英文逗号隔开； | | orderType | int | 否 | 排序（1：升序；2：降序。如果queryType为1，按照计划完成时间升、降序排，queryType为2，按照实际完成时间升降序排），为空则按照升序排 | | timeRangeList | List\ | 否 | 计划完成、实际完成过滤范围，设置开始、结束时间的毫秒数 | | sourceObjectIdList | List\ | 是 | 设备id集合，单次请求最多100个 | #### 响应参数 | **参数** | **类型** | **描述** | |:---|:---|:---| | stateCode | String | 接口响应编码，0成功，非0失败 | | errorMessage | String | 接口错误提示信息 | | result | Map | 接口响应数据。 | result出参： | **参数** | **类型** | **描述** | |:---|:---|:---| | result.data | List\\> | 任务、子任务列表 | | data.taskName | String | 任务、子任务名称 | | data. taskType | int | 1:任务；2：子任务 | | data. sceneTaskId | Long | 任务、子任务主键id | | data. sceneMode | int | 任务模式 | | data.isNa | int | 是否子任务na | | data.status | int | 任务、子任务状态（1：待执行；2：执行中；3：已完成） | | data.endTimestamp | Long | 任务、子任务计划完成时间，毫秒数 | | data.parentCategory | String | 领域 | | data.sceneName | String | 场景 | | data. adminOrganization | String | 组织单元 | | data.actualEndTime | Long | 实际完成时间，毫秒数 | | data.executorList | List\\> | 执行人 | | data.executorList.userId | Long | 执行人ID | | data.executorList.userName | String | 执行人名称 | | data.executorList.userType | int | 执行人类型1：个人；2：群组 | | data.executorList.sceneTaskId | Long | 执行人关联的任务、子任务ID | | data.totalCount | int | 进展任务总数 | | data.finishCount | int | 进展完成任务数 | | data.isExpire | String | 是否逾期0：未逾期；1：逾期 | | pos | int | 当前查询起始行 | | total_count | int | 任务总数 | | entityName | String | 实体名称 | | totalCount | int | 任务总数 | #### 请求示例 ``` { "page": { "count": 15, "start": 0 }, "queryType": 1, "sourceObjectIdList": [ "H06041--1" ] } ``` #### 响应示例 ``` { "stateCode": "0", "errorMessage": null, "result": { "data": [ { "taskName": "1_20220908_144225", "taskType": 2, "sceneTaskId": 1919494, "sceneMode": 4, "isNa": 0, "status": 1, "endTimestamp": null, "parentTaskId": 2949685, "parentCategory": "", "sceneName": "", "adminOrganization": "", "actualEndTime": null, "executorList": [ { "userId": 153169, "userName": "lyl09修改", "userType": 1, "sceneTaskId": 1919494 } ], "totalCount": 1, "finishCount": 0, "isExpire": 0 }, { "taskName": "2_20220908_144225", "taskType": 2, "sceneTaskId": 1919495, "sceneMode": 4, "isNa": 0, "status": 1, "endTimestamp": null, "parentTaskId": 2949685, "parentCategory": "", "sceneName": "", "adminOrganization": "", "actualEndTime": null, "executorList": [ { "userId": 153169, "userName": "lyl09修改", "userType": 1, "sceneTaskId": 1919495 } ], "totalCount": 1, "finishCount": 0, "isExpire": 0 }, { "taskName": "1_20220908_144443", "taskType": 2, "sceneTaskId": 1919498, "sceneMode": 4, "isNa": 0, "status": 1, "endTimestamp": null, "parentTaskId": 2949686, "parentCategory": "", "sceneName": "", "adminOrganization": "", "actualEndTime": null, "executorList": [ { "userId": 153169, "userName": "lyl09修改", "userType": 1, "sceneTaskId": 1919498 } ], "totalCount": 1, "finishCount": 0, "isExpire": 0 }, { "taskName": "1_20220909_151311", "taskType": 2, "sceneTaskId": 1919657, "sceneMode": 4, "isNa": 0, "status": 1, "endTimestamp": null, "parentTaskId": 2951381, "parentCategory": "", "sceneName": "", "adminOrganization": "", "actualEndTime": null, "executorList": [ { "userId": 153169, "userName": "lyl09修改", "userType": 1, "sceneTaskId": 1919657 } ], "totalCount": 1, "finishCount": 0, "isExpire": 0 }, { "taskName": "子任务1_20220914_142712", "taskType": 2, "sceneTaskId": 1920826, "sceneMode": 4, "isNa": 0, "status": 1, "endTimestamp": 1663136980000, "parentTaskId": 2955633, "parentCategory": "", "sceneName": "", "adminOrganization": "", "actualEndTime": null, "executorList": [ { "userId": 25804, "userName": "刘月", "userType": 1, "sceneTaskId": 1920826 } ], "totalCount": 1, "finishCount": 0, "isExpire": 1 }, { "taskName": "14:40_20220908_144225", "taskType": 1, "sceneTaskId": 2949685, "sceneMode": 4, "isNa": 0, "status": 1, "endTimestamp": null, "parentTaskId": 0, "parentCategory": "", "sceneName": "14:40", "adminOrganization": "杨凌作业系统测试№", "actualEndTime": null, "executorList": [ { "userId": 153169, "userName": "lyl09修改", "userType": 1, "sceneTaskId": 2949685 } ], "totalCount": 2, "finishCount": 0, "isExpire": 0 }, { "taskName": "测试计划结束", "taskType": 1, "sceneTaskId": 2955633, "sceneMode": 4, "isNa": 0, "status": 1, "endTimestamp": 1663136980000, "parentTaskId": 0, "parentCategory": "", "sceneName": "测试统计计划结束时间", "adminOrganization": "杨凌作业系统测试№", "actualEndTime": null, "executorList": [ { "userId": 25804, "userName": "刘月", "userType": 1, "sceneTaskId": 2955633 } ], "totalCount": 1, "finishCount": 0, "isExpire": 1 } ], "pos": 0, "total_count": 7, "entityName": null, "totalCount": 7 } } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。