文档首页/ 企业主机安全 HSS/ API参考（联盟区域）/ API说明/ 资产管理/ 查询进程列表
更新时间：2026-01-08 GMT+08:00
查看PDF
分享

查询进程列表

功能介绍

查询进程列表，通过传入进程路径参数查询对应的服务器数

URI

GET /v5/{project_id}/asset/process/statistics

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID
表2 Query参数

参数

是否必选

参数类型

描述

path

否

String

可执行进程路径

enterprise_project_id

否

String

企业项目ID，查询所有企业项目时填写：all_granted_eps

limit

否

Integer

每页显示数量

offset

否

Integer

偏移量：指定返回记录的开始位置

category

否

String

类别，默认为host，包含如下：

  • host：主机

  • container：容器

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

进程统计信息总数,

data_list

Array of ProcessStatisticResponseInfo objects

进程统计信息列表
表5 ProcessStatisticResponseInfo

参数

参数类型

描述

path

String

进程的可执行文件路径

num

Integer

进程数量

请求示例

默认查询前10条类别为主机的进程列表

GET https://{endpoint}/v5/{project_id}/asset/process/statistics?category=host

响应示例

状态码：200

请求已成功

{
  "total_num" : 1,
  "data_list" : [ {
    "num" : 13,
    "path" : "/usr/lib/systemd/systemd-journald"
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码。

父主题： 资产管理