# 查询正在处理的任务信息 - ListRunningTask #### 功能介绍 查询正在处理的任务信息 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-dew/dew_02_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dew/dew_02_0308.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | kps::getRunningTask | List | - | - | kps:domainKeypairs:getrunningtask | - | #### URI GET /v3/{project_id}/running-tasks 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID。可参考[获取项目ID](https://support.huaweicloud.com/api-dew/dew_02_0009.html)获取。 **约束限制：** 不涉及 **取值范围：** 以IAM服务接口返回值为准，字符长度32-32 **默认取值：** 不涉及 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | limit | 否 | Integer | **参数解释：** 查询正在处理的任务列表中每页显示的任务数量 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 1000 | | offset | 否 | Integer | **参数解释：** 索引位置。从offset指定的下一条数据开始查询。查询第一页数据时，将查询前一页数据时响应体中的值带入此参数 **约束限制：** offset必须为数字，不能为负数 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值） **约束限制：** 不涉及 **取值范围：** IAM服务查询用户Token接口为准 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释：** 正在处理的任务总数 **取值范围：** 不涉及 | | tasks | Array of [RunningTasks] objects | **参数解释：** 正在处理的任务列表 **取值范围：** 不涉及 | 表5RunningTasks | 参数 | 参数类型 | 描述 | |:---|:---|:---| | task_id | String | **参数解释：** 任务ID **取值范围：** 不涉及 | | operate_type | String | **参数解释：** 操作类型 **取值范围：** - FAILED_RESET 重置 - FAILED_REPLACE 替换 - FAILED_UNBIND 解绑 | | task_time | String | **参数解释：** 任务时间 **取值范围：** 不涉及 | | server_name | String | **参数解释：** 虚拟机名称 **取值范围：** 不涉及 | | server_id | String | **参数解释：** 虚拟机ID **取值范围：** 不涉及 | | keypair_name | String | **参数解释：** 密钥对名称 **取值范围：** 不涉及 | #### 请求示例 无 #### 响应示例 **状态码：200** OK ``` { "total" : 1, "tasks" : [ { "task_id" : "aee8d2fe-5484-4753-9177-5a38dc15546c", "operate_type" : "FAILED_RESET", "task_time" : "2015-07-16 04:10:52", "server_name" : "Test", "server_id" : "c9aa197b-a6b6-4c33-b3a6-fa0b4ec50006", "keypair_name" : "KeyPair-xt" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-dew/ErrorCode.html)。