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

查询账号信息列表

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID
表2 Query参数

参数

是否必选

参数类型

描述

user_name

否

String

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

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

账户统计信息列表
表5 UserStatisticInfoResponseInfo

参数

参数类型

描述

user_name

String

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

num

Integer

当前账号的主机数量

请求示例

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

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

响应示例

状态码：200

请求已成功

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

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码。

父主题： 资产管理