Cisco Cisco Firepower Management Center 4000 Developer's Guide
2-13
FireSIGHT System Host Input API Guide
Chapter 2 Using the Host Input API
Host Input API Functions
UnsetService
You can use the
UnsetService
function to remove user-added server definitions from a specified host.
UnsetService
does not remove any server definitions detected through FireSIGHT.
Note
If the number of servers stored in the network map for a specific host exceeds 100, new server
information is ignored until servers are deleted from the host.
information is ignored until servers are deleted from the host.
Use this syntax:
UnsetService($source_type_id, $source_id, $addr_string, $port, $protocol)
Table 2-8
SetService Fields
Field
Description
Required
Allowed Values
$source_type_id
Indicates the type of the
host input source.
host input source.
Yes
“Application”
or
“Scanner”
Note you should set the
$source_type_id
variable to contain the appropriate value before
invoking the
invoking the
SetService
function, and then
reference
$source_type_id
in your function
call. For more information, see
$source_id
Indicates the source ID
for the source adding the
host input.
for the source adding the
host input.
Yes
“source_id”
Note you should set the
$source_id
variable to
contain the source ID before invoking the
SetService
function, and then reference
$source_id
in your function call. For more
information, see
$addr_string
Indicates the string
containing the IP
address or addresses for
the affected hosts.
containing the IP
address or addresses for
the affected hosts.
Yes (unless attribute
lists are provided)
lists are provided)
A comma-separated list of IP addresses, CIDR
blocks, and ranges of IP addresses, enclosed in
double quotes.
blocks, and ranges of IP addresses, enclosed in
double quotes.
$attrib_list
Indicates the host
attribute or attributes
specifying the hosts
affected by the host
input.
attribute or attributes
specifying the hosts
affected by the host
input.
Yes (unless IP
addresses are provided)
addresses are provided)
A list of attribute value hash pairs of the format:
{attribute => “Department”,
value => “Development”},
Note that
$attrib_list
must be an array or
reference an array.
$service
Contains a hash with
keys describing the
details of a server
definition.
keys describing the
details of a server
definition.
If you set a current
third-party map before
calling
third-party map before
calling
SetService
,
only the rendering and
service_name
or
service_id
keys are
required.
The
$service
variable is a server definition hash
that supports several keys. For more
information, see
information, see
.