Match

class aws_cdk.aws_events.Match(*args: Any, **kwargs)

Bases: object

An event pattern matcher.

ExampleMetadata:

infused

Example:

rule = events.Rule(self, "rule",
    event_pattern=events.EventPattern(
        detail={
            "object": {
                # Matchers may appear at any level
                "size": events.Match.greater_than(1024)
            },

            # 'OR' condition
            "source-storage-class": events.Match.any_of(
                events.Match.prefix("GLACIER"),
                events.Match.exact_string("DEEP_ARCHIVE"))
        },
        detail_type=events.Match.equals_ignore_case("object created"),

        # If you prefer, you can use a low level array of strings, as directly consumed by EventBridge
        source=["aws.s3"],

        region=events.Match.anything_but_prefix("us-gov")
    )
)

Methods

as_list()

A representation of this matcher as a list of strings.

Return type:

List[str]

resolve(context)

Produce the Token’s value at resolution time.

Parameters:

context (IResolveContext)

Return type:

Any

to_string()

Return a string representation of this resolvable object.

Returns a reversible string representation.

Return type:

str

Attributes

creation_stack

The creation stack of this resolvable which will be appended to errors thrown during resolution.

This may return an array with a single informational element indicating how to get this property populated, if it was skipped for performance reasons.

Static Methods

classmethod all_of(*matchers)

Matches an event if any of the provided matchers do.

Only numeric matchers are accepted.

Parameters:

matchers (Any)

Return type:

List[str]

classmethod any_of(*matchers)

Matches an event if any of the provided matchers does.

Parameters:

matchers (Any)

Return type:

List[str]

classmethod anything_but(*values)

Matches anything except what’s provided in the rule.

The list of provided values must contain only strings or only numbers.

Parameters:

values (Any)

Return type:

List[str]

classmethod anything_but_prefix(prefix)

Matches any string that doesn’t start with the given prefix.

Parameters:

prefix (str)

Return type:

List[str]

classmethod cidr(range)

Matches IPv4 and IPv6 network addresses using the Classless Inter-Domain Routing (CIDR) format.

Parameters:

range (str)

Return type:

List[str]

classmethod does_not_exist()

Matches when the field is absent from the JSON of the event.

Return type:

List[str]

classmethod equal(value)

Matches numbers equal to the provided value.

Parameters:

value (Union[int, float])

Return type:

List[str]

classmethod equals_ignore_case(value)

Matches a string, regardless of case, in the JSON of the event.

Parameters:

value (str)

Return type:

List[str]

classmethod exact_string(value)

Matches a string, exactly, in the JSON of the event.

Parameters:

value (str)

Return type:

List[str]

classmethod exists()

Matches when the field is present in the JSON of the event.

Return type:

List[str]

classmethod greater_than(value)

Matches numbers greater than the provided value.

Parameters:

value (Union[int, float])

Return type:

List[str]

classmethod greater_than_or_equal(value)

Matches numbers greater than, or equal to, the provided value.

Parameters:

value (Union[int, float])

Return type:

List[str]

classmethod interval(lower, upper)

Matches numbers inside a closed numeric interval. Equivalent to:.

Match.allOf(Match.greaterThanOrEqual(lower), Match.lessThanOrEqual(upper))

Parameters:
  • lower (Union[int, float]) – Lower bound (inclusive).

  • upper (Union[int, float]) – Upper bound (inclusive).

Return type:

List[str]

classmethod ip_address_range(range)

Matches IPv4 and IPv6 network addresses using the Classless Inter-Domain Routing (CIDR) format.

Alias of cidr().

Parameters:

range (str)

Return type:

List[str]

classmethod less_than(value)

Matches numbers less than the provided value.

Parameters:

value (Union[int, float])

Return type:

List[str]

classmethod less_than_or_equal(value)

Matches numbers less than, or equal to, the provided value.

Parameters:

value (Union[int, float])

Return type:

List[str]

classmethod null_value()

Matches a null value in the JSON of the event.

Return type:

List[str]

classmethod prefix(value)

Matches strings with the given prefix in the JSON of the event.

Parameters:

value (str)

Return type:

List[str]

classmethod suffix(value)

Matches strings with the given suffix in the JSON of the event.

Parameters:

value (str)

Return type:

List[str]