APSolute Vision 3.40 REST API

Sends a file to the DefenseFlow device.

Query parameter:
"type" - the file type. The supported type is "Configuration".
Body parameter: The file content as octal stream.
The following is an example of a request sending a file to the DefenseFlow device:

Path: https://Vision IP/mgmt/device/df/config/sendtodevice?type=Configuration
The request body is in the following format:

Content-Disposition: form-data; name="Filedata"; filename="dfconfig.txt"
Content-Type: application/octet-stream

Downloads a file from a DefenseFlow device to the local OS, or to APSolute Vision server.

Query parameters:
"saveToDb" - Possible values are "true" or "false". The default is "false".
"type" - The file type. The supported type is "Configuration".

Updates the variable values on the DefenseFlow device.
Error conditions:

If the wrong variable values are specified in the JSON body; the APSolute Vision server returns the error from a device.

The following is an example of a request updating the variable value for the license on the device:

Path: https://Vision IP/mgmt/device/df/config
The request JSON is in the following format:
{
"license": "adc-123-bwm"}

Updates a row of a DefenseFlow device table.
Use cases:

If the wrong column data are specified in the JSON body, the APSolute Vision server returns a device error message.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request adding a row with index "Test", specified in the path parameter, to the "Security Templates" table:

Path: https://Vision IP/mgmt/device/df/config/SecurityTemplates/Test/,
The request JSON is in the following format:
{
"name": "Test"
"description": "Test Only"
"origin": "PROTECTED_OBJECT"
"policyPO": "PF001"
},

The following is an example of a request adding a row with the index "Test Strategy", specified in the path parameters, to the "Operation Strategies" table:

Path: https://Vision IP/mgmt/device/df/config/OperationStrategies/Test%20Strategy/,

The request JSON is in the following format:
{"ceCollector": "None"
"ceDetector": "None"
"collection-group": "None"
"description": "Test Strategy"
"detector-type": "3rdPartyDetector"
"diversion-group": "Tier1"
"dp-group": "All"
"dp-select": "Select all"
"name": "Test Strategy"
"route-reflectors": "Disabled"
}

The following is an example of a request adding a row with the index "ProtectedObjectTest", specified in the path parameters, to the "Protected Object" table:

Path: https://Vision IP/mgmt/device/df/config/ProtectedObjects/ProtectedObjectTest/,

The request JSON is in the following format:
{"status": "Enabled"
"name": "ProtectedObjectTest"
"divert": "Enabled"
"mitigate": "Enabled"
"inject": "Enabled"
"mode": "Automatic"
"template": "Test"
"peak": "22222"
"strategy": "PF2"
"network": [
{"network": "1.1.1.1"
"vlan": "Basic"
"ne": "Tier1"
"prefix": "32"
"rsNewWhiteListSynModuleTwo": "1"}
]
}

Retrieves a row from the DefenseFlow device table according to the provided index.
The query parameter:
"props" is an optional parameter specifying a list of column names, separated by commas.

Use cases:

If the "props" query parameter is not provided, all columns of the row are returned.
When a table does not contain the row with the specified index, an empty JSON is returned.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request retrieving the row by index "Test Stragegy" from the "Operation Strategies" table:

Path: https://Vision IP/mgmt/device/df/config/OperationStrategies/Test%20Stragegy?props=name,description,detector-type,ceDetector,
ceCollector,collection-group,route-reflectors,diversion-group,dp-group,dp-select

The following is an example of a request retrieving the row by index "ProtectedObjectTest" from the "Protected Objects" table:

Path: https://Vision IP/mgmt/device/df/config/ProtectedObjects/ProtectedObjectTest?props=status,name,description,action,divert,
mitigate,inject,mode,network,template,policyName,policy,peak,strategy,useManual,tcpTHActiveKbps,tcpTHActivePps,tcpTHTermKbps,
tcpTHTermPps,udpTHActiveKbps,udpTHActivePps,udpTHTermKbps,udpTHTermPps,icmpTHActiveKbps,icmpTHActivePps,icmpTHTermKbps,icmpTHTermPps,
otherTHActiveKbps,otherTHActivePps,otherTHTermKbps,otherTHTermPps,totalTHActiveKbps,totalTHActivePps,totalTHTermKbps,totalTHTermPps

Adds a row to a DefenseFlow device table.
Use cases:

If the wrong columns data is specified in the JSON body, the APSolute Vision server returns a device error message.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request adding a row with index "Test" (specified in the path parameter) to the "Security Templates" table:

Path: https://Vision IP/mgmt/device/df/config/SecurityTemplates/Test/,
The request JSON is in the following format:
{
"name": "Test"
"description": "Test Only"
"origin": "PROTECTED_OBJECT"
"policyPO": "PF001"
}

The following is an example of a request adding a row with the index "Test Strategy", specified in the path parameters, to the "Operation Strategies" table:

Path: https://Vision IP/mgmt/device/df/config/OperationStrategies/Test%20Strategy/,

The request JSON is in the following format:
{"ceCollector": "None"
"ceDetector": "None"
"collection-group": "None"
"description": "Test Strategy"
"detector-type": "3rdPartyDetector"
"diversion-group": "Tier1"
"dp-group": "All"
"dp-select": "Select all"
"name": "Test Strategy"
"route-reflectors": "Disabled"
}

The following is an example of a request adding a row with the index "ProtectedObjectTest", specified in the path parameters, to the "Protected Object" table:

Path: https://Vision IP/mgmt/device/df/config/ProtectedObjects/ProtectedObjectTest/,

The request JSON is in the following format:
{"status": "Enabled"
"name": "ProtectedObjectTest"
"divert": "Enabled"
"mitigate": "Enabled"
"inject": "Enabled"
"mode": "Automatic"
"template": "Test"
"peak": "22222"
"strategy": "PF2"
"network": [
{"network": "1.1.1.1"
"vlan": "Basic"
"ne": "Tier1"
"prefix": "32"
"rsNewWhiteListSynModuleTwo": "1"}
]
}

Deletes a row from the DefenseFlow device table according to the provided index.
Error conditions:

If the table does not contain the row with the specified index, an empty JSON is returned.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request deleting the row by index "Test Stragegy" from the "Operation Strategies" table:

Path: https://Vision IP/mgmt/device/df/config/OperationStrategies/Test%20Stragegy/

The following is an example of a request retrieving the row by index "ProtectedObjectTest" from the "Protected Objects" table:

Path: https://Vision IP/mgmt/device/df/config/ProtectedObjects/ProtectedObjectTest/

Retrieves the table content from a DefenseFlow device.
Query parameters:
"offset" - The index in the table from which to start retrieving. When this optional parameter is not specified, the table is retrieved starting from the first row.
"count" - Optional parameter specifying the maximum number of rows to retrieve.
"props" - Optional parameter specifying a list of columns to retrieve, separated by commas.

Use cases:

If no query parameters are provided, the whole table is returned. The maximum number of retrieved rows is according to limitations of the REST protocol.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.
When a table does not contain any rows, an empty JSON is returned.

The following is an example of a request retrieving the first 50 rows of the "Protected Objects" table:

Path: https://Vision IP/mgmt/device/df/config/ProtectedObjects?props=status,name,description,action,template,policyName,peak,strategy

The following is an example of a request retrieving the first 50 rows of the "Operation Strategies" table:

Path: https://Vision IP/gmt/device/df/config/OperationStrategies?props=name,description,detector-type,
"+collection-group,route-reflectors,diversion-group,dp-group

Deletes the Network Protection policy configuration from the DefensePro device.
Error case:

If the network protection was added but the Update Policies operation was not performed on the DefensePro device, the APSolute Vision server returns a device error message:

