Collecting Asset Statistics, Including Accounts, Ports, and Processes
Function
This API is used to collect statistics on assets, such as accounts, ports, and processes.
URI
GET /v5/{project_id}/asset/statistics
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| project_id | Yes | String | It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| enterprise_project_id | No | String | Enterprise project ID. To query all enterprise projects, set this parameter to all_granted_eps. |
| host_id | No | String | Host ID |
| category | No | String | Type. The default value is host. The options are as follows:
|
Request Parameters
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
Response Parameters
Status code: 200
| Parameter | Type | Description |
|---|---|---|
| account_num | Long | Number of server accounts |
| port_num | Long | Number of open ports |
| process_num | Long | Number of processes |
| app_num | Long | Pieces of software |
| auto_launch_num | Long | Number of auto-startup processes |
| web_framework_num | Long | Number of web frameworks |
| web_site_num | Long | Number of websites |
| jar_package_num | Long | Number of JAR packages |
| kernel_module_num | Long | Number of kernel modules |
| web_service_num | Long | Number of web services |
| web_app_num | Long | Number of web applications |
| database_num | Long | Number of databases |
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,
"database_num" : 1,
"web_app_num" : 8,
"web_service_num" : 2
} Status Codes
| Status Code | Description |
|---|---|
| 200 | Asset statistic info |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.
