文档首页/ 企业主机安全 HSS/ API参考（吉隆坡区域）/ API说明/ 资产管理/ 查询软件列表
更新时间：2025-09-23 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询软件列表

功能介绍

查询软件列表，支持通过软件名称查询对应的服务器数

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户ID
表2 Query参数

参数

是否必选

参数类型

描述

app_name

否

String

软件名称

enterprise_project_id

否

String

企业项目

limit

否

Integer

默认10

offset

否

Integer

偏移量，为页数*每页显示条数

category

否

String

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

  • host：主机

  • container：容器

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

是

String

iam token

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

进程统计信息总数,

data_list

Array of AppStatisticResponseInfo objects

进程统计信息列表
表5 AppStatisticResponseInfo

参数

参数类型

描述

app_name

String

软件名称

num

Integer

进程数量

请求示例

默认查询前10条类别为主机的软件列表

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

响应示例

状态码：200

具备该软件的主机数量

{
  "total_num" : 1,
  "data_list" : [ {
    "app_name" : "kernel",
    "num" : 13
  } ]
}

状态码

状态码

描述

200

具备该软件的主机数量

错误码

请参见错误码。

父主题： 资产管理