Configuration template delete failed due to validation error. Delete of server failed. The name of the sever is invalid.

The following is an example of a request deleting the Network Protection configuration template from a DefensePro device:

Path: https://Vision IP/mgmt/device/byip/10.205.193.120/config/deletenetworktemplate?PolicyName=test3&UpdatePolices=on

Retrieves the device configuration file to the client computer or to the APSolute Vision server.

Query parameters:
saveToDb - Possible values are "true" or "false". The default is "false".
includePrivateKeys - Possible values are "true" or "false". The default is "false".
passphrase - The password for the private keys encryption. Relevant for "includePrivateKeys" value "true" only.

Error case:

If the Network Protection policy was created but the Update Policies operation was not yet performed on the DefensePro device, an error message is returned:

Configuration template import failed due to validation error. Import of network failed. The name of the network is invalid.

The following is an example of a request to export a network protection configuration template from the DefensePro device to the APSolute Vision database:

Path: https://Vision IP/mgmt/device/byip/Device IP/config/getnetworktemplate?PolicyName=guy&ExportConfiguration=on&ExportBaselineDNS=on&ExportBaselineBDoS=on&saveToDb=true&fileName=172.16.22.20_guy_2015.11.17_16.48.53

Query parameterse:

PolicyName - The name of the Network Protection policy.
ExportConfiguration - Flag to indicate whether to export the configuration. Possible values: on / off.
ExportBaselineDNS - Flag to indicate whether to export the DNS baseline. Possible values: on / off.
ExportBaselineBDoS - Flag to indicate whether to export the BDoS baseline. Possible values: on / off.
saveToDb - Flag to indicate whether to save the template to the APSolute Vision database, or to the local OS. Possible values: true / false. Use "true" to store the file in the APSolute Vision database. Use "false" to store it on the local OS.
fileName - The name of the file to be stored in APSolute Vision database. Additionally this name can be used for importing or deleting the configuration template from the device.

Retrieves the table content from the device.
Query parameters:
"offset" - The index in the table to start retrieving from. When this optional parameter is not specified, the table from the beginning is returned.
"count" - Optional parameter specifying a maximum number of rows to retrieve.
"props" - Optional parameter specifying a list of columns, separated by commas.

Use cases:

If query parameters are not provided, the whole table is returned (with device limitations for the maximum rows that can be returned in REST)
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.
When a table does not contain rows, the empty JSON is returned.

The following is an example of a request retrieving the first 50 rows from the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSNewRulesTable?offset=SGNS-Global-2&count=50&props=rsIDSNewRulesName,rsIDSNewRulesState,rsIDSNewRulesSource,rsIDSNewRulesDestination,rsIDSNewRulesPortmask,
rsIDSNewRulesDirection,Vlan_MPLSRD_TagGroup,rsIDSNewRulesVlanTagGroup,rsIDSNewRulesMPLSRDGroup,Profiles,
rsIDSNewRulesProfileNetflood,rsIDSNewRulesProfileDNS,rsIDSNewRulesProfileScanning,rsIDSNewRulesProfileStateful,
rsIDSNewRulesProfileAppsec,rsIDSNewRulesProfileConlmt,rsIDSNewRulesProfileSynprotection,rsIDSNewRulesProfilePPS,
rsIDSQuarantineStatusInPolicy,rsIDSNewRulesAction,rsIDSNewRulesPacketReportingStatus,rsIDSNewRulesPacketReportingEnforcement,
rsIDSNewRulesPacketTraceStatus,rsIDSNewRulesPacketTraceEnforcement,

The following is an example of a request retrieving the first 50 rows from the "Server Protection Policies" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSServerTable?count=50&props=rsIDSServerName,rsIDSServerIPRange,
rsIDSServerState,rsIDSServerHTTPProfile,rsIDSServerIPSProfile,rsIDSServerVlanTagGroup,rsIDSServerPacketReportStatus,
rsIDSServerPacketReportEnforcement,rsIDSServerPacketTraceStatus,rsIDSServerPacketTraceEnforcement

Deletes the Server Protection Configuration Template from the DefensePro device.
Use cases:

If the policy was added but the Update Policies operation was not performed on the DefensePro device. The APSolute Vision server returns the error from a device:

Configuration template delete failed due to validation error. Delete of server failed. The name of the sever is invalid.

The following is an example of a request deleting the Server Protection configuration template from the DefensePro device:

Path: https://Vision IP/mgmt/device/byip/10.205.193.120/config/deleteservertemplate?ServerName=DiTest&UpdatePolicies=on

Error case:

The following is an example of a request to export a server protection configuration template from the DefensePro device to the APSolute Vision database:

https://Vision IP/mgmt/device/byip/Device IP/config/getservertemplate?ServerName=DC_FTP_Servers&ExportConfiguration=on&ExportBaselineHttp=on&saveToDb=true&fileName=172.16.22.21_DC_FTP_Servers_2015.11.17_17.23.55

Query parameters:

ServerName – The name of the Server Protection policy.
ExportConfiguration - Flag to indicate whether to export the configuration. Possible values: on / off.
ExportBaselineHttp - Flag to indicate whether to export the HTTP baseline. Possible values: on / off.
saveToDb - Flag to indicate whether to save the template to the APSolute Vision database, or to the local OS. Possible values: true / false. Use "true" to store the file in the APSolute Vision database. use "false" to store it on the local OS.
fileName - The name of the file to be stored in APSolute Vision database. Additionally this name can be used for importing or deleting the configuration template from the device.

Updates a scalar value on the device.
Error cases:

If the wrong scalar value is specified in the JSON body, the APSolute Vision server returns the device error message.

The following is an example of a request updating the scalar values for the Time Settings of a DefensePro device:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config,
The request JSON is in the following format:
{
"rsWSDNTPPort": "123"
"rsWSDNTPServerUrl": "132.45.15.12"
},

