查询账号的服务器列表
功能介绍
查询账号的服务器列表
URI
GET /v5/{project_id}/asset/users
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| host_id | 否 | String | 主机ID |
| user_name | 否 | String | 账号名称 |
| host_name | 否 | String | 主机名称 |
| private_ip | 否 | String | 服务器私有IP |
| login_permission | 否 | Boolean | 是否允许登录 |
| root_permission | 否 | Boolean | 是否有root权限 |
| user_group | 否 | String | 主机用户组 |
| enterprise_project_id | 否 | String | 企业项目ID，查询所有企业项目时填写：all_granted_eps |
| limit | 否 | Integer | 每页显示数量 |
| offset | 否 | Integer | 偏移量：指定返回记录的开始位置 |
| category | 否 | String | 类别，默认为host，包含如下：
|
| part_match | 否 | Boolean | 是否模糊匹配，默认false表示精确匹配 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total_num | Integer | 账号总数 |
| data_list | Array of UserResponseInfo objects | 账号信息列表 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| agent_id | String | Agent ID |
| host_id | String | 主机ID |
| host_name | String | 服务器名称 |
| host_ip | String | 服务器ip |
| user_name | String | 用户名 |
| login_permission | Boolean | 是否有登录权限 |
| root_permission | Boolean | 是否有root权限 |
| user_group_name | String | 用户组 |
| user_home_dir | String | 用户目录 |
| shell | String | 用户启动shell |
| recent_scan_time | Long | 最近扫描时间 |
| container_id | String | 容器id |
| container_name | String | 容器名称 |
请求示例
默认查询账号为daemon的服务器列表
GET https://{endpoint}/v5/{project_id}/asset/users?user_name=daemon 响应示例
状态码：200
请求已成功
{
"total_num" : 1,
"data_list" : [ {
"agent_id" : "0bf792d910xxxxxxxxxxx52cb7e63exxx",
"host_id" : "13xxxxxxxece69",
"host_ip" : "192.168.0.1",
"host_name" : "test",
"login_permission" : false,
"recent_scan_time" : 1667039707730,
"root_permission" : false,
"shell" : "/sbin/nologin",
"user_group_name" : "bin",
"user_home_dir" : "/bin",
"user_name" : "bin",
"container_id" : "ce794b8a6-xxxx-xxxx-xxxxx-36bedf2c7a4f6083fb82e5bbc82709b50018",
"container_name" : "hss_imagescan_W73V1WO6"
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求已成功 |
错误码
请参见错误码。
