在 Amazon EventBridge 事件模式中使用的比较运算符

以下是 EventBridge 中可用的所有比较运算符的汇总。

比较运算符仅适用于叶节点，$or 和 anything-but 除外。

前缀匹配

您可以根据事件源中值的前缀匹配事件。您可以对字符串值使用 prefix 匹配。

例如，以下事件模式将匹配 "time" 字段以 "2017-10-02" 开头的任何事件，例如 "time": "2017-10-02T18:43:48Z"。

{
  "time": [ { "prefix": "2017-10-02" } ]
}

Prefix 匹配（忽略大小写）

您也可以将 equals-ignore-case 与 prefix. 搭配使用，在匹配前缀值时，不考虑值开头字符的大小写。

例如，以下事件模式将匹配其中 service 字段以 EventB、EVENTB、eventb 或这些字符的任何其他大写开头的任何事件。

{
  "detail": {"service" : [{ "prefix": { "equals-ignore-case": "EventB" }}]}
}

后缀匹配

您可以根据事件源中值的后缀匹配事件。您可以对字符串值使用后缀匹配。

例如，以下事件模式将匹配 "FileName" 字段以 .png 文件扩展名结尾的任何事件。

{
  "FileName": [ { "suffix": ".png" } ]
}

Suffix 匹配（忽略大小写）

您也可以将 equals-ignore-case 与 suffix. 搭配使用，在匹配后缀值时，不考虑值开头字符的大小写。

例如，以下事件模式将匹配其中 FileName 字段以 .png、.PNG 或这些字符的任何其他大写结尾的任何事件。

{
  "detail": {"FileName" : [{ "suffix": { "equals-ignore-case": ".png" }}]}
}

Anything-but 匹配

Anything-but 匹配会匹配除规则中指定的内容之外的任何内容。

您可以将 Anything-but 匹配与字符串和数值一起使用，包括仅包含字符串或仅包含数值的列表。

以下事件模式显示了 Anything-but 匹配与字符串和数字。

{
  "detail": {
    "state": [ { "anything-but": "initializing" } ]
  }
}

{
  "detail": {
    "x-limit": [ { "anything-but": 123 } ]
  }
}

以下事件模式显示了 Anything-but 匹配与一组字符串。

{
  "detail": {
    "state": [ { "anything-but": [ "stopped", "overloaded" ] } ]
  }
}

以下事件模式显示了 Anything-but 匹配与一组数字。

{
  "detail": {
    "x-limit": [ { "anything-but": [ 100, 200, 300 ] } ]
  }
}

Anything-but 匹配（忽略大小写）

您也可以将 equals-ignore-case 与 anything-but 搭配使用，匹配字符串值，不考虑字符大小写。

以下事件模式将匹配不包含字符串“initializing”、“INITIALIZING”、“Initializing”或这些字符的任何其他大写字母的 state 字段。

{
  "detail": {"state" : [{ "anything-but": { "equals-ignore-case": "initializing" }}]}
}

您也可以将 equals-ignore-case 与 anything-but 搭配使用匹配值列表：

{
  "detail": {"state" : [{ "anything-but": { "equals-ignore-case": ["initializing", "stopped"] }}]}
}

对前缀使用 anything-but 匹配

您可以将 prefix 与 anything-but 搭配使用来匹配不以指定值开头的字符串值。这包括单个的值或值的列表。

以下事件模式显示了与 "state" 字段中没有 "init" 前缀的任何事件相匹配的 anything-but 匹配。

{
  "detail": {
    "state": [ { "anything-but": { "prefix": "init" } } ]
  }
}

以下事件模式显示了与一个前缀值列表搭配使用的 anything-but 匹配。此事件模式将匹配 "state" 字段中没有前缀 "init" 或 "stop" 的任何事件。

{
"detail": {
  "state" : [{ "anything-but": { "prefix": ["init", "stop"] } } ] }
  }
}

对后缀使用 anything-but 匹配

您可以将 suffix 与 anything-but 搭配使用来匹配不以指定值结尾的字符串值。这包括单个的值或值的列表。

以下事件模式将匹配 FileName 字段中不以 .txt 结尾的任何值。

{
  "detail": {
    "FileName": [ { "anything-but": { "suffix": ".txt" } } ]
  }
}

以下事件模式显示了与一个后缀值列表搭配使用的 anything-but 匹配。此事件模式将匹配 FileName 字段中不以 .txt 或 .rtf 结尾的任何值。

{
  "detail": {
    "FileName": [ { "anything-but": { "suffix": [".txt", ".rtf"] } } ]
  }
}

Anything-but 匹配与通配符搭配使用

您可以在为 anything-but 匹配指定的值中使用通配符（*）。这包括单个的值或值的列表。

以下事件模式将匹配 FileName 字段中不包含 /lib/ 的任何值。

{
"detail": {
  "FilePath" : [{ "anything-but": { "wildcard": "*/lib/*" }}]
  }
}

