文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 资产管理/ 查询中间件列表 - ListJarPackageStatistics
更新时间:2025-10-31 GMT+08:00
分享

查询中间件列表 - ListJarPackageStatistics

功能介绍

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

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v5/{project_id}/asset/midwares

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

主机所属的企业项目ID。

开通企业项目功能后才需要配置企业项目。

企业项目ID默认取值为“0”,表示默认企业项目。如果需要查询所有企业项目下的主机,请传参“all_granted_eps”。如果您只有某个企业项目的权限,则需要传递该企业项目ID,查询该企业项目下的主机,否则会因权限不足而报错。

file_name

String

jar包名称

category

String

类别,包含如下:

  • host : 主机

  • container : 容器

limit

Integer

每页显示数量

offset

Integer

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

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

参数解释:

中间件包的统计信息总数

取值范围:

取值0-10000

data_list

Array of JarPackageStatisticsResponseInfo objects

参数解释:

中间件包统计信息列表

表5 JarPackageStatisticsResponseInfo

参数

参数类型

描述

file_name

String

参数解释:

中间件包名称

取值范围:

字符长度0-256

num

Integer

参数解释:

中间件包统计信息总数

取值范围:

取值0-300000

请求示例

默认查询前10条中间件名称为rt.jar,类别为主机的中间件列表

GET https://{endpoint}/v5/{project_id}/asset/midwares?file_name=rt.jar&category=host

响应示例

状态码:200

请求已成功

{
  "data_list" : [ {
    "file_name" : "rt.jar",
    "num" : 18
  } ],
  "total_num" : 1
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档