The following is an example of a request updating the scalar values for the Alteon Management Traffic Routing:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config,
The request JSON is in the following format:
{
{"agMgmtNewCfgCdp": "2"
"agMgmtNewCfgDns": "2"
"agMgmtNewCfgOcsp": "2"
"agMgmtNewCfgReport": "2"
}

The following is an example of a request updating the scalar values of Alteon for the APM Server:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config,
The request JSON is in the following format:
{
{"agNewCfgAPMServerDataIpAddr": "172.16.55.21"
"agNewCfgAPMServerDataPort": "443"
"agNewCfgAPMServerId": "123"
"agNewCfgAPMServerMgmtIpAddr": "185.18.2.2"
}

Updates a row in a device table.
Use cases:

If inconsistent column data is specified in the JSON body, the HTTP 500 error code is returned with the error forwarded from a device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request updating the row with index "Test", specified in the path parameter, in the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{
"rsIDSNewRulesActionTwo": "1"
"rsIDSNewRulesDestination": "SG4"
"rsIDSNewRulesDirection": "1"
"rsIDSNewRulesInstanceIdTwo": "1"
"rsIDSNewRulesName": "Test"
"rsIDSNewRulesPacketReportingEnforcementTwo": "1"
"rsIDSNewRulesPacketTraceEnforcementTwo": "1"
"rsIDSNewRulesPacketTraceStatusTwo": "1"
"rsIDSNewRulesPortmask": ""
"rsIDSNewRulesPriorityTwo": "1"
"rsIDSNewRulesProfileAppsecThree": ""
"rsIDSNewRulesProfileConlmtThree": ""
"rsIDSNewRulesProfileDNSThree": ""
"rsIDSNewRulesProfileNetfloodThree": ""
"rsIDSNewRulesProfileSynprotectionThree": ""
"rsIDSNewRulesSource": "SG2"
"rsIDSNewRulesStateTwo": "1"
"rsIDSNewRulesVlanTagGroup": ""
}

The following is an example of a request updating the row with the indexes "SG2/1", specified in path parameters, in the "Network" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsBWMNetworkTable/SG2/1/,

The request JSON is in the following format:
{
"rsBWMNetworkName": "SG2"
"rsBWMNetworkSubIndex": "1"
"rsBWMNetworkToIP": "66.152.0.0"
}

The following is an example of a request updating the row with the index "BDOS_Critical", specified in the path parameter, in the "BDoS Profiles" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsNetFloodProfileTable/BDOS_Critical/,

The request JSON is in the following format:
{
"rsNetFloodProfileBandwidthIn": "343434"
"rsNetFloodProfileBandwidthOut": "343434"
"rsNetFloodProfileIcmpInQuota": "1"
"rsNetFloodProfileIcmpOutQuota": "1"
"rsNetFloodProfileIcmpStatus": "1"
"rsNetFloodProfileIgmpInQuota": "1"
"rsNetFloodProfileIgmpOutQuota": "1"
"rsNetFloodProfileIgmpStatus": "1"
"rsNetFloodProfileLevelOfReuglarzation": "1"
"rsNetFloodProfileName": "1"
"rsNetFloodProfilePacketReportStatus": "1"
"rsNetFloodProfilePacketTraceStatus": "1"
"rsNetFloodProfileTcpFinAckStatus": "1"
"rsNetFloodProfileTcpFragStatus": "2"
"rsNetFloodProfileTcpInQuota": "75"
"rsNetFloodProfileTcpOutQuota": "75"
"rsNetFloodProfileTcpRstStatus": "1"
"rsNetFloodProfileTcpSynAckStatus": "1"
"rsNetFloodProfileTcpSynStatus": "1"
"rsNetFloodProfileTransparentOptimization": "1"
"rsNetFloodProfileUdpFragStatus": "2"
"rsNetFloodProfileUdpInQuota": "50"
"rsNetFloodProfileUdpOutQuota": "50"
"rsNetFloodProfileUdpStatus": "2"
}

The following is an example of a request updating the row with the index "450000", specified in the path parameters, in the "Connection Limit Protections" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSConnectionLimitAttackTable/450000/,

The request JSON is in the following format:
{
"rsIDSConnectionLimitAttackId": "450000"
"rsIDSConnectionLimitAttackProtocol": "3"
"rsIDSConnectionLimitAttackReportMode": "0"
"rsIDSConnectionLimitAttackRisk": "2"
"rsIDSConnectionLimitAttackTrackingType": "4"
}

The following is an example of a request updating the row with the index "200009", specified in the path parameters, in the "SYN Protections" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSSYNAttackTable/200009/,

The request JSON is in the following format:
{
"rsIDSSYNAttackActivationThreshold": "2501"
"rsIDSSYNAttackId": "200009"
"rsIDSSYNAttackRisk": "4"
"rsIDSSYNAttackTerminationThreshold": "1501"
}

Retrieves a row from the device table according to index.
Query parameter:
"props" - Optional parameter specifying a list of column names, separated by commas.

Use cases:

If the "props" query parameter is not provided, all columns of the row are returned.
When a table does not contain the row with the specified index, the empty JSON is returned.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request retrieving the row by index "sgns-dns-auth" from the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSNewRulesTable/sgns-dns-auth?props=rsIDSNewRulesName,rsIDSNewRulesState,
rsIDSNewRulesSource,rsIDSNewRulesDestination,rsIDSNewRulesPortmask,rsIDSNewRulesDirection,Vlan_MPLSRD_TagGroup,
rsIDSNewRulesVlanTagGroup,rsIDSNewRulesMPLSRDGroup,Profiles,rsIDSNewRulesProfileNetflood,rsIDSNewRulesProfileDNS,
rsIDSNewRulesProfileScanning,rsIDSNewRulesProfileStateful,rsIDSNewRulesProfileAppsec,rsIDSNewRulesProfileConlmt,
rsIDSNewRulesProfileSynprotection,rsIDSNewRulesProfilePPS,rsIDSQuarantineStatusInPolicy,rsIDSNewRulesAction,
rsIDSNewRulesPacketReportingStatus,rsIDSNewRulesPacketReportingEnforcement,rsIDSNewRulesPacketTraceStatus,
rsIDSNewRulesPacketTraceEnforcement

The following is an example of a request retrieving the row by index "sadasdasdasdasd" from the "Server Protection Policies" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSNewRulesTable/sadasdasdasdasd?props=rsIDSNewRulesName,
rsIDSNewRulesStateTwo,rsIDSNewRulesInstanceIdTwo,rsIDSNewRulesPriorityTwo,rsIDSNewRulesSource,rsIDSNewRulesDestination,
rsIDSNewRulesPortmask,rsIDSNewRulesDirection,Vlan_MPLSRD_TagGroup,rsIDSNewRulesVlanTagGroup,rsIDSNewRulesMPLSRDGroup,
Profiles,rsIDSNewRulesProfileNetfloodThree,rsIDSNewRulesProfileDNSThree,rsIDSNewRulesProfileScanningThree,
rsIDSNewRulesProfileStatefulThree,rsIDSNewRulesProfileAppsecThree,rsIDSNewRulesProfileConlmtThree,
rsIDSNewRulesProfileSynprotectionThree,rsIDSNewRulesProfilePPSThree,rsIDSNewRulesActionTwo,
rsIDSNewRulesPacketReportingStatusTwo,rsIDSNewRulesPacketReportingEnforcementTwo,rsIDSNewRulesPacketTraceStatusTwo,
rsIDSNewRulesPacketTraceEnforcementTwo

The following is an example of a request retrieving the row by index "SG2" from the "Networks" table:

Path https://Vision IP/mgmt/device/byip/{Device IP}/config/rsBWMNetworkTable/SG2?props=rsBWMNetworkName,rsBWMNetworkSubIndex,rsBWMNetworkMode,
rsBWMNetworkAddress,rsBWMNetworkFromIP,rsBWMNetworkMask,rsBWMNetworkToIP&count=50

The following is an example of a request retrieving the row by indexes "Management/MNG-1" from the "Physical Ports" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsBWMPhysicalPortGroupTable/Management/MNG-1?props=rsBWMPhysicalPortGroupName,
rsBWMPhysicalPortGroupPort

Adds a row to a device table.
Use cases:

If inconsistent column data is specified in the JSON body, the APSolute Vision server returns the error from a device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request adding a row with index "Test", specified in the path parameter, to the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{
"rsIDSNewRulesActionTwo": "1"
"rsIDSNewRulesDestination": "SG4"
"rsIDSNewRulesDirection": "1"
"rsIDSNewRulesInstanceIdTwo": "1"
"rsIDSNewRulesName": "Test"
"rsIDSNewRulesPacketReportingEnforcementTwo": "1"
"rsIDSNewRulesPacketTraceEnforcementTwo": "1"
"rsIDSNewRulesPacketTraceStatusTwo": "1"
"rsIDSNewRulesPortmask": ""
"rsIDSNewRulesPriorityTwo": "1"
"rsIDSNewRulesProfileAppsecThree": ""
"rsIDSNewRulesProfileConlmtThree": ""
"rsIDSNewRulesProfileDNSThree": ""
"rsIDSNewRulesProfileNetfloodThree": ""
"rsIDSNewRulesProfileSynprotectionThree": ""
"rsIDSNewRulesSource": "SG2"
"rsIDSNewRulesStateTwo": "1"
"rsIDSNewRulesVlanTagGroup": ""
},

The following is an example of a request adding a row with the index "Test", specified in the path parameters, to the "Signature Profile" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSSignaturesProfilesTable/Test/1/Risk/High/,

The request JSON is in the following format:
{"rsIDSSignaturesProfileName": "Test"
"rsIDSSignaturesProfileRuleAttributeName": "High"
"rsIDSSignaturesProfileRuleAttributeType": "Risk"
"rsIDSSignaturesProfileRuleName": "1"
}

The following is an example of a request adding a row with the index "Entry1", specified in the path parameters, to the "White List" table:

Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsNewWhiteListTable/Entry1/,

The request JSON is in the following format:
{"rsNewWhiteListAction": "Test"
"rsNewWhiteListAllModules": "1"
"rsNewWhiteListDescriptionTwo": "Attach White List Entry"
"rsNewWhiteListDirection": "1"
"rsNewWhiteListDstNetwork": "SG4"
"rsNewWhiteListDstPortGroup": "rtsp"
"rsNewWhiteListHttpFloodModuleTwo": "1"
"rsNewWhiteListName": "Entry1"
"rsNewWhiteListProtocol": "0"
"rsNewWhiteListServerCrackingModuleTwo": "1"
"rsNewWhiteListSignatureModuleTwo": "1"
"rsNewWhiteListSrcNetwork": "SG2"
"rsNewWhiteListSrcPortGroup": "msn"
"rsNewWhiteListState": "1"
"rsNewWhiteListSynModuleTwo": "1"

Deletes a row from a device table. The request body is empty.

Use cases:

If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request deleting the row with index "Test" (specified in the path parameter) from the "Network Protection Policies" table:
Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSNewRulesTable/Test/

The following is an example of a request deleting the row with the index "SG2/1", specified in the path parameters from the "Network" table:
Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsBWMNetworkTable/SG2/1/

The following is an example of a request deleting the row with the index "BDOS_Critical" specified in the path parameter from the "BDoS Profiles" table:
Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsNetFloodProfileTable/BDOS_Critical/

The following is an example of a request deleting the row with the index "450000", specified in the path parameters from the "Connection Limit Protections" table:
Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSConnectionLimitAttackTable/450000/

The following is an example of a request deleting the row with the index "BlackListEntry1", specified in the path parameters from the "Black List" table:
Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsNewBlackListTable/BlackListEntry1/

The following is an example of a request deleting the row with the index "200009", specified in path parameters, from the "SYN Protections" table:
Path: https://Vision IP/mgmt/device/byip/{Device IP}/config/rsIDSSYNAttackTable/200009/,

Updates single variable (scalar) values on the leading device and on all specified devices.
Error condition regarding the leading device:

If the wrong variable values are specified in the JSON body, the APSolute Vision server returns device error message.

Error condition regarding the remaining devices:

If the wrong variable values are specified in the JSON body, the device error message will appear in the summarizing message on the client and in the summarizing alert.

The following is an example of a request to update variable (scalar) values on the leading device and on all specified devices:

Path: https://Vision IP/mgmt/v2/devices/config/{category},
The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.162.7",
"deviceIpAddresses":["172.16.162.1","172.16.162.2","172.16.162.4"],
"requestData": {"agMgmtNewCfgRadius": "1",
"agMgmtNewCfgTacacs": "2",
"agMgmtNewCfgSyslog": "2",
"agMgmtNewCfgSnmp": "2",
"agMgmtNewCfgTftp": "2",
"agMgmtNewCfgReport": "2"
}
}

Uploads the DNS Key text to the specified devices.

Query parameters are:
"id" - The DNS Key unique identifier.
"type" of file; The value should be "zone" for DNS Key.
"passphrase" - The password for the DNS keys encryption.
The rest are application specific parameters.

The following is an example of a request uploading a key with index "NewTextDNS" (specified in the query parameter) to the specified devices:

Path: https://Vision IP/mgmt/device/multi/config/dnskeyimport?id=NewTextDNS&type=zone&state=1&passphrase=radware&keysz=1024&hash=1&ttl=86400&exp=2419200&rollover=604800&sigval=604800&sigPUB=302400,
The request body is in the following format:
{
"requestData":"LS0tLS1CRUdJTiBSU0EgUFJJV…​.",
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

Uploads the file to the specified devices.

The query parameters are application specific.
The body parameters are the file content as an octal stream, and the leading device and device list information, as JSON string inside the form data.
The following is an example of a request uploading a tunnel with index "NewDNS" (specified in the query parameter) to the group of devices:

Path: https://Vision IP/mgmt/device/multi/config/sendtodevice?operationType=ImportTunnel&listeningAddress=10.206.158.114&listeningPort=80&fwAddress=10.206.158.114&protectedEntity=256,
The request body is in the following format:
{
Content-Disposition: form-data; name="Filedata"; filename="dbVul.kvs"
Content-Type: application/octet-stream
Content-Disposition: form-data; name="requestStringData"
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

Retrieves the table content from the device.
Query parameters:
offset - The index in the table to start retrieving from. When this optional parameter is not specified, the table from the beginning is returned.
count - Optional parameter specifying a maximum number of rows to retrieve.
props - Optional parameter specifying a list of columns, separated by commas.

Use cases:

If query parameters are not provided, the whole table is returned (with device limitations for the maximum rows that can be returned in REST)
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.
When a table does not contain rows, the empty JSON is returned.

The following is an example of a request retrieving the first 50 rows from the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSNewRulesTable?offset=SGNS-Global-2&count=50&props=rsIDSNewRulesName,rsIDSNewRulesState,rsIDSNewRulesSource,rsIDSNewRulesDestination,rsIDSNewRulesPortmask,
rsIDSNewRulesDirection,Vlan_MPLSRD_TagGroup,rsIDSNewRulesVlanTagGroup,rsIDSNewRulesMPLSRDGroup,Profiles,
rsIDSNewRulesProfileNetflood,rsIDSNewRulesProfileDNS,rsIDSNewRulesProfileScanning,rsIDSNewRulesProfileStateful,
rsIDSNewRulesProfileAppsec,rsIDSNewRulesProfileConlmt,rsIDSNewRulesProfileSynprotection,rsIDSNewRulesProfilePPS,
rsIDSQuarantineStatusInPolicy,rsIDSNewRulesAction,rsIDSNewRulesPacketReportingStatus,rsIDSNewRulesPacketReportingEnforcement,
rsIDSNewRulesPacketTraceStatus,rsIDSNewRulesPacketTraceEnforcement,

The following is an example of a request retrieving the first 50 rows from the "Server Protection Policies" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSServerTable?count=50&props=rsIDSServerName,rsIDSServerIPRange,
rsIDSServerState,rsIDSServerHTTPProfile,rsIDSServerIPSProfile,rsIDSServerVlanTagGroup,rsIDSServerPacketReportStatus,
rsIDSServerPacketReportEnforcement,rsIDSServerPacketTraceStatus,rsIDSServerPacketTraceEnforcement

Updates a row in the device table on the leading device and on all specified devices.
Error cases:

If wrong column data is specified in the JSON body, the APSolute Vision server returns the error from a leading device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request updating a row with index "Test" (specified in the path parameter) to the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/v2/devices/config/aw/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsIDSNewRulesStateTwo": "1",
"rsIDSNewRulesName": "Test"
"rsIDSNewRulesInstanceIdTwo": "0"
"rsIDSNewRulesPortmask": ""
"rsIDSNewRulesInstanceIdTwo": "1"
"rsIDSNewRulesDirection": "1"
"rsIDSNewRulesVlanTagGroup": ""
"rsIDSNewRulesMPLSRDGroup": ""
"rsIDSNewRulesProfileNetfloodThree": ""
"rsIDSNewRulesProfileDNSThree": ""
"rsIDSNewRulesProfileAppsecThree": ""
"rsIDSNewRulesProfileConlmt": ""
"rsIDSNewRulesProfileSynprotectionThree": ""
"rsIDSNewRulesActionTwo": "1"
}}

The following is an example of a request updating a row with the index "Test", specified in the path parameters, to the "Signature Profile" table:

Path: https://Vision IP/mgmt/v2/devices/config/aw/rsIDSSignaturesProfilesTable/Test/1/Risk/High/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsIDSSignaturesProfileName": "Test1"
"rsIDSSignaturesProfileRuleAttributeName": "High"
"rsIDSSignaturesProfileRuleAttributeType": "Risk"
"rsIDSSignaturesProfileRuleName": "1"
}
}

