Querying the Status of Dynamic WTP for a Server
Function
This API is used to query the status of dynamic WTP for a server.
URI
GET /v5/{project_id}/webtamper/rasp/protect-history
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
enterprise_project_id |
No |
String |
Enterprise project ID |
host_id |
No |
String |
Host ID. If this parameter is left empty, all the servers are queried. |
start_time |
Yes |
Long |
Start time (ms) |
end_time |
Yes |
Long |
End time (ms) |
limit |
Yes |
Integer |
limit |
offset |
Yes |
Integer |
offset |
alarm_level |
No |
Integer |
Alarm severity. The options are as follows:
|
severity |
No |
String |
Threat level. Its value can be:
|
protect_status |
No |
String |
Protection status.
|
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. |
region |
Yes |
String |
Region Id |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
total_num |
Long |
total number of dynamic WTPs |
data_list |
Array of HostRaspProtectHistoryResponseInfo objects |
data list |
Example Requests
Query the dynamic WTP status of a server where target ID is caa958ad-a481-4d46-b51e-6861b8864515, start time is 1668563099000, and end time is 1668563199000.
GET https://{endpoint}/v5/{project_id}/webtamper/rasp/protect-history { "host_id" : "caa958ad-a481-4d46-b51e-6861b8864515", "start_time" : 1668563099000, "end_time" : 1668563199000, "limit" : 10, "offset" : 0 }
Example Responses
Status code: 200
successful response
{ "total_num" : 1, "data_list" : [ { "alarm_level" : 2, "alarm_time" : 1668394634000, "attacked_url" : "/vulns/001-dir-1.jsp", "source_ip" : "10.100.30.200", "threat_type" : "Path Traversal" } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
successful response |
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.