Help Center/ Host Security Service/ API Reference (Ally Region)/ API Description/ Asset Management/ Asset Fingerprints - Process - Server List
Updated on 2026-01-12 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Asset Fingerprints - Process - Server List

Function

Servers or containers having the process

URI

GET /v5/{project_id}/asset/processes/detail

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID
Table 2 Query Parameters

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_name

No

String

Server name

host_ip

No

String

Server IP address

path

No

String

Process executable file path

category

No

String

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

  • host

  • container

limit

No

Integer

Number of records on each page

offset

No

Integer

Offset, which specifies the start position of the record to be returned.

Request Parameters

Table 3 Request header 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 user token.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

total_num

Integer

Total number of server statistics

data_list

Array of ProcessesHostResponseInfo objects

Server statistics list
Table 5 ProcessesHostResponseInfo

Parameter

Type

Description

hash

String

The SHA256 value of the path.

host_ip

String

Server IP address

host_name

String

Server name

launch_params

String

Startup parameter

launch_time

Long

Start time

process_path

String

Path of the process execution file.

process_pid

Integer

PID of the process

run_permission

String

File permission

container_id

String

Container ID

container_name

String

Container name

Example Requests

The first 10 servers whose process path is /usr/bin/bash are queried by default.

GET https://{endpoint}/v5/{project_id}/asset/processes/detail?path=/usr/bin/bash

Example Responses

Status code: 200

Request succeeded.

{
  "total_num" : 1,
  "data_list" : [ {
    "hash" : "xxxxxx96a7ceb67731c0158xxxxxxff8456914d8275d221671d1190e888xxxxx",
    "host_ip" : "192.168.0.1",
    "host_name" : "ecs-euler-z00800211",
    "launch_params" : "",
    "launch_time" : 1673504622000,
    "process_path" : "/CloudResetPwdUpdateAgent/bin/wrapper",
    "process_pid" : 888,
    "run_permission" : "rwx------",
    "container_id" : "ce794b8a6071f5fd7e4d142dab7b36bedf2c7a4f6083fb82e5bbc82709b50018",
    "container_name" : "hss_imagescan_W73V1WO6"
  } ]
}

Status Codes

Status Code

Description

200

Request succeeded.

Error Codes

See Error Codes.

Parent topic: Asset Management