The following is an example of a request updating a row with the index "Entry1", specified in the path parameters, to the "White List" table:

Path: https://Vision IP/mgmt/v2/devices/config/aw/rsNewWhiteListTable/Entry1/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsNewWhiteListAction": "Test"
"rsNewWhiteListAllModules": "1"
"rsNewWhiteListDescriptionTwo": "Attach White List Entry"
"rsNewWhiteListDirection": "1"
"rsNewWhiteListDstNetwork": "SG4"
"rsNewWhiteListDstPortGroup": "rtsp"
"rsNewWhiteListHttpFloodModuleTwo": "1"
"rsNewWhiteListName": "Entry1"
"rsNewWhiteListProtocol": "0"
"rsNewWhiteListServerCrackingModuleTwo": "1"
"rsNewWhiteListSignatureModuleTwo": "1"
"rsNewWhiteListSrcNetwork": "SG2"
"rsNewWhiteListSrcPortGroup": "msn"
"rsNewWhiteListState": "1"
"rsNewWhiteListSynModuleTwo": "1"
}}

Adds a row to a device table on the leading device and on the specified devices.
Error cases:

If wrong columns data is specified in the JSON body, the APSolute Vision server returns the error from a leading device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request adding a row with index "Test" (specified in the path parameter) to the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/v2/devices/config/aw/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsIDSNewRulesStateTwo": "1",
"rsIDSNewRulesName": "Test"
"rsIDSNewRulesInstanceIdTwo": "0"
"rsIDSNewRulesPortmask": ""
"rsIDSNewRulesInstanceIdTwo": "1"
"rsIDSNewRulesDirection": "1"
"rsIDSNewRulesVlanTagGroup": ""
"rsIDSNewRulesMPLSRDGroup": ""
"rsIDSNewRulesProfileNetfloodThree": ""
"rsIDSNewRulesProfileDNSThree": ""
"rsIDSNewRulesProfileAppsecThree": ""
"rsIDSNewRulesProfileConlmt": ""
"rsIDSNewRulesProfileSynprotectionThree": ""
"rsIDSNewRulesActionTwo": "1"
}}

