MapFilter
A map filter for querying findings. Each map filter provides the field to check, the value to look for, and the comparison operator.
Contents
- Comparison
-
The condition to apply to the key value when querying for findings with a map filter.
To search for values that exactly match the filter value, use
EQUALS
. For example, for theResourceTags
field, the filterDepartment EQUALS Security
matches findings that have the valueSecurity
for the tagDepartment
.To search for values other than the filter value, use
NOT_EQUALS
. For example, for theResourceTags
field, the filterDepartment NOT_EQUALS Finance
matches findings that do not have the valueFinance
for the tagDepartment
.EQUALS
filters on the same field are joined byOR
. A finding matches if it matches any one of those filters.NOT_EQUALS
filters on the same field are joined byAND
. A finding matches only if it matches all of those filters.You cannot have both an
EQUALS
filter and aNOT_EQUALS
filter on the same field.Type: String
Valid Values:
EQUALS | NOT_EQUALS
Required: No
- Key
-
The key of the map filter. For example, for
ResourceTags
,Key
identifies the name of the tag. ForUserDefinedFields
,Key
is the name of the field.Type: String
Pattern:
.*\S.*
Required: No
- Value
-
The value for the key in the map filter. Filter values are case sensitive. For example, one of the values for a tag called
Department
might beSecurity
. If you providesecurity
as the filter value, then there is no match.Type: String
Pattern:
.*\S.*
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: