Opérateurs de comparaison à utiliser dans les modèles d'événements sur Amazon EventBridge

Vous trouverez ci-dessous un résumé de tous les opérateurs de comparaison disponibles dans EventBridge.

Les opérateurs de comparaison ne fonctionnent que sur les nœuds terminaux, à l’exception de $or et anything-but.

Correspondance de préfixe

Vous pouvez mettre en correspondance un événement en fonction du préfixe d’une valeur dans la source de l’événement. Vous pouvez utiliser la correspondance de préfixes pour les valeurs de chaîne.

Par exemple, le modèle d’événement suivant correspond à tout événement où le champ "time" commence par "2017-10-02", tel que "time": "2017-10-02T18:43:48Z".

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

Correspondance du préfixe tout en ignorant les majuscules

Vous pouvez également faire correspondre une valeur de préfixe quelle que soit la majuscule des caractères par lesquels elle commence, equals-ignore-case en utilisant conjointement avec prefix.

Par exemple, le modèle d'événement suivant correspondrait à tout événement dans lequel le service champ commence par la chaîne de caractèresEventB, mais également EVENTB par toute autre majuscule de ces caractères. eventb

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

Correspondance de suffixes

Vous pouvez mettre en correspondance un événement en fonction du suffixe d’une valeur dans la source de l’événement. Vous pouvez utiliser la correspondance de suffixes pour les valeurs de chaîne.

Par exemple, le modèle d’événement suivant correspond à tout événement où le champ "FileName" se termine par l’extension de fichier .png.

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

Correspondance du suffixe en ignorant les majuscules

Vous pouvez également faire correspondre une valeur de suffixe quelle que soit la majuscule des caractères par lesquels une valeur se termine, equals-ignore-case en utilisant conjointement avec suffix.

Par exemple, le modèle d'événement suivant correspondrait à tout événement où le FileName champ se terminait par la chaîne de caractères.png, mais également à .PNG toute autre majuscule de ces caractères.

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

Anything-but correspondant

Anything-butla correspondance correspond à tout sauf à ce qui est spécifié dans la règle.

Vous pouvez utiliser la correspondance anything-but avec des chaînes et des valeurs numériques, y compris des listes contenant uniquement des chaînes ou des nombres.

Le modèle d’événement suivant montre la correspondance anything-but avec des chaînes et des nombres.

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

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

Le modèle d’événement suivant montre la correspondance anything-but avec une liste de chaînes.

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

Le modèle d’événement suivant montre la correspondance anything-but avec une liste de nombres.

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

Anything-but faire correspondre tout en ignorant les majuscules

Vous pouvez également l'utiliser equals-ignore-case conjointement avecanything-but, pour faire correspondre les valeurs de chaîne, quelle que soit la mise en majuscule des caractères.

Le modèle d'événement suivant correspond aux state champs qui ne contiennent pas la chaîne « initializing », « INITIALIZING », « Initializing » ou toute autre majuscule de ces caractères.

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

Vous pouvez également utiliser equals-ignore-case en conjonction avec anything-but pour comparer à une liste de valeurs :

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

Anything-but correspondance sur les préfixes

Vous pouvez l'utiliser prefix conjointement avec anything-but pour faire correspondre des valeurs de chaîne qui ne commencent pas par la valeur spécifiée. Cela inclut des valeurs uniques ou une liste de valeurs.

Le modèle d'événement suivant montre tout sauf une correspondance qui correspond à tout événement dont le préfixe n'est pas indiqué dans le champ"init". "state"

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

Le modèle d'événement suivant montre tout sauf la correspondance utilisée avec une liste de valeurs de préfixes. Ce modèle d'événement correspond à tout événement qui n'a ni le préfixe "init" ni "stop" le "state" champ.

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

Anything-but correspondant aux suffixes

Vous pouvez l'utiliser suffix conjointement avec anything-but pour faire correspondre des valeurs de chaîne qui ne se terminent pas par la valeur spécifiée. Cela inclut des valeurs uniques ou une liste de valeurs.

Le modèle d'événement suivant correspond à toutes les valeurs du FileName champ qui ne se terminent pas par.txt.

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

Le modèle d'événement suivant montre tout sauf la correspondance utilisée avec une liste de valeurs de suffixes. Ce modèle d'événement correspond à toutes les valeurs du FileName champ qui ne se terminent pas par .txt ou.rtf.

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

