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

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

enterprise_project_id

No

String

Enterprise project ID. The value 0 indicates the default enterprise project. To query all enterprise projects, set this parameter to all_granted_eps.

Default: 0

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

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

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, in ms.

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

Status Codes

Status Code

Description

200

auto launch list

Error Codes

See Error Codes.