The following is an example of a request adding a row with the index "Test", specified in the path parameters, to the "Signature Profile" table:

Path: https://Vision IP/mgmt/device/multi/config/rsIDSSignaturesProfilesTable/Test/1/Risk/High/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsIDSSignaturesProfileName": "Test1"
"rsIDSSignaturesProfileRuleAttributeName": "High"
"rsIDSSignaturesProfileRuleAttributeType": "Risk"
"rsIDSSignaturesProfileRuleName": "1"
}
}

The following is an example of a request adding a row with the index "Entry1", specified in the path parameters, to the "White List" table:

Path: https://Vision IP/mgmt/device/multi/config/rsNewWhiteListTable/Entry1/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsNewWhiteListAction": "Test"
"rsNewWhiteListAllModules": "1"
"rsNewWhiteListDescriptionTwo": "Attach White List Entry"
"rsNewWhiteListDirection": "1"
"rsNewWhiteListDstNetwork": "SG4"
"rsNewWhiteListDstPortGroup": "rtsp"
"rsNewWhiteListHttpFloodModuleTwo": "1"
"rsNewWhiteListName": "Entry1"
"rsNewWhiteListProtocol": "0"
"rsNewWhiteListServerCrackingModuleTwo": "1"
"rsNewWhiteListSignatureModuleTwo": "1"
"rsNewWhiteListSrcNetwork": "SG2"
"rsNewWhiteListSrcPortGroup": "msn"
"rsNewWhiteListState": "1"
"rsNewWhiteListSynModuleTwo": "1"
}}

Deletes a row from the leading device table and from the table on all specified devices.
Error cases:

If the wrong index is specified in the path, the APSolute Vision server returns the error from a leading device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request to delete a row with index "Test" (specified in the path parameter) from the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/v2/devices/config/aw/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{

"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

The following is an example of a request deleting a row with the indexes "Test", "1', "Risk", "High", specified in the path parameters, from the "Signature Profile" table:

Path: https://Vision IP/mgmt/v2/devices/config/aw/rsIDSSignaturesProfilesTable/Test/1/Risk/High/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

The following is an example of a request deleting a row with the index "Entry1", specified in the path parameters, from the "White List" table:

Path: https://Vision IP/mgmt/v2/devices/config/aw/rsNewWhiteListTable/Entry1/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

Updates a scalar value on the device.
Error cases:

If the wrong scalar value is specified in the JSON body, the APSolute Vision server returns the device error message.

The following is an example of a request updating the scalar values for the Time Settings of a DefensePro device:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module},
The request JSON is in the following format:
{
"rsWSDNTPPort": "123"
"rsWSDNTPServerUrl": "132.45.15.12"
},

