查询正在处理的任务信息 - ListRunningTask

功能介绍

查询正在处理的任务信息

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

kps::getRunningTask

List

-

-

kps:domainKeypairs:getrunningtask

-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
kps::getRunningTask	List	-	-	kps:domainKeypairs:getrunningtask	-

URI

GET /v3/{project_id}/running-tasks

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID。可参考获取项目ID获取。约束限制：不涉及取值范围：以IAM服务接口返回值为准，字符长度32-32 默认取值：不涉及

表2 Query参数
参数	是否必选	参数类型	描述
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	参数解释：正在处理的任务列表取值范围：不涉及

表5 RunningTasks
参数	参数类型	描述
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

{
  "total" : 1,
  "tasks" : [ {
    "task_id" : "aee8d2fe-5484-4753-9177-5a38dc15546c",
    "operate_type" : "RUNNING_RESET",
    "task_time" : "1523342130000",
    "server_name" : "Test",
    "server_id" : "c9aa197b-a6b6-4c33-b3a6-fa0b4ec50006",
    "keypair_name" : "KeyPair-xt"
  } ]
}