Anything-but correspondance à l'aide de caractères génériques

Vous pouvez utiliser le caractère générique (*) dans les valeurs que vous spécifiez pour tout sauf pour la correspondance. Cela inclut des valeurs uniques ou une liste de valeurs.

Le modèle d'événement suivant correspond à toutes les valeurs du FileName champ qui ne contiennent pas/lib/.

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

Le modèle d'événement suivant montre tout sauf la correspondance utilisée avec une liste de valeurs comprenant des caractères génériques. Ce modèle d'événement correspond à toutes les valeurs du FileName champ qui ne contiennent ni l'un /lib/ ni l'autre/bin/.

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

Pour plus d’informations, consultez Correspondance à l’aide de caractères génériques.

Correspondance numérique

La correspondance numérique compare les valeurs sous forme de nombres à virgule flottante en double précision 64 bits (IEEE 754 binary64), ce qui limite les entiers pouvant être mis en correspondance avec précision. Les entiers correspondent exactement entre -9 007 199 254 740 992 et 9 007 199 254 740 992 (-2 53 à +2 53). Si une valeur se situe en dehors de cette plage ou ne peut pas être représentée exactement comme un double, EventBridge rejette la règle au moment de la création lorsque la valeur est utilisée dans une comparaison numérique, et un événement contenant une telle valeur n'est pas traité comme un nombre et ne correspondra pas à une comparaison numérique.

L’exemple suivant illustre la correspondance numérique pour un modèle d’événement qui ne correspond qu’aux événements dont tous les champs sont vrais.

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

Correspondance d'adresses IP

Vous pouvez utiliser la correspondance d’adresses IP pour les adresses IPv4 et IPv6. Le modèle d’événement suivant illustre la correspondance d’adresses IP à des adresses IP qui commencent par 10.0.0 et se terminent par un nombre compris entre 0 et 255.

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

Correspondance exists

La correspondance exists fonctionne sur la présence ou l’absence d’un champ dans le code JSON de l’événement.

La correspondance de type « exists » ne fonctionne que sur des nœuds terminaux. Elle ne fonctionne pas sur des nœuds intermédiaires.

Le modèle d’événement suivant correspond à n’importe quel événement comportant un champ detail.state.

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

Le modèle d’événement précédent correspond à l’événement suivant.

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

Le modèle d’événement précédent ne correspond PAS à l’événement suivant, car il ne comporte aucun champ 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 correspondant

Equals-ignore-casela correspondance fonctionne sur les valeurs de chaîne indépendamment des majuscules.

Le modèle d’événement suivant correspond à n’importe quel événement comportant un champ detail-type qui correspond à la chaîne spécifiée, quelle que soit sa casse.

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

Le modèle d’événement précédent correspond à l’événement suivant.

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

Correspondance à l’aide de caractères génériques

Vous pouvez utiliser le caractère générique (*) pour mettre en correspondance des valeurs de chaîne dans les modèles d’événements.

Considérations relatives à l’utilisation de caractères génériques dans vos modèles d’événements :

Complexité des caractères génériques et des modèles d’événements

La complexité d’une règle utilisant des caractères génériques est limitée. Si une règle est trop complexe, EventBridge renvoie un InvalidEventPatternException lors de la tentative de création de la règle. Si votre règle génère une telle erreur, envisagez de suivre les conseils ci-dessous pour réduire la complexité du modèle d’événement :

Exemple complexe avec correspondance multiple

Vous pouvez combiner plusieurs critères de correspondance pour créer un modèle d'événement plus complexe. Par exemple, le modèle d’événement suivant combine anything-but et 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" } ]
  }
}

Exemple complexe avec $or correspondant

Vous pouvez également créer des modèles d’événements complexes qui vérifient si l’une des valeurs de champs correspond, dans plusieurs champs. Utilisez $or pour créer un modèle d’événement qui correspond si l’une des valeurs de plusieurs champs correspond.

Notez que vous pouvez inclure d’autres types de filtres, tels que la correspondance numérique et les tableaux, dans votre correspondance de modèles pour les champs individuels de votre construction $or.

Le modèle d’événement suivant correspond si l’une des conditions suivantes est remplie :

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