The following is an example of a request updating the scalar values for the Alteon Management Traffic Routing:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module},
The request JSON is in the following format:
{
{"agMgmtNewCfgCdp": "2"
"agMgmtNewCfgDns": "2"
"agMgmtNewCfgOcsp": "2"
"agMgmtNewCfgReport": "2"
}

The following is an example of a request updating the scalar values of Alteon for the APM Server:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module},
The request JSON is in the following format:
{
{"agNewCfgAPMServerDataIpAddr": "172.16.55.21"
"agNewCfgAPMServerDataPort": "443"
"agNewCfgAPMServerId": "123"
"agNewCfgAPMServerMgmtIpAddr": "185.18.2.2"
}

Uploads a certificate file to the specified devices.

Query parameters:
id - The certificate unique identifier.
type - The type of the file. Possible values are "key" for SSL key; "cert" for certificate, "req" for certificate request, "p12" for certificate and key, "interm" for intermediate certificate.
passphrase - The password for the private keys encryption.
src - The source type. Possible values are "txt" or "file". In this case the value should be "file".

Body parameters are: the file content as an octal stream, and the leading device, and the device list information as a JSON string inside the form data.
The following is an example of a request to upload a key with index "888" (specified in the query parameter) to the specified devices:

Path: https://Vision IP/mgmt/device/multi/config/sslcertimport?id=888&type=key&passphrase=radware&src=file,
The request body is in the following format:
{
Content-Disposition: form-data; name="Filedata"; filename="13.key"
Content-Type: application/octet-stream
Content-Disposition: form-data; name="requestStringData"
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

Updates a row in a device table.
Use cases:

If inconsistent columns data is specified in the JSON body, the HTTP 500 error code is returned with the error forwarded from a device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request updating the row with index "Test" (specified in the path parameter) in the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{
"rsIDSNewRulesActionTwo": "1"
"rsIDSNewRulesDestination": "SG4"
"rsIDSNewRulesDirection": "1"
"rsIDSNewRulesInstanceIdTwo": "1"
"rsIDSNewRulesName": "Test"
"rsIDSNewRulesPacketReportingEnforcementTwo": "1"
"rsIDSNewRulesPacketTraceEnforcementTwo": "1"
"rsIDSNewRulesPacketTraceStatusTwo": "1"
"rsIDSNewRulesPortmask": ""
"rsIDSNewRulesPriorityTwo": "1"
"rsIDSNewRulesProfileAppsecThree": ""
"rsIDSNewRulesProfileConlmtThree": ""
"rsIDSNewRulesProfileDNSThree": ""
"rsIDSNewRulesProfileNetfloodThree": ""
"rsIDSNewRulesProfileSynprotectionThree": ""
"rsIDSNewRulesSource": "SG2"
"rsIDSNewRulesStateTwo": "1"
"rsIDSNewRulesVlanTagGroup": ""
}

The following is an example of a request updating the row with the indexes "SG2/1", specified in path parameters, in the "Network" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsBWMNetworkTable/SG2/1/,

The request JSON is in the following format:
{
"rsBWMNetworkName": "SG2"
"rsBWMNetworkSubIndex": "1"
"rsBWMNetworkToIP": "66.152.0.0"
}

The following is an example of a request updating the row with the index "BDOS_Critical", specified in the path parameter, in the "BDoS Profiles" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsNetFloodProfileTable/BDOS_Critical/,

The request JSON is in the following format:
{
"rsNetFloodProfileBandwidthIn": "343434"
"rsNetFloodProfileBandwidthOut": "343434"
"rsNetFloodProfileIcmpInQuota": "1"
"rsNetFloodProfileIcmpOutQuota": "1"
"rsNetFloodProfileIcmpStatus": "1"
"rsNetFloodProfileIgmpInQuota": "1"
"rsNetFloodProfileIgmpOutQuota": "1"
"rsNetFloodProfileIgmpStatus": "1"
"rsNetFloodProfileLevelOfReuglarzation": "1"
"rsNetFloodProfileName": "1"
"rsNetFloodProfilePacketReportStatus": "1"
"rsNetFloodProfilePacketTraceStatus": "1"
"rsNetFloodProfileTcpFinAckStatus": "1"
"rsNetFloodProfileTcpFragStatus": "2"
"rsNetFloodProfileTcpInQuota": "75"
"rsNetFloodProfileTcpOutQuota": "75"
"rsNetFloodProfileTcpRstStatus": "1"
"rsNetFloodProfileTcpSynAckStatus": "1"
"rsNetFloodProfileTcpSynStatus": "1"
"rsNetFloodProfileTransparentOptimization": "1"
"rsNetFloodProfileUdpFragStatus": "2"
"rsNetFloodProfileUdpInQuota": "50"
"rsNetFloodProfileUdpOutQuota": "50"
"rsNetFloodProfileUdpStatus": "2"
}

The following is an example of a request updating the row with the index "450000", specified in the path parameters, in the "Connection Limit Protections" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSConnectionLimitAttackTable/450000/,

The request JSON is in the following format:
{
"rsIDSConnectionLimitAttackId": "450000"
"rsIDSConnectionLimitAttackProtocol": "3"
"rsIDSConnectionLimitAttackReportMode": "0"
"rsIDSConnectionLimitAttackRisk": "2"
"rsIDSConnectionLimitAttackTrackingType": "4"
}

The following is an example of a request updating the row with the index "200009", specified in the path parameters, in the "SYN Protections" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSSYNAttackTable/200009/,

The request JSON is in the following format:
{
"rsIDSSYNAttackActivationThreshold": "2501"
"rsIDSSYNAttackId": "200009"
"rsIDSSYNAttackRisk": "4"
"rsIDSSYNAttackTerminationThreshold": "1501"
}

Retrieves a row from the device table according to index.
Query parameter:
props - Optional parameter specifying a list of column names, separated by commas.

Use cases:

If the "props" query parameter is not provided, all columns of the row are returned.
When a table does not contain the row with the specified index, the empty JSON is returned.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request retrieving the row by index "sgns-dns-auth" from the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSNewRulesTable/sgns-dns-auth?props=rsIDSNewRulesName,rsIDSNewRulesState,
rsIDSNewRulesSource,rsIDSNewRulesDestination,rsIDSNewRulesPortmask,rsIDSNewRulesDirection,Vlan_MPLSRD_TagGroup,
rsIDSNewRulesVlanTagGroup,rsIDSNewRulesMPLSRDGroup,Profiles,rsIDSNewRulesProfileNetflood,rsIDSNewRulesProfileDNS,
rsIDSNewRulesProfileScanning,rsIDSNewRulesProfileStateful,rsIDSNewRulesProfileAppsec,rsIDSNewRulesProfileConlmt,
rsIDSNewRulesProfileSynprotection,rsIDSNewRulesProfilePPS,rsIDSQuarantineStatusInPolicy,rsIDSNewRulesAction,
rsIDSNewRulesPacketReportingStatus,rsIDSNewRulesPacketReportingEnforcement,rsIDSNewRulesPacketTraceStatus,
rsIDSNewRulesPacketTraceEnforcement

The following is an example of a request retrieving the row by index "sadasdasdasdasd" from the "Server Protection Policies" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSNewRulesTable/sadasdasdasdasd?props=rsIDSNewRulesName,
rsIDSNewRulesStateTwo,rsIDSNewRulesInstanceIdTwo,rsIDSNewRulesPriorityTwo,rsIDSNewRulesSource,rsIDSNewRulesDestination,
rsIDSNewRulesPortmask,rsIDSNewRulesDirection,Vlan_MPLSRD_TagGroup,rsIDSNewRulesVlanTagGroup,rsIDSNewRulesMPLSRDGroup,
Profiles,rsIDSNewRulesProfileNetfloodThree,rsIDSNewRulesProfileDNSThree,rsIDSNewRulesProfileScanningThree,
rsIDSNewRulesProfileStatefulThree,rsIDSNewRulesProfileAppsecThree,rsIDSNewRulesProfileConlmtThree,
rsIDSNewRulesProfileSynprotectionThree,rsIDSNewRulesProfilePPSThree,rsIDSNewRulesActionTwo,
rsIDSNewRulesPacketReportingStatusTwo,rsIDSNewRulesPacketReportingEnforcementTwo,rsIDSNewRulesPacketTraceStatusTwo,
rsIDSNewRulesPacketTraceEnforcementTwo

The following is an example of a request retrieving the row by index "SG2" from the "Networks" table:

Path https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsBWMNetworkTable/SG2?props=rsBWMNetworkName,rsBWMNetworkSubIndex,rsBWMNetworkMode,
rsBWMNetworkAddress,rsBWMNetworkFromIP,rsBWMNetworkMask,rsBWMNetworkToIP&count=50

The following is an example of a request retrieving the row by indexes "Management/MNG-1" from the "Physical Ports" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsBWMPhysicalPortGroupTable/Management/MNG-1?props=rsBWMPhysicalPortGroupName,
rsBWMPhysicalPortGroupPort

Adds a row to a device table.
Use cases:

If inconsistent columns data is specified in the JSON body, the APSolute Vision server returns the error from a device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request adding a row with index "Test" (specified in the path parameter) to the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{
"rsIDSNewRulesActionTwo": "1"
"rsIDSNewRulesDestination": "SG4"
"rsIDSNewRulesDirection": "1"
"rsIDSNewRulesInstanceIdTwo": "1"
"rsIDSNewRulesName": "Test"
"rsIDSNewRulesPacketReportingEnforcementTwo": "1"
"rsIDSNewRulesPacketTraceEnforcementTwo": "1"
"rsIDSNewRulesPacketTraceStatusTwo": "1"
"rsIDSNewRulesPortmask": ""
"rsIDSNewRulesPriorityTwo": "1"
"rsIDSNewRulesProfileAppsecThree": ""
"rsIDSNewRulesProfileConlmtThree": ""
"rsIDSNewRulesProfileDNSThree": ""
"rsIDSNewRulesProfileNetfloodThree": ""
"rsIDSNewRulesProfileSynprotectionThree": ""
"rsIDSNewRulesSource": "SG2"
"rsIDSNewRulesStateTwo": "1"
"rsIDSNewRulesVlanTagGroup": ""
},

The following is an example of a request adding a row with the index "Test", specified in the path parameters, to the "Signature Profile" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSSignaturesProfilesTable/Test/1/Risk/High/,

The request JSON is in the following format:
{"rsIDSSignaturesProfileName": "Test"
"rsIDSSignaturesProfileRuleAttributeName": "High"
"rsIDSSignaturesProfileRuleAttributeType": "Risk"
"rsIDSSignaturesProfileRuleName": "1"
}

The following is an example of a request adding a row with the index "Entry1", specified in the path parameters, to the "White List" table:

Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsNewWhiteListTable/Entry1/,

The request JSON is in the following format:
{"rsNewWhiteListAction": "Test"
"rsNewWhiteListAllModules": "1"
"rsNewWhiteListDescriptionTwo": "Attach White List Entry"
"rsNewWhiteListDirection": "1"
"rsNewWhiteListDstNetwork": "SG4"
"rsNewWhiteListDstPortGroup": "rtsp"
"rsNewWhiteListHttpFloodModuleTwo": "1"
"rsNewWhiteListName": "Entry1"
"rsNewWhiteListProtocol": "0"
"rsNewWhiteListServerCrackingModuleTwo": "1"
"rsNewWhiteListSignatureModuleTwo": "1"
"rsNewWhiteListSrcNetwork": "SG2"
"rsNewWhiteListSrcPortGroup": "msn"
"rsNewWhiteListState": "1"
"rsNewWhiteListSynModuleTwo": "1"

Deletes a row from a device table. The request body is empty.

Use case:

If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request deleting the row with index "Test" (specified in the path parameter) from the "Network Protection Policies" table:
Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSNewRulesTable/Test/

The following is an example of a request deleting the row with the index "SG2/1", specified in the path parameters from the "Network" table:
Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsBWMNetworkTable/SG2/1/

The following is an example of a request deleting the row with the index "BDOS_Critical" specified in the path parameter from the "BDoS Profiles" table:
Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsNetFloodProfileTable/BDOS_Critical/

The following is an example of a request deleting the row with the index "450000", specified in the path parameters from the "Connection Limit Protections" table:
Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSConnectionLimitAttackTable/450000/

The following is an example of a request deleting the row with the index "BlackListEntry1", specified in the path parameters from the "Black List" table:
Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsNewBlackListTable/BlackListEntry1/

The following is an example of a request deleting the row with the index "200009", specified in path parameters, from the "SYN Protections" table:
Path: https://Vision IP/mgmt/v2/devices/{Device ID}/config/{module}/rsIDSSYNAttackTable/200009/,

Adds a list of vADC devices to APSolute Vision management.
Error cases:

If one of the specified device names already exists in the Vision server, the APSolute Vision server returns the following error: Node name in the tree must be unique. Please enter another name. (ID:M_00023)

If the specified device IP addresses is already used by another device connected to the APSolute Vision server, the APSolute Vision server returns the error: Device with IP Address [Device IP Address] already exists, please use a different IP Address. (ID:M_00302) (ID:M_00023)

The following is an example of a request to add the specified vADC devices to APSolute Vision:

Path: https://Vision IP/mgmt/device/multi/config/manage,
The request JSON is in the following format:
{
"cliPassword":"admin",
"cliPort":"22",
"cliUsername":"admin",
"cliPassword":"admin",
"exclusivelyReceiveDeviceEvents":"false",
"httpPassword":"admin",
"httpPort":"80",
"httpsPassword":"admin",
"httpsPort":"443",
"httpsUsername":"admin",
"httpUsername":"admin",
"managementIp":"172.16.62.62",
"registerDeviceEvents":"true",
"siteName":"Default",
"snmpV2ReadCommunity":"public",
"snmpV2WriteCommunity":"private",
"snmpVersion":"SNMP_V2",
"type":"Alteon",
"verifyHttpsCredentials":"true",
"createDeviceDtoList":["deviceIP":"172.16.162.1","deviceName" : "172.16.62.62_vADC-1"},{"deviceIP" : "172.16.162.2","deviceName" : "172.16.62.62_vADC-2"}],
}

Uploads the file to the specified devices.

The query parameters are application specific.
The body parameters are the file content as an octal stream, and the leading device and device list information, as a JSON string inside the form data.
The following is an example of a request uploading a tunnel with index "NewDNS" ,specified in the query parameter, to the group of devices:

Path: https://Vision IP/mgmt/device/multi/config/sendtodevice?operationType=ImportTunnel&listeningAddress=10.206.158.114&listeningPort=80&fwAddress=10.206.158.114&protectedEntity=256,
The request body is in the following format:
{
Content-Disposition: form-data; name="Filedata"; filename="dbVul.kvs"
Content-Type: application/octet-stream
Content-Disposition: form-data; name="requestStringData"
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

Uploads certificate file to the specified devices.

Query parameters:
id - The certificate unique identifier.
type - The type of file; Possible values are "key" for SSL key; "cert" for certificate; "req" for certificate request; "p12" for certificate and key; "interm" for intermediate certificate.
passphrase - The password for the private keys encryption.
src - Source type. Possible values are "txt" or "file". In this case, the value should be "file".

Body parameters are the file content as an octal stream, and the leading device, and the device list information as JSON string inside the form data.
The following is an example of a request to upload a key with index "888" ,specified in the query parameter, to the specified devices:

Path: https://Vision IP/mgmt/device/multi/config/sslcertimport?id=888&type=key&passphrase=radware&src=file,
The request body is in the following format:
{
Content-Disposition: form-data; name="Filedata"; filename="13.key"
Content-Type: application/octet-stream
Content-Disposition: form-data; name="requestStringData"
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

Activates the Revert action on each of the specified Alteon or LinkProof NG devices.
The following is an example of a request to perform the Revert action on the specified Alteon devices:

Path: https://Vision IP/mgmt/device/multi/config/revert,
The request JSON is in the following format:
{
"deviceIpAddresses":["172.16.162.1","172.16.162.2"]
}

Reverts the applied configuration for each of the specified Alteon or LinkProof NG devices.
The following is an example of a request reverting the applied configuration for the specified Alteon devices:

Path: https://Vision IP/mgmt/device/multi/config/revertApply,
The request JSON is in the following format:
{
"deviceIpAddresses":["172.16.162.1","172.16.162.2"]
}

"Performs the Update Policies action on the specified devices.
The following is an example of a request to perform the Update Policies action on a group of devices:

Path: https://Vision IP/mgmt/device/multi/config/updatepolicies,
The request JSON is in the following format:
{
"deviceIpAddresses":["172.16.162.1","172.16.162.2","172.16.162.4"]

}

Updates a row in the device table on the leading device and on all specified devices.
Error cases:

If wrong column data is specified in the JSON body, the APSolute Vision server returns the error from a leading device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request updating a row with index "Test" (specified in the path parameter) to the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/device/multi/config/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsIDSNewRulesStateTwo": "1",
"rsIDSNewRulesName": "Test"
"rsIDSNewRulesInstanceIdTwo": "0"
"rsIDSNewRulesPortmask": ""
"rsIDSNewRulesInstanceIdTwo": "1"
"rsIDSNewRulesDirection": "1"
"rsIDSNewRulesVlanTagGroup": ""
"rsIDSNewRulesMPLSRDGroup": ""
"rsIDSNewRulesProfileNetfloodThree": ""
"rsIDSNewRulesProfileDNSThree": ""
"rsIDSNewRulesProfileAppsecThree": ""
"rsIDSNewRulesProfileConlmt": ""
"rsIDSNewRulesProfileSynprotectionThree": ""
"rsIDSNewRulesActionTwo": "1"
}}

The following is an example of a request updating a row with the index "Test", specified in the path parameters, to the "Signature Profile" table:

Path: https://Vision IP/mgmt/device/multi/config/rsIDSSignaturesProfilesTable/Test/1/Risk/High/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsIDSSignaturesProfileName": "Test1"
"rsIDSSignaturesProfileRuleAttributeName": "High"
"rsIDSSignaturesProfileRuleAttributeType": "Risk"
"rsIDSSignaturesProfileRuleName": "1"
}
}

