すべてのプロダクト
Search

このプロダクト

    EventBridge:イベントパターン

    ドキュメントセンター

    EventBridge:イベントパターン

    最終更新日:Jan 11, 2025

    イベントパターンは、EventBridge がイベントをフィルタリングするために提供するモジュールです。 EventBridge は、イベントパターンを使用してイベントをフィルタリングし、イベントターゲットにルーティングします。 イベントパターンは、一致するイベントと同じ構造である必要があります。 このトピックでは、一般的なイベントパターンについて説明します。

    使用方法

    イベントパターンを使用する場合は、以下の点に注意してください。

    • 一致するイベントには、イベントパターンにリストされているすべてのフィールドが含まれている必要があり、イベント内のフィールドはイベントパターン内のフィールドと同じネスト構造である必要があります。

    • イベントパターンの各文字に対して完全一致が使用されます。すべての文字は大文字と小文字が区別されます。 EventBridge は、一致処理中に文字列を変更しません。

    • 一致するイベントのすべての値は JSON 形式である必要があります。 これらの値には、数値、二重引用符（ "" ）で囲まれた文字列、およびtrue、false、null などの二重引用符（ "" ）で囲まれていないキーワードが含まれます。

    • イベントパターンは OR 論理演算子をサポートしています。 イベントパターンでキーを指定するには AND 論理演算子を使用し、配列でキー値を指定するには OR 論理演算子を使用できます。

    フィールド値に基づくイベントマッチング

    特定のフィールドの値を一致条件として指定できます。 次の例では、source フィールドの値がオブジェクトストレージサービス（ OSS ）を示すイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
    "source":[
        "acs.oss" // OSS をソースとするイベント
    ]
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}

    フィールド値のプレフィックスに基づくイベントマッチング

    フィールド値のプレフィックスを一致条件として指定できます。 次の例では、source フィールドの値がacs. で始まるイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
    "source":[
        {
            "prefix":"acs." // acs. で始まるソースを持つイベント
        }
    ]
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}

    フィールド値の包含に基づくイベントマッチング

    イベントマッチングに含めるフィールド値を指定できます。 次のセクションでは、2 つの例について説明します。 例 1 では、type フィールドの値にNormal が含まれるイベントのみが一致してフィルタリングされます。 例 2 では、type フィールドの値にNormal またはError が含まれるイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    例 1: "type" フィールドの値に "Normal"

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"UserNormalEvent",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
  "type":[
    {
      "contains": "Normal" // "Normal" を含む type フィールドの値
    }
  ]
}

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"UserNormalEvent",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"UserErrorEvent",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.png",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}

    なし

    例 2: "type" フィールドの値に "Normal" または "Error"

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"UserNormalEvent",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
  "type":[
    {
      "contains": "Normal" // "Normal" を含む type フィールドの値
    },
    {
      "contains": "Error" // "Error" を含む type フィールドの値
    }
  ]
}

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"UserNormalEvent",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"UserErrorEvent",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.png",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"UserErrorEvent",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.png",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"UserOtherEvent",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.png",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}

    なし

    フィールド値のサフィックスに基づくイベントマッチング

    フィールド値のサフィックスを一致条件として指定できます。 次の例では、subject フィールドの値がacs:oss:cn-hangzhou:1234567:xls-papk/ で始まり、.jpg または.txt で終わるイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
    "subject":[
        {
            "prefix":"acs:oss:cn-hangzhou:1234567:xls-papk/" // "acs:oss:cn-hangzhou:1234567:xls-papk/" で始まる subject フィールドの値
        },
        {
            "suffix":".txt" // ".txt" で終わる subject フィールドの値
        },
        {
            "suffix":".jpg" // ".jpg" で終わる subject フィールドの値
        }
    ]
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.png",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    { // ".png" で終わる subject フィールドの値はフィルタリングされる
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.png",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}

    フィールド値の除外に基づくイベントマッチング

    anything-but フィールドを使用して、文字列と数値を除外できます。 次の例では、state フィールドの値がinitializing でなく、x-limit フィールドの値が123 でないイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    次のパターンは、anything-but フィールドを使用して、1 つの文字列と 1 つの数値を除外します。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "state":"running",
        "x-limit":456
    }
}
    {
    "data":{
        "state":[
            {
                "anything-but":"initializing" // "initializing" 以外の state フィールドの値
            }
        ],
        "x-limit":[
            {
                "anything-but":123 // 123 以外の x-limit フィールドの値
            }
        ]
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "state":"running",
        "x-limit":456
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "x-limit":456 // state フィールドがないため、フィルタリングされる
    }
}

    なし

    次の例では、state フィールドの値がstopped またはoverloaded でないイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "state":"terminated"
    }
}
    {
    "data":{
        "state":[
            {
                "anything-but":[
                    "stopped", // "stopped" 以外の state フィールドの値
                    "overloaded" // "overloaded" 以外の state フィールドの値
                ]
            }
        ]
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "state":"terminated"
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "state":"stopped" // state フィールドの値が "stopped" なので、フィルタリングされる
    }
}

    なし

    次の例では、x-limit フィールドの値が100、200、または300 でないイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "x-limit":456
    }
}
    {
    "data":{
        "x-limit":[
            {
                "anything-but":[
                    100, // 100、
                    200, // 200、
                    300 // 300 以外の x-limit フィールドの値
                ]
            }
        ]
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "x-limit":456
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "x-limit":200 // x-limit フィールドの値が 200 なので、フィルタリングされる
    }
}

    なし

    次の例では、state フィールドの値がinit で始まらないイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "state":"pending"
    }
}
    {
    "data":{
        "state":[
            {
                "anything-but":{
                    "prefix":"init" // "init" で始まらない state フィールドの値
                }
            }
        ]
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "state":"pending"
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "state":"initializing" // state フィールドの値が "initializing" で始まるので、フィルタリングされる
    }
}

    なし

    次の例では、source フィールドの値がElastic Compute Service（ ECS ）を示していないイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "x-limit":456
    }
}
    {
    "source":[
        {
            "anything-but":[
                "acs.ecs" // "acs.ecs" 以外の source フィールドの値
            ]
        }
    ]
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "x-limit":456
    }
}
    {
    "data":{
        "meetingName":"marketing-meeting",
        "action":"meeting_start",
        "time":1590592494070,
        "meetingUUID":"hz-20864c8f-b10d-45cd-9935-884bca1b****"
    },
    "id":"45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source":"acs.aliyuncvc", // source フィールドの値が "acs.aliyuncvc" なので、フィルタリングされる
    "specversion":"1.0",
    "subject":"acs.aliyuncvc:cn-hangzhou:<yourAccountId>:215672",
    "time":"2020-07-21 20:22:01.961000",
    "type":"aliyuncvc:MeetingEvent:MeetingStateEvent"
}

    なし

    次の例では、source フィールドの値が Alibaba Cloud サービスを示していないイベントのみが一致してフィルタリングされます。 この場合、カスタムアプリケーションから送信されたイベントが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss", // source フィールドの値が "acs.oss" で始まるので、フィルタリングされる
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "x-limit":456
    }
}
    {
    "source":[
        {
            "anything-but":{
                "prefix":"acs." // "acs." で始まらない source フィールドの値
            }
        }
    ]
}

    なし

    数値または範囲に基づくイベントマッチング

    フィールドの数値または範囲を一致条件として指定できます。 次の例では、c-count フィールドの値が 0 より大きく 5 以下、d-count フィールドの値が 10 未満、x-limit フィールドの値が 301.8 であるイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "c-count":5,
        "d-count":7,
        "x-limit":301.8
    }
}
    {
    "data":{
        "c-count":[
            {
                "numeric":[
                    ">", // より大きい
                    0,
                    "<=", // 以下
                    5
                ]
            }
        ],
        "d-count":[
            {
                "numeric":[
                    "<", // 未満
                    10
                ]
            }
        ],
        "x-limit":[
            {
                "numeric":[
                    "=", // 等しい
                    301.8
                ]
            }
        ]
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "c-count":5,
        "d-count":7,
        "x-limit":301.8
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "c-count":5,
        "d-count":7,
        "x-limit":300 // x-limit フィールドの値が 300 なので、フィルタリングされる
    }
}

    なし

    重要

    数値の一致は、数値が JSON 形式で -1.0e9 から +1.0e9 の間にある場合にのみ有効です。 これらの数値は、15 桁と小数点以下 6 桁まで正確です。

    IP アドレスに基づくイベントマッチング

    data パラメーターのフィールドを使用して、 IP アドレスを一致条件として指定できます。 次の例では、source-ip フィールドの値が10.0.0.0/24 であるイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "source-ip":"10.0.0.123"
    }
}
    {
    "data":{
        "source-ip":[
            {
                "cidr":"10.0.0.0/24" // 10.0.0.0/24 の CIDR ブロック
            }
        ]
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "source-ip":"10.0.0.123"
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "source-ip":"192.168.0.123" // source-ip フィールドの値が 192.168.0.123 なので、フィルタリングされる
    }
}

    なし

    説明

    このタイプのイベントマッチングでは、 IPv4 アドレスのみがサポートされています。

    組み合わせ条件に基づくイベントマッチング

    複数のフィルタールールを組み合わせて、一致条件として使用できます。 これにより、イベントを正確に一致させてフィルタリングできます。 次の例では、プレフィックスマッチング、除外マッチング、 IP アドレスマッチング、および数値マッチングが組み合わされています。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "c-count":5,
        "d-count":7,
        "x-limit":301.8,
        "state":"pending",
        "source-ip":"10.0.0.123"
    }
}
    {
    "source":[
        {
            "prefix":"acs." // "acs." で始まる source フィールドの値
        }
    ],
    "data":{
        "state":[
            {
                "anything-but":"initializing" // "initializing" 以外の state フィールドの値
            }
        ],
        "source-ip":[
            {
                "cidr":"10.0.0.0/24" // 10.0.0.0/24 の CIDR ブロック
            }
        ],
        "c-count":[
            {
                "numeric":[
                    ">", // より大きい
                    0,
                    "<=", // 以下
                    5
                ]
            }
        ],
        "d-count":[
            {
                "numeric":[
                    "<", // 未満
                    10
                ]
            }
        ],
        "x-limit":[
            {
                "anything-but":[
                    100, // 100、
                    200, // 200、
                    300 // 300 以外の x-limit フィールドの値
                ]
            }
        ]
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "c-count":5,
        "d-count":7,
        "x-limit":301.8,
        "state":"pending",
        "source-ip":"10.0.0.123"
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "c-count":5,
        "d-count":7,
        "x-limit":301.8,
        "state":"initializing", // state フィールドの値が "initializing" なので、フィルタリングされる
        "source-ip":"192.168.0.123" // source-ip フィールドの値が 192.168.0.123 なので、フィルタリングされる
    }
}

    なし

    配列に基づくイベントマッチング

    イベントパターンの各フィールドの値は、1 つ以上の値を含む配列です。 配列内の値がイベント内の値と一致する場合、イベントは一致してフィルタリングされます。 イベント内の値も配列であり、イベント内の配列とイベントパターン内の配列の共通部分が空集合でない場合、イベントは一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
    "subject":[
        "acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg", // subject フィールドの値が一致
        "acs:oss:cn-hangzhou:1112223:xls-papk/game_apk/123.jpg",
        "acs:oss:cn-hangzhou:4455667:xls-papk/game_apk/123.jpg"
    ]
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":[
        "acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg", // subject フィールドの値が一致
        "acs:acs.aliyuncvc:cn-hangzhou:<yourAccountId>:215672"
    ],
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}
    { // 配列の共通部分が空ではないため一致
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":[
        "acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
        "acs:acs.aliyuncvc:cn-hangzhou:<yourAccountId>:215672"
    ],
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100
    }
}

    null 値または空の文字列に基づくイベントマッチング

    フィールド値の null 値または空の文字列を一致条件として指定できます。 次の例では、eventVersion フィールドの値が空の文字列であるイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
  "version": "0",
  "id": "7adc8c1a-645d-4476-bdef-5d6fb57f****",
  "datacontenttype": "Instance Launch Successful",
  "source": "acs.oss",
  "account": "123456789012",
  "time": "2015-11-11T21:31:47Z",
  "region": "cn-hangzhou",
  "resources": [
   ],
  "data": {
    "eventVersion": "",
    "responseElements": null
   }
}
    {
    "data":{
        "eventVersion":[
            "" // 空の文字列
        ]
    }
}
    {
  "version": "0",
  "id": "7adc8c1a-645d-4476-bdef-5d6fb57f****",
  "datacontenttype": "Instance Launch Successful",
  "source": "acs.oss",
  "account": "123456789012",
  "time": "2015-11-11T21:31:47Z",
  "region": "cn-hangzhou",
  "resources": [
   ],
  "data": {
    "eventVersion": "",
    "responseElements": null
   }
}
    {
  "version": "0",
  "id": "7adc8c1a-645d-4476-bdef-5d6fb57f****",
  "datacontenttype": "Instance Launch Successful",
  "source": "acs.oss",
  "account": "123456789012",
  "time": "2015-11-11T21:31:47Z",
  "region": "cn-hangzhou",
  "resources": [
   ],
  "data": {
    "eventVersion": "1.0", // eventVersion フィールドの値が "1.0" なので、フィルタリングされる
    "responseElements": null
   }
}

    なし

    次の例では、responseElements フィールドの値が null であるイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
  "version": "0",
  "id": "7adc8c1a-645d-4476-bdef-5d6fb57f****",
  "datacontenttype": "Instance Launch Successful",
  "source": "acs.oss",
  "time": "2015-11-11T21:31:47Z",
  "region": "cn-hangzhou",
  "resources": [
   ],
  "data": {
    "eventVersion": "",
    "responseElements": null
   }
}
    {
    "data":{
        "responseElements":[
            null // null 値
        ]
    }
}
    {
  "version": "0",
  "id": "7adc8c1a-645d-4476-bdef-5d6fb57f****",
  "datacontenttype": "Instance Launch Successful",
  "source": "acs.oss",
  "time": "2015-11-11T21:31:47Z",
  "region": "cn-hangzhou",
  "resources": [
   ],
  "data": {
    "eventVersion": "",
    "responseElements": null
   }
}
    {
  "version": "0",
  "id": "7adc8c1a-645d-4476-bdef-5d6fb57f****",
  "datacontenttype": "Instance Launch Successful",
  "source": "acs.oss",
  "account": "123456789012",
  "time": "2015-11-11T21:31:47Z",
  "region": "cn-hangzhou",
  "resources": [
   ],
  "data": {
    "eventVersion": "",
    "responseElements": "lss" // responseElements フィールドの値が "lss" なので、フィルタリングされる
   }
}

    なし

    説明

    null 値は空の文字列とは異なります。 空の文字列と一致するイベントパターンを使用する場合、 null 値は一致しません。

    フィールドの有無に基づくイベントマッチング

    data パラメーター内のフィールドの有無を一致条件として指定できます。 次の例では、state フィールドが存在しないイベントのみが一致してフィルタリングされます。 次の表は、イベントソースからイベントが送信され、イベントパターンによってフィルタリングされるプロセスを示しています。

    イベントソースからのイベント

    イベントパターン

    フィルタリング後のイベント

    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
    }
}
    {
    "data":{
        "state":[
            {
               "exists": false // state フィールドが存在しない
            }
         ]
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
    }
}
    {
    "id":"7adc8c1a-645d-4476-bdef-5d6fb57f****",
    "source":"acs.oss",
    "specversion":"1.0",
    "type":"oss:ObjectCreated:PostObject",
    "datacontenttype":"application/json",
    "dataschema":"http://example.com/test.json",
    "subject":"acs:oss:cn-hangzhou:1234567:xls-papk/game_apk/123.jpg",
    "time":"2020-08-17T16:04:46.149Asia/Shanghai",
    "data":{
        "name":"test",
        "scope":100,
        "state":"terminated" // state フィールドが存在するので、フィルタリングされる
    }
}

    なし