CfnFilterProps

class aws_cdk.aws_guardduty.CfnFilterProps(*, detector_id, finding_criteria, name, action=None, description=None, rank=None, tags=None)

Bases: object

Properties for defining a CfnFilter.

Parameters:

detector_id (str) – The detector ID associated with the GuardDuty account for which you want to create a filter. To find the detectorId in the current Region, see the Settings page in the GuardDuty console, or run the ListDetectors API.
finding_criteria (Union[IResolvable, FindingCriteriaProperty, Dict[str, Any]]) – Represents the criteria to be used in the filter for querying findings.
name (str) – The name of the filter. Valid characters include period (.), underscore (_), dash (-), and alphanumeric characters. A whitespace is considered to be an invalid character.
action (Optional[str]) – Specifies the action that is to be applied to the findings that match the filter.
description (Optional[str]) – The description of the filter. Valid characters include alphanumeric characters, and special characters such as hyphen, period, colon, underscore, parentheses ( { } , [ ] , and ( ) ), forward slash, horizontal tab, vertical tab, newline, form feed, return, and whitespace.
rank (Union[int, float, None]) – Specifies the position of the filter in the list of current filters. Also specifies the order in which this filter is applied to the findings. The minimum value for this property is 1 and the maximum is 100. By default, filters may not be created in the same order as they are ranked. To ensure that the filters are created in the expected order, you can use an optional attribute, DependsOn , with the following syntax: "DependsOn":[ "ObjectName" ] .
tags (Optional[Sequence[Union[CfnTag, Dict[str, Any]]]]) – The tags to be added to a new filter resource. Each tag consists of a key and an optional value, both of which you define. For more information, see Tag .

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-filter.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_guardduty as guardduty

# criterion: Any

cfn_filter_props = guardduty.CfnFilterProps(
    detector_id="detectorId",
    finding_criteria=guardduty.CfnFilter.FindingCriteriaProperty(
        criterion=criterion,
        item_type=guardduty.CfnFilter.ConditionProperty(
            eq=["eq"],
            equal_to=["equalTo"],
            greater_than=123,
            greater_than_or_equal=123,
            gt=123,
            gte=123,
            less_than=123,
            less_than_or_equal=123,
            lt=123,
            lte=123,
            neq=["neq"],
            not_equals=["notEquals"]
        )
    ),
    name="name",

    # the properties below are optional
    action="action",
    description="description",
    rank=123,
    tags=[CfnTag(
        key="key",
        value="value"
    )]
)

Attributes

action

Specifies the action that is to be applied to the findings that match the filter.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-filter.html#cfn-guardduty-filter-action

description

The description of the filter.

Valid characters include alphanumeric characters, and special characters such as hyphen, period, colon, underscore, parentheses ( { } , [ ] , and ( ) ), forward slash, horizontal tab, vertical tab, newline, form feed, return, and whitespace.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-filter.html#cfn-guardduty-filter-description

detector_id

The detector ID associated with the GuardDuty account for which you want to create a filter.

To find the detectorId in the current Region, see the Settings page in the GuardDuty console, or run the ListDetectors API.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-filter.html#cfn-guardduty-filter-detectorid

finding_criteria

Represents the criteria to be used in the filter for querying findings.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-filter.html#cfn-guardduty-filter-findingcriteria

name

The name of the filter.

Valid characters include period (.), underscore (_), dash (-), and alphanumeric characters. A whitespace is considered to be an invalid character.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-filter.html#cfn-guardduty-filter-name

rank

Specifies the position of the filter in the list of current filters.

Also specifies the order in which this filter is applied to the findings. The minimum value for this property is 1 and the maximum is 100.

By default, filters may not be created in the same order as they are ranked. To ensure that the filters are created in the expected order, you can use an optional attribute, DependsOn , with the following syntax: "DependsOn":[ "ObjectName" ] .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-filter.html#cfn-guardduty-filter-rank

tags

The tags to be added to a new filter resource.

Each tag consists of a key and an optional value, both of which you define.

For more information, see Tag .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-filter.html#cfn-guardduty-filter-tags