Asset Fingerprint - Software Information - Change History
Function
This API is used to check the change history of software in the asset fingerprints of a server.
URI
GET /v5/{project_id}/asset/app/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 |
app_name |
No |
String |
Software name |
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 software changes |
data_list |
Array of AppChangeResponseInfo objects |
Account change history |
Parameter |
Type |
Description |
---|---|---|
agent_id |
String |
Agent ID |
variation_type |
String |
Type of change.
|
host_id |
String |
host_id |
app_name |
String |
Software name |
host_name |
String |
Host name |
host_ip |
String |
Server IP address |
version |
String |
Version number |
update_time |
Long |
Updated |
recent_scan_time |
Long |
Last scanned, in ms. |
Example Requests
The first 10 software change records whose start time is 1700446175490 and end time is 1701050975490 are queried by default.
GET https://{endpoint}/v5/{project_id}/asset/app/change-history?start_time=1700446175490&end_time=1701050975490
Example Responses
Status code: 200
App change history info list
{ "total_num" : 1, "data_list" : [ { "agent_id" : "d83c7be8a106485a558f97446617443b87604c8116e3cf0453c2a44exxxxxxxx", "variation_type" : "abnormal_behavior", "host_id" : "f4aaca51-xxxx-xxxx-xxxx-891c9e84d885", "app_name" : "hostguard", "host_name" : "host_name", "host_ip" : "host_ip", "version" : "3.2.3", "update_time" : 1668246126302, "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.