Asset Fingerprint - Auto-started Item - Change History
Function
This API is used to check the change history of auto-started items in the asset fingerprints of a server.
URI
GET /v5/{project_id}/asset/auto-launch/change-history
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
host_id |
No |
String |
Server ID |
host_ip |
No |
String |
Server IP address |
host_name |
No |
String |
Server name |
auto_launch_name |
No |
String |
Auto-started item name |
type |
No |
Integer |
Auto-started item type.
|
variation_type |
No |
String |
Change type. Its value can be:
|
enterprise_project_id |
No |
String |
Enterprise project ID. To query all enterprise projects, set this parameter to all_granted_eps. |
sort_key |
No |
String |
Sort key. Currently, sorting by recent_scan_time is supported. |
sort_dir |
No |
String |
Whether to sort data in ascending or descending order. Default value: desc |
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. |
start_time |
No |
Long |
Start time of a change. Its value is a 13-digit timestamp. |
end_time |
No |
Long |
End time of a change. Its value is a 13-digit timestamp. |
Request 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
Parameter |
Type |
Description |
---|---|---|
total_num |
Integer |
Number of changes of auto-started items |
data_list |
Array of AutoLaunchChangeResponseInfo objects |
Account change history |
Parameter |
Type |
Description |
---|---|---|
agent_id |
String |
Agent ID |
variation_type |
String |
Type of change.
|
type |
Integer |
Auto-started item type
|
host_id |
String |
host_id |
host_name |
String |
ECS name |
host_ip |
String |
Server IP address |
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 |
name |
String |
Auto-started item name |
recent_scan_time |
Long |
Last update time. The value is a 13-bit timestamp. |
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" : "add", "type" : 0, "host_id" : "host_id", "host_name" : "host_name", "host_ip" : "host_ip", "path" : "/path", "hash" : "xxxxxxxx227bffa0c04425ba6c8e0024046caa38dfbca6281b40109axxxxxxxx", "run_user" : "SYSTEM", "name" : "S12hostguard", "recent_scan_time" : 1668246126302 } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
App change history info list |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.