以下事件模式显示了与一个含通配符的值列表搭配使用的 anything-but 匹配。此事件模式将匹配 FileName 字段中不含 /lib/ 或 /bin/ 的任何值。

{
"detail": {
  "FilePath" : [{ "anything-but": { "wildcard": ["*/lib/*", "*/bin/*"] }}]
  }
}

有关更多信息，请参阅 使用通配符进行匹配。

数值匹配

数值匹配适用于 JSON 数字值。仅限于 -5.0e9 和 +5.0e9（含）之间的值，精度为 15 位（小数点右侧为六位）。

以下代码显示的事件模式的数值匹配，仅匹配所有字段均为真的事件。

{
  "detail": {
    "c-count": [ { "numeric": [ ">", 0, "<=", 5 ] } ],
    "d-count": [ { "numeric": [ "<", 10 ] } ],
    "x-limit": [ { "numeric": [ "=", 3.018e2 ] } ]
  }
}

IP 地址匹配

可以将 IP 地址匹配用于 IPv4 和 IPv6 地址。以下事件模式显示的 IP 地址匹配，匹配以 10.0.0 开头并以 0 到 255 之间的数字结尾的 IP 地址。

{
  "detail": {
    "sourceIPAddress": [ { "cidr": "10.0.0.0/24" } ]
  }
}

Exists 匹配

Exists 匹配 用于确定事件的 JSON 中存在或不存在某个字段。

Exists 匹配仅适用于叶节点。它对于中间节点不起作用。

以下事件模式与任何具有 detail.state 字段的事件相匹配。

{
  "detail": {
    "state": [ { "exists": true  } ]
  }
}

上一事件模式与以下事件匹配。

{
  "version": "0",
  "id": "7bf73129-1428-4cd3-a780-95db273d1602",
  "detail-type": "EC2 Instance State-change Notification",
  "source": "aws.ec2",
  "account": "123456789012",
  "time": "2015-11-11T21:29:54Z",
  "region": "us-east-1",
  "resources": ["arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1111"],
  "detail": {
    "instance-id": "i-abcd1111",
    "state": "pending"
  }
}

上一事件模式与以下事件不匹配，因为它没有 detail.state 字段。

{
  "detail-type": [ "EC2 Instance State-change Notification" ],
  "resources": [ "arn:aws:ec2:us-east-1:123456789012:instance/i-02ebd4584a2ebd341" ],
  "detail": {
    "c-count" : {
       "c1" : 100
    }
  }
}

等于-忽略-大小写匹配

等于-忽略-大小写 匹配适用于字符串值，无论大小写如何。

以下事件模式匹配 detail-type 字段与指定字符串相匹配（无论大小写如何）的任何事件。

{
  "detail-type": [ { "equals-ignore-case": "ec2 instance state-change notification" } ]
}

上一事件模式与以下事件匹配。

{
  "detail-type": [ "EC2 Instance State-change Notification" ],
  "resources": [ "arn:aws:ec2:us-east-1:123456789012:instance/i-02ebd4584a2ebd341" ],
  "detail": {
    "c-count" : {
       "c1" : 100
    }
  }
}

使用通配符进行匹配

您可以使用通配符 (*) 匹配事件模式中的字符串值。

在事件模式中使用通配符的注意事项：

通配符和事件模式的复杂性

规则使用通配符的复杂程度是有限的。如果规则过于复杂，在尝试创建规则时，EventBridge 会返回 InvalidEventPatternException。如果您的规则生成此类错误，请考虑使用以下指南来降低事件模式的复杂性：

具有多个匹配的复杂示例

您可以将多匹配条件组合成更复杂的事件模式。例如，以下事件模式组合了 anything-but 和 numeric。

{
  "time": [ { "prefix": "2017-10-02" } ],
  "detail": {
    "state": [ { "anything-but": "initializing" } ],
    "c-count": [ { "numeric": [ ">", 0, "<=", 5 ] } ],
    "d-count": [ { "numeric": [ "<", 10 ] } ],
    "x-limit": [ { "anything-but": [ 100, 200, 300 ] } ]
  }
}

{
  "detail": {
    "location": [ { "prefix": "us-" } ],
    "location": [ { "anything-but": "us-east" } ]
  }
}

具有 $or 匹配的复杂示例

您还可以创建复杂的事件模式，检查多个字段中是否有任何 字段值匹配。$or 用于创建事件模式，匹配多个字段中有任何值匹配的情况。

请注意，在 $or 构造中，您可以在各个字段的模式匹配中包含其他筛选器类型，例如数值匹配和数组。

满足以下任意条件时，匹配以下事件模式：

{
  "detail": {
    "$or": [
      { "c-count": [ { "numeric": [ ">", 0, "<=", 5 ] } ] },
      { "d-count": [ { "numeric": [ "<", 10 ] } ] },
      { "x-limit": [ { "numeric": [ "=", 3.018e2 ] } ] }
    ]
  }
}