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 Minimum: 1 Maximum: 256 |
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 |
app_name | No | String | Software name Minimum: 0 Maximum: 128 |
variation_type | No | String | Change type. Its value can be:
|
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: 0 Maximum: 256 |
sort_key | No | String | Sort key. Currently, sorting by recent_scan_time is supported. When data is sorted by recent_scan_time, the value of sort_dir determines whether to sort data in ascending or descending order. Minimum: 1 Maximum: 128 |
sort_dir | No | String | Sorting mode. The default value is descending. When sort_key is set to recent_scan_time, the current value determines whether to sort data in ascending or descending order. When sort_key is set to other values, the default value is descending.
|
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 |
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¶
Parameter | Mandatory | Type | Description |
|---|---|---|---|
X-Auth-Token | Yes | String | User token. Minimum: 32 Maximum: 4096 |
Response Parameters¶
Status code: 200
Parameter | Type | Description |
|---|---|---|
total_num | Integer | Number of software changes Minimum: 0 Maximum: 10000 |
data_list | Array of AppChangeResponseInfo objects | Account change history Array Length: 0 - 10000 |
Parameter | Type | Description |
|---|---|---|
agent_id | String | Agent ID Minimum: 0 Maximum: 128 |
variation_type | String | Type of change.
Minimum: 0 Maximum: 10 |
host_id | String | host_id Minimum: 1 Maximum: 128 |
app_name | String | Software name Minimum: 1 Maximum: 128 |
host_name | String | Host name Minimum: 1 Maximum: 128 |
host_ip | String | Server IP address Minimum: 1 Maximum: 256 |
version | String | Version number Minimum: 1 Maximum: 128 |
update_time | Long | Software update time, in milliseconds. Minimum: 0 Maximum: 4824430336000 |
recent_scan_time | Long | Last scan time, in ms. Minimum: 0 Maximum: 4824430336000 |
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" : "add",
"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.