The following is an example of a request updating a row with the index "Entry1", specified in the path parameters, to the "White List" table:

Path: https://Vision IP/mgmt/device/multi/config/rsNewWhiteListTable/Entry1/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsNewWhiteListAction": "Test"
"rsNewWhiteListAllModules": "1"
"rsNewWhiteListDescriptionTwo": "Attach White List Entry"
"rsNewWhiteListDirection": "1"
"rsNewWhiteListDstNetwork": "SG4"
"rsNewWhiteListDstPortGroup": "rtsp"
"rsNewWhiteListHttpFloodModuleTwo": "1"
"rsNewWhiteListName": "Entry1"
"rsNewWhiteListProtocol": "0"
"rsNewWhiteListServerCrackingModuleTwo": "1"
"rsNewWhiteListSignatureModuleTwo": "1"
"rsNewWhiteListSrcNetwork": "SG2"
"rsNewWhiteListSrcPortGroup": "msn"
"rsNewWhiteListState": "1"
"rsNewWhiteListSynModuleTwo": "1"
}}

Adds a row to a device table on the leading device and on the specified devices.
Error cases:

If wrong columns data is specified in the JSON body, the APSolute Vision server returns the error from a leading device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request adding a row with index "Test" (specified in the path parameter) to the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/device/multi/config/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsIDSNewRulesStateTwo": "1",
"rsIDSNewRulesName": "Test"
"rsIDSNewRulesInstanceIdTwo": "0"
"rsIDSNewRulesPortmask": ""
"rsIDSNewRulesInstanceIdTwo": "1"
"rsIDSNewRulesDirection": "1"
"rsIDSNewRulesVlanTagGroup": ""
"rsIDSNewRulesMPLSRDGroup": ""
"rsIDSNewRulesProfileNetfloodThree": ""
"rsIDSNewRulesProfileDNSThree": ""
"rsIDSNewRulesProfileAppsecThree": ""
"rsIDSNewRulesProfileConlmt": ""
"rsIDSNewRulesProfileSynprotectionThree": ""
"rsIDSNewRulesActionTwo": "1"
}}

