本文导读

功能介绍
调用方法
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 通用任务模块/ 查询任务列表

查询任务列表

更新时间：2025-07-01 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

查询任务列表

调用方法

请参见如何调用API。

URI

POST /v5/{project_id}/common/tasks/batch-query

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目ID，可通过我的凭证，项目id获取约束限制: 不涉及取值范围: 字符长度1-256位默认取值: 不涉及

表2 Query参数
参数	是否必选	参数类型	描述
enterprise_project_id	否	String	参数解释: 主机所属的企业项目ID。企业项目ID默认取值为“0”，表示默认企业项目。如果需要查询所有企业项目下的主机，请传参“all_granted_eps”。如果您只有某个企业项目的权限，则需要传递该企业项目ID，查询该企业项目下的主机，否则会因权限不足而报错。约束限制: 开通企业项目功能后才需要配置企业项目。取值范围: 字符长度1-256位默认取值: 0
offset	否	Integer	偏移量：指定返回记录的开始位置，必须为数字，取值范围为大于或等于0，默认0
limit	否	Integer	参数解释: 每页显示个数约束限制: 不涉及取值范围: 取值10-200 默认取值: 10

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

表4 请求Body参数
参数	是否必选	参数类型	描述
task_type	是	String	任务类型，包含如下 cluster_scan：集群扫描 iac_scan：iac扫描
task_id	否	String	本次创建任务的id
task_name	否	String	模糊匹配任务名称
start_create_time	否	Long	按任务创建时间范围查询时的起始时间
end_create_time	否	Long	按任务创建时间范围查询时的结束时间
trigger_type	否	String	任务触发类型，包含如下 manual：手动创建的任务 schedule：定时任务
task_status	否	String	任务状态，包含如下 ready：等待执行 running：运行中 finished：任务结束
iac_scan_info	否	iac_scan_info object	IAC安全扫描任务的参数，任务类型task_type为“iac_scan”时可传

表5 iac_scan_info
参数	是否必选	参数类型	描述
file_type	否	String	文件类型，包含如下 dockerfile：Dockerfile文件 k8s_yaml：k8s yaml文件

响应参数

状态码：200

表6 响应Body参数
参数	参数类型	描述
total_num	Integer	任务列表数量
data_list	Array of data_list objects	任务列表

表7 data_list
参数	参数类型	描述
task_id	String	本次创建任务的id
task_type	String	任务类型，包含如下 cluster_scan：集群扫描 iac_scan：iac扫描
task_name	String	任务名称
trigger_type	String	任务触发类型，包含如下 manual：手动创建的任务 schedule：定时任务
task_status	String	任务状态，包含如下 ready：等待执行 running：运行中 finished：任务结束
start_time	Long	任务开始的时间
end_time	Long	任务结束的时间
estimated_time	Integer	预计当前任务结束还需要的时间，单位为分钟
cluster_scan_info	cluster_scan_info object	集群扫描任务特有的任务信息
iac_scan_info	iac_scan_info object	IAC安全扫描任务特有的任务信息

表8 cluster_scan_info
参数	参数类型	描述
scan_type_list	Array of strings	本次扫描任务涉及的扫描项类型列表
scanning_cluster_num	Integer	当前任务处于扫描中的集群数量
success_cluster_num	Integer	当前任务扫描成功的集群数量
failed_cluster_num	Integer	当前任务扫描失败的集群数量

表9 iac_scan_info
参数	参数类型	描述
file_type	String	文件类型，包含如下 dockerfile：Dockerfile文件 k8s_yaml：k8s yaml文件
scan_file_num	Integer	当前任务扫描的文件总数
success_file_num	Integer	当前任务扫描成功的文件数量
failed_file_num	Integer	当前任务扫描失败的文件数量

请求示例

无

响应示例

状态码：200

请求已成功

{
  "total_num" : 1,
  "data_list" : [ {
    "task_id" : "d8xxxx05-8xx5-4xx0-9xx6-c3dbxxxxxxac",
    "task_type" : "cluster_scan",
    "trigger_type" : "manual",
    "task_status" : "running",
    "start_time" : 1745311451000,
    "end_time" : 1745311451000,
    "estimated_time" : 5,
    "cluster_scan_info" : {
      "scan_type_list" : [ "cluster_vul" ],
      "scanning_cluster_num" : 2,
      "success_cluster_num" : 1,
      "failed_cluster_num" : 1
    }
  } ]
}

状态码


状态码	描述
200	请求已成功

错误码

请参见错误码。

父主题：通用任务模块

上一篇：创建任务

下一篇：查询当前任务关联的资源列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

查询任务列表

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

文档反馈