Class CfnFindingsFilter

java.lang.Object
software.amazon.jsii.JsiiObject
All Implemented Interfaces:
IConstruct, IDependable, IInspectable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct

@Generated(value="jsii-pacmak/1.84.0 (build 5404dcf)", date="2023-06-19T16:29:59.849Z") @Stability(Stable) public class CfnFindingsFilter extends CfnResource implements IInspectable
A CloudFormation AWS::Macie::FindingsFilter.

The AWS::Macie::FindingsFilter resource specifies a findings filter. In Amazon Macie , a findings filter , also referred to as a filter rule , is a set of custom criteria that specifies which findings to include or exclude from the results of a query for findings. The criteria can help you identify and focus on findings that have specific characteristics, such as severity, type, or the name of an affected AWS resource. You can also configure a findings filter to suppress (automatically archive) findings that match the filter's criteria. For more information, see Filtering findings in the Amazon Macie User Guide .

An AWS::Macie::Session resource must exist for an AWS account before you can create an AWS::Macie::FindingsFilter resource for the account. Use a DependsOn attribute to ensure that an AWS::Macie::Session resource is created before other Macie resources are created for an account. For example, "DependsOn": "Session" .

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.macie.*;
 CfnFindingsFilter cfnFindingsFilter = CfnFindingsFilter.Builder.create(this, "MyCfnFindingsFilter")
         .findingCriteria(FindingCriteriaProperty.builder()
                 .criterion(Map.of(
                         "criterionKey", CriterionAdditionalPropertiesProperty.builder()
                                 .eq(List.of("eq"))
                                 .gt(123)
                                 .gte(123)
                                 .lt(123)
                                 .lte(123)
                                 .neq(List.of("neq"))
                                 .build()))
                 .build())
         .name("name")
         // the properties below are optional
         .action("action")
         .description("description")
         .position(123)
         .build();
 
  • Field Details

    • CFN_RESOURCE_TYPE_NAME

      @Stability(Stable) public static final String CFN_RESOURCE_TYPE_NAME
      The CloudFormation resource type name for this resource class.
  • Constructor Details

    • CfnFindingsFilter

      protected CfnFindingsFilter(software.amazon.jsii.JsiiObjectRef objRef)
    • CfnFindingsFilter

      protected CfnFindingsFilter(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
    • CfnFindingsFilter

      @Stability(Stable) public CfnFindingsFilter(@NotNull Construct scope, @NotNull String id, @NotNull CfnFindingsFilterProps props)
      Create a new AWS::Macie::FindingsFilter.

      Parameters:
      scope -
      • scope in which this resource is defined.
      This parameter is required.
      id -
      • scoped id of the resource.
      This parameter is required.
      props -
      • resource properties.
      This parameter is required.
  • Method Details

    • inspect

      @Stability(Stable) public void inspect(@NotNull TreeInspector inspector)
      Examines the CloudFormation resource and discloses attributes.

      Specified by:
      inspect in interface IInspectable
      Parameters:
      inspector -
      • tree inspector to collect and process attributes.
      This parameter is required.
    • renderProperties

      @Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
      Overrides:
      renderProperties in class CfnResource
      Parameters:
      props - This parameter is required.
    • getAttrArn

      @Stability(Stable) @NotNull public String getAttrArn()
      The Amazon Resource Name (ARN) of the findings filter.
    • getAttrId

      @Stability(Stable) @NotNull public String getAttrId()
      The unique identifier for the findings filter.
    • getCfnProperties

      @Stability(Stable) @NotNull protected Map<String,Object> getCfnProperties()
      Overrides:
      getCfnProperties in class CfnResource
    • getFindingCriteria

      @Stability(Stable) @NotNull public Object getFindingCriteria()
      The criteria to use to filter findings.
    • setFindingCriteria

      @Stability(Stable) public void setFindingCriteria(@NotNull IResolvable value)
      The criteria to use to filter findings.
    • setFindingCriteria

      @Stability(Stable) public void setFindingCriteria(@NotNull CfnFindingsFilter.FindingCriteriaProperty value)
      The criteria to use to filter findings.
    • getName

      @Stability(Stable) @NotNull public String getName()
      A custom name for the findings filter. The name can contain 3-64 characters.

      Avoid including sensitive data in the name. Users of the account might be able to see the name, depending on the actions that they're allowed to perform in Amazon Macie .

    • setName

      @Stability(Stable) public void setName(@NotNull String value)
      A custom name for the findings filter. The name can contain 3-64 characters.

      Avoid including sensitive data in the name. Users of the account might be able to see the name, depending on the actions that they're allowed to perform in Amazon Macie .

    • getAction

      @Stability(Stable) @Nullable public String getAction()
      The action to perform on findings that match the filter criteria ( FindingCriteria ). Valid values are:.

      • ARCHIVE - Suppress (automatically archive) the findings.
      • NOOP - Don't perform any action on the findings.
    • setAction

      @Stability(Stable) public void setAction(@Nullable String value)
      The action to perform on findings that match the filter criteria ( FindingCriteria ). Valid values are:.

      • ARCHIVE - Suppress (automatically archive) the findings.
      • NOOP - Don't perform any action on the findings.
    • getDescription

      @Stability(Stable) @Nullable public String getDescription()
      A custom description of the findings filter. The description can contain 1-512 characters.

      Avoid including sensitive data in the description. Users of the account might be able to see the description, depending on the actions that they're allowed to perform in Amazon Macie .

    • setDescription

      @Stability(Stable) public void setDescription(@Nullable String value)
      A custom description of the findings filter. The description can contain 1-512 characters.

      Avoid including sensitive data in the description. Users of the account might be able to see the description, depending on the actions that they're allowed to perform in Amazon Macie .

    • getPosition

      @Stability(Stable) @Nullable public Number getPosition()
      The position of the findings filter in the list of saved filters on the Amazon Macie console.

      This value also determines the order in which the filter is applied to findings, relative to other filters that are also applied to findings.

    • setPosition

      @Stability(Stable) public void setPosition(@Nullable Number value)
      The position of the findings filter in the list of saved filters on the Amazon Macie console.

      This value also determines the order in which the filter is applied to findings, relative to other filters that are also applied to findings.