Querying the Service List of Auto-Started Items

Function

This API is used to query the service list of auto-started items.

Calling Method

For details, see Calling APIs.

URI

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

**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
host_id	No	String	Server ID Minimum: 1 Maximum: 128
host_name	No	String	Server name Minimum: 1 Maximum: 128
name	No	String	Auto-started item name Minimum: 1 Maximum: 256
host_ip	No	String	Server IP address Minimum: 1 Maximum: 128
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 Minimum: 1 Maximum: 128
enterprise_project_id	No	String	Enterprise project ID. To query all enterprise projects, set this parameter to all_granted_eps. Minimum: 1 Maximum: 256
limit	No	Integer	Number of records on each page Minimum: 10 Maximum: 100 Default: 10
offset	No	Integer	Offset, which specifies the start position of the record to be returned. Minimum: 0 Maximum: 10000 Default: 0
part_match	No	Boolean	Whether fuzzy match is used. The default value is false.

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. Minimum: 32 Maximum: 4096

Response Parameters

Status code: 200

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

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

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
  } ]
}