查询主机列表 （推荐）

group_id

是

String

参数解释：

主机集群id。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

key_field

否

String

参数解释：

主机名称或IP中的关键字。

约束限制：

不涉及。

取值范围：

最大长度不超过128个字符。

默认取值：

不涉及。

environment_id

否

String

参数解释：

环境id。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

page_index

否

Integer

参数解释：

分页查询页码数。

约束限制：

不涉及。

取值范围：

1-2147483647

默认取值：

1

page_size

否

Integer

参数解释：

分页查询每页显示的条目数量。

约束限制：

不涉及。

取值范围：

1-100

默认取值：

10

sort_key

否

String

参数解释：

查询排序字段。

约束限制：

不涉及。

取值范围：

• host_name：主机名称。

• as_proxy：是否代理机。

默认取值：

不涉及。

sort_dir

否

String

参数解释：

排序方式。

约束限制：

不涉及。

取值范围：

• desc：降序排列。

• asc：升序排列。

默认取值：

desc

as_proxy

否

Boolean

参数解释：

是否为代理机。

约束限制：

不涉及。

取值范围：

• true：是代理机。

• false：不是代理机。

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

字符串，长度不超过20000个字符。

默认取值：

不涉及。

total

Integer

参数解释：

主机数量。

取值范围：

0-200

status

String

参数解释：

请求成功、失败状态。

取值范围：

• success：请求成功。

• failed：请求失败。

result

Array of HostInfo objects

参数解释：

主机信息列表。

uuid

String

参数解释：

主机id。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

ip

String

参数解释：

主机IP。

取值范围：

不涉及。

os

String

参数解释：

主机集群的操作系统类型。

取值范围：

• windows：windows操作系统类型。

• linux：linux操作系统类型。

port

Integer

参数解释：

端口号。

取值范围：

0-65535。

authorization

HostAuthorizationBody object

参数解释：

登录主机鉴权，使用密码登录则填写密码即可，使用密钥则填写密钥，二选一即可。

permission

PermissionHostDetailNew object

参数解释：

当前用户对主机的操作权限矩阵。

host_name

String

参数解释：

主机名称。

取值范围：

只能由中文字符、英文字母、数字及"-"、"_"、"."组成，且长度为[3-128]个字符。

as_proxy

Boolean

参数解释：

是否是代理机。

取值范围：

• true：是代理机。

• false：非代理机。

group_id

String

参数解释：

主机集群id。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

proxy_host_id

String

参数解释：

代理主机id。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

owner_id

String

参数解释：

创建者id。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

owner_name

String

参数解释：

创建者用户名称。

取值范围：

只能由英文字母、数字及_组成，最大长度不超过255字符。

proxy_host

HostInfo object

参数解释：

代理机信息详情。

connection_status

String

参数解释：

连通性状态。

取值范围：

• success：连接成功。

• failed：连接失败。

create_time

String

参数解释：

创建时间，格式为yyyy-MM-dd HH:mm:ss。例如：'2025-04-21 17:05:53'。

取值范围：

不涉及。

lastest_connection_time

String

参数解释：

最后一次主机连通性验证时间，格式为yyyy-MM-dd HH:mm:ss。例如：'2025-04-21 17:05:53'。

取值范围：

不涉及。

connection_result

String

参数解释：

连通性验证结果。

取值范围：

不涉及。

nick_name

String

参数解释：

创建者用户昵称。

取值范围：

字符串，长度为[1-30]个字符。

import_status

String

参数解释：

导入状态。

取值范围：

• 0：未导入。

• 1：已导入。

env_count

Integer

参数解释：

关联环境数量。

取值范围：

0-200。

username

String

参数解释：

登录主机用户名。

取值范围：

只能由字母、数字、下划线、中划线、点号、 @ 符号组成，长度[2-32]字符。

password

String

参数解释：

密码，认证类型为0时，密码必填。

取值范围：

不能包含空格、换行符、回车符、制表符、双引号和单引号，且长度[5-32]个字符。

private_key

String

参数解释：

密钥，认证类型为1时，密钥必填。

取值范围：

最大长度不超过5000个字符。

trusted_type

Integer

参数解释：

登录主机时认证类型。

取值范围：

• 0：密码认证。

• 1：密钥认证。

can_view

Boolean

参数解释：

是否有查看权限。

取值范围：

• true: 有权限

• false: 无权限

can_edit

Boolean

参数解释：

是否有编辑权限。

取值范围：

• true: 有权限

• false: 无权限

can_delete

Boolean

参数解释：

是否有删除的权限。

取值范围：

• true: 有权限

• false: 无权限

can_add_host

Boolean

参数解释：

是否有添加主机权限。

取值范围：

• true：有添加主机权限。

• false：无添加主机权限。

can_copy

Boolean

参数解释：

是否有复制主机的权限。

取值范围：

• true：有复制主机的权限。

• false：无复制主机的权限。

200

OK 请求响应成功