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

查询账号信息列表

功能介绍

查询账号信息列表，支持通过传入账号名称参数查询对应的服务器数

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目id
表2 Query参数

参数

是否必选

参数类型

描述

user_name

否

String

账号名称，参考windows文件命名规则，支持字母、数字、下划线、中文，特殊字符!@.-等，不包括中文标点符号

enterprise_project_id

否

String

企业项目

limit

否

Integer

默认10

offset

否

Integer

默认是0

category

否

String

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

  • host：主机

  • container：容器

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

是

String

iam token

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

账号总数

data_list

Array of UserStatisticInfoResponseInfo objects

账户统计信息列表
表5 UserStatisticInfoResponseInfo

参数

参数类型

描述

user_name

String

账号名称

num

Integer

账号数量

请求示例

默认查询前10条账号信息列表

GET https://{endpoint}/v5/{project_id}/asset/user/statistics

响应示例

状态码：200

具备该账号的主机数量

{
  "total_num" : 1,
  "data_list" : [ {
    "user_name" : "bin",
    "num" : 5
  } ]
}

状态码

状态码

描述

200

具备该账号的主机数量

错误码

请参见错误码。

父主题： 资产管理