Get all reports
Gets all reports for firewall tree name from specific date. If date is not specified all the reports for firewall will be retrieved.
Resource Name:
Request Method: GET
Request URL Parameters:
Element |
Type |
Description |
---|---|---|
deviceName Mandatory |
Integer |
The tree name of the device. Use the Devices Setup Resource Group GET /devices method to return the tree name |
fromDate optional |
String |
The date from which to show reports. format yyyy-mm-dd. |
Response parameters
Element |
Type |
Description |
---|---|---|
report_id | String | ID number of the report. |
status | String |
|
completed_on | String | The date when the report was completed. Only when status is completed. |
Response:
Status codes:
Code |
Description |
---|---|
200 |
Operation completed successfully |
400 |
Input validation failure |
403 | Authentication failure. ActiveChange APIs have the same user-permissions as the UI. If a user without permissions (like requestor) is trying to call one of these APIs, he will get code 403: status is failure, the messages field contains NO_PERMISSIONS code with relevant message. |
Request Curl example
curl -X GET "https://10.20.15.182/afa/api/v1/report/findAllReports?deviceName=AlgosecDevice" -H "accept: */*"
Response example for 200
[ { "report_id": "afa-402", "status": "COMPLETED", "completed_on": "Mar-17-2020 17:53" }, { "report_id": "afa-514", "status": "COMPLETED", "completed_on": "Sep-08-2020 12:16" }, { "report_id": "afa-648", "status": "COMPLETED", "completed_on": "Sep-12-2020 21:45" }, { "report_id": "afa-654", "status": "FAILED" }, { "report_id": "afa-655", "status": "FAILED" }, { "report_id": "afa-665", "status": "COMPLETED", "completed_on": "Sep-23-2020 13:01" }, { "report_id": "afa-666", "status": "COMPLETED", "completed_on": "Sep-23-2020 13:38" }, { "report_id": "afa-668", "status": "COMPLETED", "completed_on": "Sep-23-2020 14:21" }, { "report_id": "afa-684", "status": "COMPLETED", "completed_on": "Sep-29-2020 18:21" }, { "report_id": "afa-782", "status": "FAILED" }, { "report_id": "afa-821", "status": "FAILED" }, { "report_id": "afa-934", "status": "FAILED" }, { "report_id": "afa-1147", "status": "FAILED" }, { "report_id": "afa-1208", "status": "FAILED" } ]
Response example for 400
{ "status": "Failure", "messages": [{"code": "INVALID_REQUEST_TYPE",
"message": "Change request 638 does not match request type Traffic Change"
}],
"data": null
}