更新时间:2026-01-08 GMT+08:00

查询软件列表

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

app_name

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 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

请求已成功

错误码

请参见错误码