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 thefield
option in the matching result.f
: Returns records that contain the value specified by thefield
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 includingid
,start_ip
,end_ip
,cidr
attributes in the_matchnet_result
field.f
: Does not output_matchnet_result
field.