The following is an example of a request adding a row with the index "Test", specified in the path parameters, to the "Signature Profile" table:

Path: https://Vision IP/mgmt/device/multi/config/rsIDSSignaturesProfilesTable/Test/1/Risk/High/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsIDSSignaturesProfileName": "Test1"
"rsIDSSignaturesProfileRuleAttributeName": "High"
"rsIDSSignaturesProfileRuleAttributeType": "Risk"
"rsIDSSignaturesProfileRuleName": "1"
}
}

The following is an example of a request adding a row with the index "Entry1", specified in the path parameters, to the "White List" table:

Path: https://Vision IP/mgmt/device/multi/config/rsNewWhiteListTable/Entry1/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"],
"requestData": {"rsNewWhiteListAction": "Test"
"rsNewWhiteListAllModules": "1"
"rsNewWhiteListDescriptionTwo": "Attach White List Entry"
"rsNewWhiteListDirection": "1"
"rsNewWhiteListDstNetwork": "SG4"
"rsNewWhiteListDstPortGroup": "rtsp"
"rsNewWhiteListHttpFloodModuleTwo": "1"
"rsNewWhiteListName": "Entry1"
"rsNewWhiteListProtocol": "0"
"rsNewWhiteListServerCrackingModuleTwo": "1"
"rsNewWhiteListSignatureModuleTwo": "1"
"rsNewWhiteListSrcNetwork": "SG2"
"rsNewWhiteListSrcPortGroup": "msn"
"rsNewWhiteListState": "1"
"rsNewWhiteListSynModuleTwo": "1"
}}

Deletes a row from the leading device table and from the table on all specified devices.
Error cases:

If the wrong index is specified in the path, the APSolute Vision server returns the error from a leading device.
If the path parameter is not provided, the HTTP 500 error code is returned with the error message.

The following is an example of a request to delete a row with index "Test" (specified in the path parameter) from the "Network Protection Policies" table:

Path: https://Vision IP/mgmt/device/multi/config/rsIDSNewRulesTable/Test/,
The request JSON is in the following format:
{

"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

The following is an example of a request deleting a row with the indexes "Test", "1', "Risk", "High", specified in the path parameters, from the "Signature Profile" table:

Path: https://Vision IP/mgmt/device/multi/config/rsIDSSignaturesProfilesTable/Test/1/Risk/High/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

The following is an example of a request deleting a row with the index "Entry1", specified in the path parameters, from the "White List" table:

Path: https://Vision IP/mgmt/device/multi/config/rsNewWhiteListTable/Entry1/,

The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

Updates single variable (scalar) values on the leading device and on all specified devices.
Error condition regarding the leading device:

If the wrong variable values are specified in the JSON body, the APSolute Vision server returns device error message.

Error condition regarding the remaining devices:

If the wrong variable values are specified in the JSON body, the device error message will appear in the summarizing message on the client and in the summarizing alert.

The following is an example of a request to update variable (scalar) values on the leading device and on all specified devices:

Path: https://Vision IP/mgmt/device/multi/config/,
The request JSON is in the following format:
{
"leadingDeviceIp": "172.16.162.7",
"deviceIpAddresses":["172.16.162.1","172.16.162.2","172.16.162.4"],
"requestData": {"agMgmtNewCfgRadius": "1",
"agMgmtNewCfgTacacs": "2",
"agMgmtNewCfgSyslog": "2",
"agMgmtNewCfgSnmp": "2",
"agMgmtNewCfgTftp": "2",
"agMgmtNewCfgReport": "2"
}
}

Uploads the DNS Key text to the specified devices.

Query parameters are:
"id" - The DNS Key unique identifier.
"type" of file; The value should be "zone" for DNS Key.
"passphrase" - The password for the DNS keys encryption.
The rest are application specific parameters.

The following is an example of a request uploading a key with index "NewTextDNS" ,specified in the query parameter, to the specified devices:

Path: https://Vision IP/mgmt/device/multi/config/dnskeyimport?id=NewTextDNS&type=zone&state=1&passphrase=radware&keysz=1024&hash=1&ttl=86400&exp=2419200&rollover=604800&sigval=604800&sigPUB=302400,
The request body is in the following format:
{
"requestData":"LS0tLS1CRUdJTiBSU0EgUFJJV…​.",
{
"leadingDeviceIp": "172.16.22.46",
"deviceIpAddresses":["172.16.22.44","172.16.22.43","172.16.22.42"]
}

Activates the Save action on each of the specified Alteon or LinkProof NG devices.
The following is an example of a request to perform the Save action on the specified Alteon devices: