查询云服务器列表

project_id

是

String

项目ID

enterprise_project_id

否

String

企业项目ID，查询所有企业项目时填写：all_granted_eps

version

否

String

主机开通的版本，包含如下7种输入。

• hss.version.null ：无。

• hss.version.basic ：基础版。

• hss.version.advanced ：专业版。

• hss.version.enterprise ：企业版。

• hss.version.premium ：旗舰版。

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

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

agent_status

否

String

Agent状态，包含如下6种。

• installed ：已安装。

• not_installed ：未安装。

• online ：在线。

• offline ：离线。

• install_failed ：安装失败。

• installing ：安装中。

• not_online ：不在线的（除了在线以外的所有状态，仅作为查询条件）。

detect_result

否

String

检测结果，包含如下4种。

• undetected ：未检测。

• clean ：无风险。

• risk ：有风险。

• scanning ：检测中。

host_name

否

String

服务器名称

host_id

否

String

服务器ID

host_status

否

String

主机状态，包含如下4种。

• ACTIVE ：正在运行。

• SHUTOFF ：关机。

• BUILDING ：创建中。

• ERROR ：故障。

os_type

否

String

操作系统类型，包含如下2种。

• Linux ：Linux。

• Windows ：Windows。

private_ip

否

String

服务器私有IP

public_ip

否

String

服务器公网IP

ip_addr

否

String

公网或私网IP

protect_status

否

String

防护状态，包含如下2种。

• closed ：关闭。

• opened ：开启。

group_id

否

String

服务器组ID

group_name

否

String

服务器组名称

has_intrusion

否

Boolean

存在告警事件

policy_group_id

否

String

策略组ID

policy_group_name

否

String

策略组名称

charging_mode

否

String

收费模式，包含如下：

• on_demand ：按需

refresh

否

Boolean

是否强制从ECS同步主机

above_version

否

Boolean

是否返回比当前版本高的所有版本

outside_host

否

Boolean

是否云主机

asset_value

否

String

资产重要性，包含如下4种

• important ：重要资产

• common ：一般资产

• test ：测试资产

label

否

String

资产标签

server_group

否

String

资产服务器组

agent_upgradable

否

Boolean

agent是否可升级

limit

否

Integer

每页显示数量

offset

否

Integer

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

X-Auth-Token

是

String

用户Token。

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

region

否

String

Region ID

total_num

Integer

总数

data_list

Array of Host objects

查询弹性云服务器状态列表

host_name

String

服务器名称

host_id

String

服务器ID

agent_id

String

Agent ID

private_ip

String

私有IP地址

public_ip

String

弹性公网IP地址

enterprise_project_id

String

企业项目ID

enterprise_project_name

String

所属企业项目名称

host_status

String

服务器状态，包含如下4种。

• ACTIVE ：运行中。

• SHUTOFF ：关机。

• BUILDING ：创建中。

• ERROR ：故障。

agent_status

String

Agent状态，包含如下5种。

• installed ：已安装。

• not_installed ：未安装。

• online ：在线。

• offline ：离线。

• install_failed ：安装失败。

• installing ：安装中。

install_result_code

String

安装结果，包含如下12种。

• install_succeed ：安装成功。

• network_access_timeout ：网络不通，访问超时。

• invalid_port ：无效端口。

• auth_failed ：认证错误，口令不正确。

• permission_denied ：权限错误，被拒绝。

• no_available_vpc ：没有相同VPC的agent在线虚拟机。

• install_exception ：安装异常。

• invalid_param ：参数错误。

• install_failed ：安装失败。

• package_unavailable ：安装包失效。

• os_type_not_support ：系统类型错误。

• os_arch_not_support ：架构类型错误。

version

String

主机开通的版本，包含如下7种输入。

• hss.version.null ：无。

• hss.version.basic ：基础版。

• hss.version.advanced ：专业版。

• hss.version.enterprise ：企业版。

• hss.version.premium ：旗舰版。

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

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

protect_status

String

防护状态，包含如下2种。

• closed ：未防护。

• opened ：防护中。

os_image

String

系统镜像

os_type

String

操作系统类型，包含如下2种。

• Linux ：Linux。

• Windows ：Windows。

os_bit

String

操作系统位数

detect_result

String

云主机安全检测结果，包含如下4种。

• undetected ：未检测。

• clean ：无风险。

• risk ：有风险。

• scanning ：检测中。

expire_time

Long

试用版到期时间（-1表示非试用版配额，当值不为-1时为试用版本过期时间）

charging_mode

String

收费模式，包含如下：

• on_demand ：按需。

resource_id

String

主机安全配额ID（UUID）

outside_host

Boolean

是否非云机器

group_id

String

服务器组ID

group_name

String

服务器组名称

policy_group_id

String

策略组ID

policy_group_name

String

策略组名称

asset

Integer

资产风险

vulnerability

Integer

漏洞风险总数，包含Linux软件漏洞、Windows系统漏洞、Web-CMS漏洞、应用漏洞

baseline

Integer

基线风险总数，包含配置风险、弱口令

intrusion

Integer

入侵风险总数

asset_value

String

资产重要性，包含如下4种

• important ：重要资产

• common ：一般资产

• test ：测试资产

labels

Array of strings

标签列表

agent_create_time

Long

agent安装时间，采用时间戳，默认毫秒，

agent_update_time

Long

agent状态修改时间，采用时间戳，默认毫秒，

agent_version

String

agent版本

upgrade_status

String

升级状态，包含如下4种。

• not_upgrade ：未升级，也就是默认状态，客户还没有给这台机器下发过升级。

• upgrading ：正在升级中。

• upgrade_failed ：升级失败。

• upgrade_succeed ：升级成功。

upgrade_result_code

String

升级失败原因，只有当 upgrade_status 为 upgrade_failed 时才显示，包含如下6种。

• package_unavailable ：升级包解析失败，升级文件有错误。

• network_access_timeout ：下载升级包失败，网络异常。

• agent_offline ：agent离线。

• hostguard_abnormal ：agent工作进程异常。

• insufficient_disk_space ：磁盘空间不足。

• failed_to_replace_file ：替换文件失败。

upgradable

Boolean

该服务器agent是否可升级

open_time

Long

开启防护时间，采用时间戳，默认毫秒，

protect_interrupt

Boolean

防护是否中断

200

请求已成功