Note: Before you use this API, make sure to create the URL Categories override file by copying the file /usr/share/fa/data/plugins/panorama/url_categories.json to this location: /home/afa/.fa/plugins/panorama/.
To do this:
-
Login as afa user.
(rw-r--r-- permissions are required for the url_categories.json file (644)). -
Run:
mkdir /home/afa/.fa/plugins/panorama/
-
Run:
cp /usr/share/fa/data/plugins/panorama/url_categories.json /home/afa/.fa/plugins/panorama/
-
Run:
chmod 644 /home/afa/.fa/plugins/panorama/url_categories.json
Delete URL categories from the URL Categories override file. Currently only Panorama devices are supported.
For further information about the URL Categories override file see (optional) Enhance URL Category accuracy.
Resource Name:
Request Method: DELETE
Request URL Parameters:|
Element |
Type |
Description |
|---|---|---|
| brand Mandatory |
string |
Brand name code. Only "panorama" is supported. |
Request Body Parameters:
|
Element |
Type |
Description |
|---|---|---|
| Body Mandatory |
List of strings |
A JSON list of category names to be deleted. Comma separated. for example: Copy
|
Response parameters
|
Element |
Type |
Description |
|---|---|---|
| categories | map of objects |
The JSON list of URL categories after the deletion, each populated by:
|
Response:
Status codes:
|
Code |
Description |
|---|---|
| 200 |
ActiveChange was triggered |
|
400 |
Input validation failure |
| 403 |
Authentication failure |
| 500 |
Failed to complete operation. |
Request cURL examples
curl -X DELETE "https://localhost/afa/api/v1/plugins/panorama/URLCategory/" -H "accept: */*" -H "Content-Type: application/json"
-d "[ \"category1\", \"category2\"]"
Response example for 200
{
"categories": {
"categories": {
"search-engines": {
"www.bing.com": [
"204.79.197.200",
"13.107.21.200"
],
"www.google.com": [
"172.217.19.132",
"172.217.18.100"
]
},
"sports": {
"urls": {
"www.nba.com": [
"104.106.236.138",
"92.122.144.117"
]
}
}
}
}
}
