Asset Fingerprint of a Server - Auto-Started Items

Function

This API is used to check auto-started items in the asset fingerprints of a server.

URI

GET /v5/{project_id}/asset/auto-launchs

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
host_id	No	String	Server ID
host_name	No	String	Server name
name	No	String	Auto-started item name
host_ip	No	String	Server IP address
type	No	String	Auto-started item type 0: auto-started service 1: scheduled task 2: Preload dynamic library 3: Run registry key 4: startup folder
enterprise_project_id	No	String	Enterprise project ID. To query all enterprise projects, set this parameter to all_granted_eps.
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.

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 token.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
total_num	Integer	Total number of auto-startup items
data_list	Array of AutoLauchResponseInfo objects	Auto-started item list

**Table 5** AutoLauchResponseInfo
Parameter	Type	Description
agent_id	String	Agent ID
host_id	String	Server ID
host_name	String	Server name
host_ip	String	Server IP address
name	String	Auto-started item name
type	Integer	Auto-started item type 0: auto-started service 1: scheduled task 2: Preload dynamic library 3: Run registry key 4: startup folder
path	String	Path of the auto-startup item
hash	String	Hash value of the file generated using the SHA256 algorithm
run_user	String	User who starts the execution
recent_scan_time	Long	Latest scan time

Example Requests

The first 10 services whose auto-startup item name is S50multi-queue are queried by default.

GET https://{endpoint}/v5/{project_id}/asset/auto-launchs?name=S50multi-queue

Example Responses

Status code: 200

auto launch list

{
  "total_num" : 1,
  "data_list" : [ {
    "agent_id" : "9e742932bff2894e3d0869d03989b05cefb27a6cbc201d98c4465296xxxxxxxx",
    "host_id" : "3d0581a5-03b9-4311-9149-c026b0726a7e",
    "host_name" : "name",
    "host_ip" : "3d0581a5-03b9-4311-9149-c026b0726a7e",
    "name" : "S12hostguard",
    "type" : 0,
    "path" : "/etc/hostguard",
    "hash" : "xxxxxxxx227bffa0c04425ba6c8e0024046caa38dfbca6281b40109axxxxxxxx",
    "run_user" : "user",
    "recent_scan_time" : 1668240858425
  } ]
}