查询服务器列表-公共接口 - ListCommonHost

project_id

是

String

参数解释:

项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产。获取方式请参见获取项目ID。

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

enterprise_project_id

否

String

参数解释:

企业项目ID，用于过滤不同企业项目下的资产。获取方式请参见获取企业项目ID。

如需查询所有企业项目下的资产请传参“all_granted_eps”。

约束限制:

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

取值范围:

字符长度1-256位

默认取值:

0，表示默认企业项目（default）。

offset

是

Integer

参数解释:

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

约束限制:

不涉及

取值范围:

最小值0，最大值2000000

默认取值:

不涉及

limit

是

Integer

参数解释:

每页显示个数

约束限制:

必填

取值范围:

取值10-200

默认取值:

10

host_id

否

String

参数解释:

服务器ID

约束限制:

不涉及

取值范围:

字符长度1-64位

默认取值:

不涉及

host_name

否

String

参数解释:

服务器名称

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

private_ip

否

String

参数解释:

服务器私有IP

约束限制:

不涉及

取值范围:

字符长度1-128位

默认取值:

不涉及

public_ip

否

String

参数解释:

服务器弹性IP地址

约束限制:

不涉及

取值范围:

IPv4格式（长度7-15位）、IPv6格式（长度15-39位）

默认取值:

无

feature_name

否

String

参数解释:

策略名称

约束限制:

不涉及

取值范围:

取值范围:

• av_detect_feature：AV策略

默认取值:

无

group_id

否

String

参数解释:

服务器组的唯一标识ID

约束限制:

不涉及

取值范围:

字符长度1-64位

默认取值:

不涉及

asset_value

否

String

参数解释:

资产重要性

约束限制:

不涉及

取值范围：

• important：重要资产

• common：一般资产

• test：测试资产

默认取值:

不涉及

agent_status

否

String

参数解释：

Agent状态

约束限制:

不涉及

取值范围：

• installed：已安装

• not_installed：未安装

• online：在线

• offline：离线

• install_failed：安装失败

• installing：安装中

默认取值:

不涉及

cluster_id

否

String

参数解释:

集群ID

约束限制:

不涉及

取值范围:

字符长度1-64位

默认取值:

不涉及

cluster_name

否

String

参数解释:

集群名称

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

version_name_upper

否

String

参数解释：

主机开通的版本,高于该版本

约束限制:

不涉及

取值范围：

• hss.version.basic：基础版。

• hss.version.advanced：专业版。

• hss.version.enterprise：企业版。

• hss.version.premium：旗舰版。

• hss.version.wtp：网页防篡改版。

• hss.version.container.enterprise：容器版。

默认取值:

不涉及

version_name_lower

否

String

参数解释：

主机开通的版本,低于该版本

约束限制:

不涉及

取值范围：

• hss.version.basic：基础版。

• hss.version.advanced：专业版。

• hss.version.enterprise：企业版。

• hss.version.premium：旗舰版。

• hss.version.wtp：网页防篡改版。

• hss.version.container.enterprise：容器版。

默认取值:

不涉及

X-Auth-Token

是

String

参数解释:

用户Token，包含了用户的身份、权限等信息，在调用API接口时，可通过Token进行身份认证。获取方式请参见获取用户Token。

约束限制:

不涉及

取值范围:

字符长度1-32768位

默认取值:

不涉及

total_num

Integer

参数解释:

总数

取值范围:

最小值0，最大值2147483647

data_list

Array of CommonHostResponseInfo objects

列表

host_id

String

参数解释:

服务器的唯一标识ID

取值范围:

字符长度1-64位

host_name

String

参数解释:

服务器名称

取值范围:

字符长度1-256位

public_ip

String

参数解释:

服务器弹性IP地址

取值范围:

IPv4格式（长度7-15位）、IPv6格式（长度15-39位）

private_ip

String

参数解释:

服务器私有IP

取值范围:

字符长度1-128位

agent_id

String

参数解释:

主机上安装的杀毒Agent的唯一标识ID，用于关联主机与杀毒服务

取值范围:

字符长度1-64位

os_type

String

参数解释：

操作系统类型

取值范围：

• Linux：Linux

• Windows：Windows

host_status

String

参数解释：

服务器状态

取值范围：

• ACTIVE：运行中

• SHUTOFF：关机

• BUILDING：创建中

• ERROR：故障

agent_status

String

参数解释：

Agent状态

取值范围：

• installed：已安装

• not_installed：未安装

• online：在线

• offline：离线

• install_failed：安装失败

• installing：安装中

os_name

String

参数解释:

操作系统名称

取值范围:

字符长度1-64位

os_version

String

参数解释:

操作系统版本

取值范围:

字符长度1-64位

asset_value

String

参数解释:

资产重要性

约束限制:

不涉及

取值范围：

• important：重要资产

• common：一般资产

• test：测试资产

默认取值:

不涉及

cluster_id

String

参数解释:

集群ID

取值范围:

字符长度1-64位

cluster_name

String

参数解释:

集群名称

取值范围:

字符长度1-256位

group_id

String

参数解释:

服务器组ID

取值范围:

字符范围1-64位

group_name

String

参数解释:

集群名称

取值范围:

字符长度1-256位

200

请求已成功