Help Center> Host Security Service (New)> API Reference> API Description> Asset Management> Obtaining the Historical Change Records of Auto-started Items
Updated on 2024-01-31 GMT+08:00

Obtaining the Historical Change Records of Auto-started Items

Function

This API is used to obtain the historical change records of auto-startup items.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/asset/auto-launch/change-history

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

User ID

Minimum: 1

Maximum: 256

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

host_id

No

String

Server ID

Minimum: 0

Maximum: 128

host_ip

No

String

Server IP address

Minimum: 0

Maximum: 128

host_name

No

String

Server name

Minimum: 0

Maximum: 128

auto_launch_name

No

String

Auto-started item name

Minimum: 0

Maximum: 128

type

No

Integer

Auto-started item type.

  • 0: auto-started service

  • 1: scheduled task

  • 2: Preload the dynamic library.

  • 3: Run registry key

  • 4: startup folder

Minimum: 0

Maximum: 100

variation_type

No

String

Change type. Its value can be:

  • add

  • delete

  • modify

Minimum: 0

Maximum: 10

enterprise_project_id

No

String

Enterprise project

Minimum: 0

Maximum: 256

sort_key

No

String

Sort key

Minimum: 0

Maximum: 128

sort_dir

No

String

Whether to sort data in ascending or descending order. Default value: asc

Minimum: 0

Maximum: 32

limit

No

Integer

Default value: 10

Minimum: 10

Maximum: 200

Default: 10

offset

No

Integer

Default value: 0

Minimum: 0

Maximum: 2000000

Default: 0

start_time

No

Long

Start time of a change. Its value is a 13-digit timestamp.

Minimum: 0

Maximum: 9007199254740992

end_time

No

Long

End time of a change. Its value is a 13-digit timestamp.

Minimum: 0

Maximum: 9007199254740992

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

x-auth-token

Yes

String

iam token

Minimum: 32

Maximum: 4096

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

total_num

Integer

Total number

Minimum: 0

Maximum: 10000

data_list

Array of AutoLaunchChangeResponseInfo objects

Account change history

Array Length: 0 - 10000

Table 5 AutoLaunchChangeResponseInfo

Parameter

Type

Description

agent_id

String

agent_id

Minimum: 0

Maximum: 128

variation_type

String

Type of change.

  • add

  • delete

  • modify

Minimum: 0

Maximum: 10

type

Integer

Auto-started item type

Minimum: 0

Maximum: 11

host_id

String

host_id

Minimum: 1

Maximum: 128

host_name

String

ECS name

Minimum: 1

Maximum: 256

host_ip

String

Server IP address

Minimum: 1

Maximum: 256

path

String

Path

Minimum: 1

Maximum: 256

hash

String

File hash

Minimum: 1

Maximum: 128

run_user

String

User who starts the execution

Minimum: 1

Maximum: 64

name

String

Auto-started item name

Minimum: 1

Maximum: 256

recent_scan_time

Long

Last update time

Minimum: 0

Maximum: 4824430336000

Example Requests

The first 10 auto-startup item change records whose start time is 1693101881568 and end time is 1701050681569 are queried by default.

GET https://{endpoint}/v5/{project_id}/asset/auto-launch/change-history?start_time=1693101881568&end_time=1701050681569

Example Responses

Status code: 200

App change history info list

{
  "total_num" : 1,
  "data_list" : [ {
    "agent_id" : "d83c7be8a106485a558f97446617443b87604c8116e3cf0453c2a44exxxxxxxx",
    "variation_type" : "abnormal_behavior",
    "type" : 0,
    "host_id" : "host_id",
    "host_name" : "host_name",
    "host_ip" : "host_ip",
    "path" : "/path",
    "hash" : "xxxxxxxx227bffa0c04425ba6c8e0024046caa38dfbca6281b40109axxxxxxxx",
    "run_user" : 1668246126302,
    "name" : 1668246126302,
    "recent_scan_time" : 1668246126302
  } ]
}

Status Codes

Status Code

Description

200

App change history info list

Error Codes

See Error Codes.