matchnet

Checks whether the IP address value of the field is included in the specified IP subnet and returns the result.

Syntax

matchnet [OPTIONS] field=TARGET_FIELD guid=NET_GUID [tag=BOOL]
Note
tag option is supported since 4.0.2312.0 version.
Required Parameter
field=FIELD
Target field name. The value of the target field must be an IPv4 address, a string, or a 32-bit integer type. Any other key value is considered a search failure. In the case of string and 32-bit integer type values, the command attempts to search only when these are converted to valid IPv4 addresses.
guid=NET_GUID
IP subnet GUID
Optional Parameter
invert=BOOL
Option to invert the result of matching the value specified by the field option against the IP subnet (default: f)
  • t: Returns records that do not contain the value specified by the field option in the matching result.
  • f: Returns records that contain the value specified by the field option in the matching result.
verify=BOOL
Option to activate the validation for the IP subnet at the query parsing stage (default: t).
  • t: validates the IP subnet at the query parsing stage.
  • f: Does not validate the IP subnet at the query parsing stage. This option prevents the system from issuing syntax errors at the policy synchronization stage.
tag=BOOL
Option to output information about the matched IP subnet (default: f).
  • t: Outputs a map including id, start_ip, end_ip, cidr attributes in the _matchnet_result field.
  • f: Does not output _matchnet_result field.