Amazon EventBridge のイベントパターンで使用する比較演算子

EventBridge で使用できるすべての比較演算子は以下のとおりです。

比較オペレーションは、$or と anything-but を除いてリーフノードでのみ機能します。

プレフィックスマッチング

イベントソース内の値のプレフィックスに応じてイベントをマッチングすることができます。文字列値にはプレフィックスマッチングを使用できます。

例えば、次のイベントパターンは、"time": "2017-10-02T18:43:48Z" のように "time" フィールドが "2017-10-02" で始まるすべてのイベントに一致します。

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

大文字と小文字を無視する際のプレフィックスマッチング

また、equals-ignore-case と prefix. を組み合わせて、値が始まる文字の大文字と小文字に関係なく、プレフィックス値を一致させることもできます。

例えば、次のイベントパターンは、service フィールドが文字列 EventB で始まるイベントだけでなく、EVENTB、eventb、またはそれらの文字の大文字と小文字も一致させます。

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

サフィックスマッチング

イベントソース内の値のサフィックスに応じてイベントをマッチングすることができます。文字列値にはサフィックスマッチングを使用できます。

例えば、次のイベントパターンは、"FileName" フィールドが .png ファイル拡張子で終わるすべてのイベントに一致します。

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

大文字と小文字を区別しないサフィックスマッチング

また、equals-ignore-case と suffix. を組み合わせて、値の末尾の文字の大文字と小文字に関係なく、サフィックス値を一致させることもできます。

例えば、次のイベントパターンは、FileName フィールドが文字列 .png で終わるイベントだけでなく、.PNG またはそれらの文字の大文字と小文字も一致させます。

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

「以外」のマッチング

指定したもの以外のマッチングは、ルールで指定されているもの以外のすべてに一致します。

文字列のみを含むリスト、または数字のみを含むリストを含む、文字列および数値で「以外」のマッチングを使用できます。

次のイベントパターンは、文字列と数字を使った「以外」のマッチングを示しています。

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

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

次のイベントパターンは、文字列のリストを使った「以外」のマッチングを示しています。

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

次のイベントパターンは、数値のリストを使った「以外」のマッチングを示しています。

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

大文字と小文字を区別せずに一致するもの

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"] }}]}
}

「以外」マッチング (プレフィックス)

prefix と anything-but を組み合わせて、指定された値で始まらない文字列値に一致させることができます。これには、単一の値、または値のリストが含まれます。

次のイベントパターンは、"state" フィールドに "init" というプレフィックスを持たないすべてのイベントにマッチする、「以外」のマッチングを示しています。

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

次のイベントパターンは、プレフィックスの値のリストを使った「以外」のマッチングを示しています。このイベントパターンは、"state" フィールドにプレフィックス "init" または "stop" のいずれも持たないイベントと一致します。

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

「以外」マッチング (サフィックス)

suffix と anything-but を組み合わせて、指定した値で終了しない文字列値に一致させることができます。これには、単一の値、または値のリストが含まれます。

次のイベントパターンは、.txt で終わらない FileName フィールドの値と一致します。

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

次のイベントパターンは、サフィックスの値のリストを使った「以外」のマッチングを示しています。このイベントパターンは、.txt または .rtf で終わらない FileName フィールドの値と一致します。

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

「以外」マッチング (ワイルドカードを使用)

ワイルドカード文字 (*) は、「以外」マッチングで指定した値の中で使用できます。これには、単一の値、または値のリストが含まれます。

次のイベントパターンは、/lib/ を含まない FileName フィールドの値と一致します。

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

次のイベントパターンは、ワイルドカードを含む値のリストを使った「以外」のマッチングを示しています。このイベントパターンは、/lib/ または /bin/ を含まない FileName フィールドの値と一致します。

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

詳細については、「ワイルドカードを使用したマッチング」を参照してください。

数値マッチング

数値マッチングは、JSON 数値である値で動作します。精度が 15 桁 (小数点の右に 6 桁) の -5.0e9 から +5.0e9 までの値に制限されています。

以下は、すべてのフィールドが真であるイベントにのみ一致するイベントパターンの数値マッチングを示しています。

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

IP アドレスマッチング

IP アドレスマッチングは、IPv4 アドレスと IPv6 アドレスに使用できます。次のイベントパターンは、10.0.0 で始まり、0 ～ 255 の数値で終わる IP アドレスに一致する IP アドレスを示しています。

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

存在マッチング

存在マッチングは、イベントの JSON 内のフィールドの有無に対して機能します。

存在マッチングは、リーフノードでのみ機能します。中間ノードでは機能しません。

次のイベントパターンは、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
    }
  }
}

Equals-ignore-case マッチング

Equals-ignore-case は、大文字と小文字に関係なく文字列値に適用されます。

次のイベントパターンは、大文字小文字に関係なく、指定された文字列と一致する 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 ] } ] }
    ]
  }
}