Help Center/ Host Security Service/ API Reference/ API Description/ Asset Management/ Collecting Asset Statistics, Including Accounts, Ports, and Processes
Updated on 2024-01-31 GMT+08:00

Collecting Asset Statistics, Including Accounts, Ports, and Processes

Function

This API is used to collect statistics on assets, such as accounts, ports, and processes.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/asset/statistics

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID

Minimum: 1

Maximum: 256

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

enterprise_project_id

No

String

Enterprise project

Minimum: 0

Maximum: 128

host_id

No

String

host id

Minimum: 1

Maximum: 128

category

No

String

Type. The default value is host. The options are as follows:

  • host

  • container

Minimum: 1

Maximum: 64

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

x-auth-token

Yes

String

iam token

Minimum: 32

Maximum: 4096

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

account_num

Long

Number of accounts

Minimum: 0

Maximum: 2147483647

port_num

Long

Number of open ports

Minimum: 0

Maximum: 2147483647

process_num

Long

Number of processes

Minimum: 0

Maximum: 2147483647

app_num

Long

Pieces of software

Minimum: 0

Maximum: 2147483647

auto_launch_num

Long

Number of auto-started items

Minimum: 0

Maximum: 2147483647

web_framework_num

Long

Number of web frameworks

Minimum: 0

Maximum: 2147483647

web_site_num

Long

Number of websites

Minimum: 0

Maximum: 2147483647

jar_package_num

Long

Number of JAR packages

Minimum: 0

Maximum: 2147483647

kernel_module_num

Long

Number of kernel modules

Minimum: 0

Maximum: 2147483647

web_service_num

Long

Number of web services

Minimum: 0

Maximum: 2147483647

web_app_num

Long

Number of web applications

Minimum: 0

Maximum: 2147483647

database_num

Long

Number of databases

Minimum: 0

Maximum: 2147483647

core_conf_file_num

Long

Number of key configuration files

Minimum: 0

Maximum: 2147483647

environment_num

Long

Number of environment variables

Minimum: 0

Maximum: 2147483647

Example Requests

This API is used to query the fingerprint information, accounts, ports, and processes of a server.

GET https://{endpoint}/v5/{project_id}/asset/statistics?category=host

Example Responses

Status code: 200

Asset statistic info

{
  "account_num" : 5,
  "port_num" : 5,
  "process_num" : 5,
  "app_num" : 5,
  "auto_launch_num" : 5,
  "web_framework_num" : 5,
  "web_site_num" : 5,
  "jar_package_num" : 5,
  "kernel_module_num" : 5,
  "core_conf_file_num" : 1,
  "database_num" : 1,
  "environment_num" : 0,
  "web_app_num" : 8,
  "web_service_num" : 2
}

Status Codes

Status Code

Description

200

Asset statistic info

Error Codes

See Error Codes.