Updated on 2025-09-24 GMT+08:00

Asset Fingerprints - Process - Server List

Function

Servers or containers having the process

Calling Method

For details, see Calling APIs.

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

host_name

No

String

Server name

host_ip

No

String

Server IP address

path

No

String

Process path

category

No

String

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

  • host

  • container

limit

No

Integer

Default value: 10

offset

No

Integer

Default value: 0

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

x-auth-token

Yes

String

iam 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

File hash

host_ip

String

Server IP address

host_name

String

Server name

launch_params

String

Startup parameter

launch_time

Long

Start time

process_path

String

Process path

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

Servers having the process

{
  "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

Servers having the process

Error Codes

See Error Codes.