Querying ECSs

project_id

Yes

String

Project ID

enterprise_project_id

No

String

Enterprise project ID

version

No

String

HSS edition. Its value can be:

• hss.version.null: none

• hss.version.enterprise: enterprise edition

• hss.version.premium: premium edition

• hss.version.wtp: WTP edition

• hss.version.container.enterprise: container edition

agent_status

No

String

Agent status. Its value can be:

• not_ installed

• online

• offline

• install_failed

• installing

• not_online: All status except online, which is used only as a query condition.

detect_result

No

String

Detection result. Its value can be:

• undetected

• clean

• risk

• scanning

host_name

No

String

Server name

host_id

No

String

Server ID

host_status

No

String

Host status. Its value can be:

• ACTIVE

• SHUTOFF

• BUILDING

• ERROR

os_type

No

String

OS type. Its value can be:

• Linux

• Windows

private_ip

No

String

Server private IP address

public_ip

No

String

Server public IP address

ip_addr

No

String

Public or private IP address

protect_status

No

String

Protection status. Its value can be:

• closed

• opened

group_id

No

String

Server group ID

group_name

No

String

Server group name

policy_group_id

No

String

Policy group ID

policy_group_name

No

String

Policy group name

charging_mode

No

String

on_demand: pay-per-use

refresh

No

Boolean

Whether to forcibly synchronize servers from ECSs

above_version

No

Boolean

Whether to return all the versions later than the current version

outside_host

No

Boolean

Whether a server is a Cloud server

asset_value

No

String

Asset importance. Its value can be:

• important

• common

• test

label

No

String

Asset tag

server_group

No

String

Asset server group

limit

No

Integer

Number of records displayed on each page. The default value is 10.

offset

No

Integer

Offset, which specifies the start position of the record to be returned. The value must be a number no less than 0. The default value is 0.

X-Auth-Token

Yes

String

IAM token.

It can be obtained by calling the IAM API used to obtain an IAM token. The value of X-Subject-Token in the response header is a token.

region

No

String

Region ID

total_num

Integer

Total number of records

data_list

Array of Host objects

Query on the cloud server status and list

host_name

String

Server name

host_id

String

Server ID

agent_id

String

Agent ID

private_ip

String

Private IP address

public_ip

String

Elastic IP address

enterprise_project_id

String

Enterprise project ID

enterprise_project_name

String

Enterprise project name

host_status

String

Server status. Its value can be:

• ACTIVE

• SHUTOFF

• BUILDING

• ERROR

agent_status

String

Agent status. Its value can be:

• not_ installed

• online

• offline

• install_failed

• installing

install_result_code

String

Installation result. This API is available only for agents that are installed in batches. The options are as follows:

• install_succeed

• network_access_timeout: Connection timed out. Network error.

• invalid_port

• auth_failed: The authentication failed due to incorrect password.

• permission_denied: Insufficient permissions.

• no_available_vpc: There is no server with an online agent in the current VPC.

• install_exception

• invalid_param: Incorrect parameter.

• install_failed

• package_unavailable

• os_type_not_support: Incorrect OS type

• os_arch_not_support: Incorrect OS architecture

version

String

HSS edition. Its value can be:

• hss.version.null: none

• hss.version.enterprise: enterprise edition

• hss.version.premium: premium edition

• hss.version.wtp: WTP edition

• hss.version.container.enterprise: container edition

protect_status

String

Protection status. Its value can be:

• closed

• opened

os_image

String

System disk image

os_type

String

OS type. Its value can be:

• Linux

• Windows

os_bit

String

OS bit version

detect_result

String

Server scan result. Its value can be:

• undetected

• clean

• risk

• scanning

charging_mode

String

on_demand: pay-per-use

resource_id

String

Cloud service resource instance ID (UUID)

outside_host

Boolean

Whether a server is a Other server

group_id

String

Server group ID

group_name

String

Server group name

policy_group_id

String

Policy group ID

policy_group_name

String

Policy group name

asset

Integer

Asset risk

vulnerability

Integer

Total number of vulnerabilities, including Linux, Windows, Web-CMS, and application vulnerabilities.

baseline

Integer

Total number of baseline risks, including configuration risks and weak passwords.

intrusion

Integer

Total intrusion risks

asset_value

String

Asset importance. Its value can be:

• important

• common

• test

labels

Array of strings

Tag list

agent_create_time

Long

Agent installation time, which is a timestamp. The default unit is milliseconds.

agent_update_time

Long

Time when the agent status is changed. This is a timestamp. The default unit is milliseconds.

agent_version

String

Agent version

upgrade_status

String

Upgrade status. Its value can be:

• not_upgrade: Not upgraded. This is the default status. The customer has not delivered any upgrade command to the server.

• upgrading: The upgrade is in progress.

• upgrade_failed: The upgrade failed.

• upgrade_succeed

upgrade_result_code

String

Upgrade failure cause. This parameter is displayed only if upgrade_status is upgrade_failed. Its value can be:

• package_unavailable: The upgrade package fails to be parsed because the upgrade file is incorrect.

• network_access_timeout: Failed to download the upgrade package because the network is abnormal.

• agent_offline: The agent is offline.

• hostguard_abnormal: The agent process is abnormal.

• insufficient_disk_space

• failed_to_replace_file: Failed to replace the file.

upgradable

Boolean

Whether the agent of the server can be upgraded

200

cloud server list