Summary:
List the content filters in a config set, and add or update content filters.
URL:
http(s)://{server hostname}/api/cfg/serverGroupsConfig/{serverGroupId}/contentFilters
Methods summary
- GET Method - lists the content filters applied to a specified config set.
- POST Method - add or update content filters in a specified config set.
GET Method detail
Lists the content filters applied to a specified config set.
Response:
Name | Description |
---|---|
filterUUID |
unique filter identifier. |
name |
name of the filter. |
SRCTYPE |
object source type to which this filter refers, one of the following:
|
DEVTYPE |
device type to which this filter refers. |
PORTTYPE |
port type to which this filter refers. |
count |
number of content filters listed. |
Example:
INPUT
curl -u admin:admin https://localhost/api/cfg/serverGroupConfig/82e7c418-cd48-4fbf-857b-cddb475841a2/contentFilters
OUTPUT
{
"items" : [ {
"filterUUID" : "--AllObjectsDomain--",
"name" : "All Objects"
}, {
"filterUUID" : "--InfrastructureOnlyDomain--",
"name" : "Infrastructure Only",
"rules" : [ {
"SRCTYPE" : "4"
}, {
"SRCTYPE" : "1024"
}, {
"SRCTYPE" : "8"
}, {
"SRCTYPE" : "1",
"DEVTYPE" : "168"
}, {
"SRCTYPE" : "1",
"DEVTYPE" : "148",
"PORTTYPE" : "2"
}, {
"SRCTYPE" : "1",
"DEVTYPE" : "148",
"PORTTYPE" : "3"
} ]
}, {
"filterUUID" : "81797c36-49d1-41c5-8f4d-4fc82ef6b301",
"name" : "Test Content Filter"
}, {
"filterUUID" : "549fb464-7364-4569-b1d5-8d32929563ae",
"name" : "Test Content Filter1 - edit4"
}, {
"filterUUID" : "25cb3538-b918-43f6-adc9-d56b9cd3f20b",
"name" : "Test Content Filter2 - renamed properly"
}, {
"filterUUID" : "62772711-c215-452e-bda6-208f86ab6db4",
"name" : "Test Content Filter1 - edited"
}, {
"filterUUID" : "546d8f14-1c0b-4277-bc02-0b36ee0b9e2d",
"name" : "Test Content Filter1 - renamed"
}, {
"filterUUID" : "5ba8cb68-b201-40f7-a1ab-13b947eaa933",
"name" : "Test Content Filter1 - another edit"
}, {
"filterUUID" : "ca377171-9cde-4cd7-962e-5ab19632bc19",
"name" : "Test Content Filter1 - edit3"
} ],
"count" : 9
}
POST Method detail
Add or update content filters in a specified config set.
Request:
Name | Description |
---|---|
name |
name of the filter. |
rules |
the array of rules defining a filter. |
Response:
Name | Description |
---|---|
errorCode |
code for the change outcome, e.g. 'Success'. |
errorDetails |
details of an error, if applicable. |
configurationChangeId |
ID of the current configuration change, referred to in the table under the Sync History tab on the Multi-Server Configuration page. Each time a config set is updated, the set gains a new configuration change ID. This ID is an auto-incrementing number. |
serverGroupId |
ID of the config set. |
timestampSec |
timestamp of the change. |
modifiedBy |
user who made the change. |
Example:
INPUT
curl -u admin:admin https://localhost/api/cfg/serverGroupConfig/82e7c418-cd48-4fbf-857b-cddb475841a2/contentFilters -X POST -H "content-type:application/json" -d '
{
"name" : "Test Content Filter",
"rules" : [ ],
}'
OUTPUT
{
"errorCode" : "SUCCESS",
"errorDetails" : null,
"data" : {
"configurationChangeId" : 94,
"serverGroupId" : "82e7c418-cd48-4fbf-857b-cddb475841a2",
"timestampSec" : 1677586225,
"modifiedBy" : "admin"
}
}
Comments
0 comments
Please sign in to leave a comment.