Operatori di confronto da utilizzare nei modelli di eventi in Amazon EventBridge

Di seguito un riepilogo di tutti gli operatori di confronto disponibili in EventBridge.

Gli operatori di confronto funzionano solo su nodi foglia, a eccezione di $or e anything-but.

Corrispondenza in base al prefisso

Puoi trovare un evento corrispondente a seconda del prefisso di un valore nell'origine dell'evento. È possibile utilizzare la corrispondenza in base al prefisso per i valori delle stringhe.

Ad esempio, il seguente modello di eventi corrisponderebbe a qualsiasi evento in cui il campo "time" comincia con "2017-10-02", come in "time": "2017-10-02T18:43:48Z".

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

Corrispondenza dei prefissi ignorando le maiuscole

È inoltre possibile abbinare un valore di prefisso indipendentemente dalla maiuscola e minuscola dei caratteri con cui inizia un valore, utilizzando insieme a equals-ignore-case prefix.

Ad esempio, il seguente modello di evento corrisponderebbe a qualsiasi evento in cui il service campo inizia con la stringa di caratteriEventB, ma anche EVENTBeventb, o qualsiasi altra scrittura maiuscola di tali caratteri.

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

Corrispondenza in base al suffisso

Puoi trovare un evento corrispondente a seconda del suffisso di un valore nell'origine dell'evento. È possibile utilizzare la corrispondenza in base al suffisso per i valori delle stringhe.

Ad esempio, il seguente modello di eventi corrisponderebbe a qualsiasi evento in cui il campo "FileName" termina con l'estensione di file .png.

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

Corrispondenza dei suffissi ignorando le maiuscole

È inoltre possibile abbinare un valore di suffisso indipendentemente dalla maiuscola e minuscola dei caratteri con cui termina un valore, utilizzando in combinazione con equals-ignore-case suffix.

Ad esempio, il seguente schema di eventi corrisponderebbe a qualsiasi evento in cui il FileName campo termina con la stringa di caratteri.png, ma anche .PNG a qualsiasi altra scrittura maiuscola di tali caratteri.

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

Corrispondenza anything-but

Tutto tranne che la corrispondenza corrisponde a qualsiasi cosa ad eccezione di quanto specificato nella regola.

Puoi utilizzare la corrispondenza anything-but con stringhe e valori numerici, inclusi elenchi contenenti solo stringhe o solo numeri.

Il modello di eventi seguente mostra la corrispondenza anything-but con stringhe e numeri.

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

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

Il modello di eventi seguente mostra la corrispondenza anything-but con un elenco di stringhe.

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

Il modello di eventi seguente mostra la corrispondenza anything-but con un elenco di numeri.

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

Tutto tranne la corrispondenza ignorando le maiuscole e le minuscole

Puoi anche usarlo insieme equals-ignore-case a, per abbinare i valori delle stringhe indipendentemente dal anything-but maiuscolo e minuscolo dei caratteri.

Il seguente modello di eventi corrisponde ai state campi che non contengono la stringa «initializing», "«, INITIALIZING «Initializing» o qualsiasi altra forma di maiuscolo di tali caratteri.

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

È possibile utilizzare anche equals-ignore-case in combinazione con anything-but per confrontare un elenco di valori:

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

Tutto tranne la corrispondenza sui prefissi

È possibile utilizzare insieme prefix a anything-but per abbinare valori di stringa che non iniziano con il valore specificato. Ciò include valori singoli o un elenco di valori.

Il seguente schema di eventi mostra tutto tranne le corrispondenze che corrispondono a qualsiasi evento che non ha il prefisso "init" nel campo. "state"

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

Il seguente schema di eventi mostra tutto tranne la corrispondenza utilizzata con un elenco di valori di prefisso. Questo modello di eventi corrisponde a qualsiasi evento che non ha né il prefisso né il campo"init". "stop" "state"

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

Tutto tranne la corrispondenza sui suffissi

È possibile utilizzare insieme suffix a anything-but per abbinare valori di stringa che non terminano con il valore specificato. Ciò include valori singoli o un elenco di valori.

Il seguente modello di eventi corrisponde a tutti i valori del FileName campo che non terminano con.txt.

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

Il seguente schema di eventi mostra tutto tranne la corrispondenza utilizzata con un elenco di valori di suffisso. Questo modello di eventi corrisponde a tutti i valori del FileName campo che non terminano con uno o. .txt .rtf

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

Tutto tranne la corrispondenza tramite caratteri jolly

È possibile utilizzare il carattere jolly (*) all'interno dei valori specificati per qualsiasi cosa tranne che per la corrispondenza. Ciò include valori singoli o un elenco di valori.

Il seguente modello di eventi corrisponde a tutti i valori del FileName campo che non lo contengono/lib/.

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

Il seguente schema di eventi mostra tutto tranne la corrispondenza utilizzata con un elenco di valori che includono i caratteri jolly. Questo modello di evento corrisponde a tutti i valori del FileName campo che non contengono né l'uno né l'altro. /lib/ /bin/

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

Per ulteriori informazioni, consulta Corrispondenza tramite caratteri jolly.

Corrispondenza numerica

La corrispondenza numerica funziona con valori che sono JSON numeri. È limitata a valori compresi tra -5.0e9 e +5.0e9 incluso, con 15 cifre di precisione (sei cifre a destra della virgola decimale).

Di seguito viene illustrata la corrispondenza numerica per un modello di eventi che corrisponde solo a eventi che sono veri per tutti i campi.

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

Corrispondenza in base all'indirizzo IP

Puoi utilizzare la corrispondenza degli indirizzi IP per IPv6 gli indirizzi IPv4 e. Il seguente modello di eventi mostra la corrispondenza in base all'indirizzo IP con indirizzi IP che iniziano con 10.0.0 e terminano con un numero compreso tra 0 e 255.

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

Corrispondenza in base all'esistenza

Exists Matching funziona sulla presenza o l'assenza JSON di un campo nell'evento.

La corrispondenza in base all'esistenza funziona solo sui nodi foglia. Non funziona sui nodi intermedi.

Il seguente modello di eventi corrisponde a qualsiasi evento che abbia un campo detail.state.

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

Il modello di eventi precedente corrisponde all'evento seguente.

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

Il modello di evento precedente NOT corrisponde al seguente evento perché non ha un detail.state campo.

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

Corrispondenza E quals-ignore-case

La quals-ignore-case corrispondenza E funziona sui valori delle stringhe indipendentemente dalle maiuscole e minuscole.

Il modello di eventi seguente corrisponde a qualsiasi evento che ha un campo detail-type che corrisponde alla stringa specificata, indipendentemente dall'uso di maiuscole e minuscole.

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

Il modello di eventi precedente corrisponde all'evento seguente.

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

Corrispondenza tramite caratteri jolly

È possibile utilizzare il carattere jolly (*) per la corrispondenza con valori di stringa in modelli di eventi.

Considerazioni sull'uso dei caratteri jolly nei modelli di eventi:

Complessità dei caratteri jolly e dei modelli di eventi

Esiste un limite alla complessità di una regola che utilizza caratteri jolly. Se una regola è troppo complessa, EventBridge restituisce un InvalidEventPatternException quando tenta di creare la regola. Se la tua regola genera un errore di questo tipo, valuta la possibilità di utilizzare le istruzioni riportate di seguito per ridurre la complessità del modello di eventi:

Esempio complesso con corrispondenza multipla

Puoi combinare più criteri di corrispondenza in uno schema di eventi più complesso. Ad esempio, il seguente modello di eventi combina anything-but e 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" } ]
  }
}

Esempio complesso con corrispondenza $or

Puoi anche creare modelli di eventi complessi che verificano se i valori del campo any corrispondono in più campi. Utilizza $or per creare modello di eventi che corrisponde se uno qualsiasi dei valori di più campi corrisponde.

Nota che puoi includere altri tipi di filtri, come la corrispondenza numerica e array, nel modello per singoli campi nel tuo costrutto $or.

Il modello di eventi seguente corrisponde se viene soddisfatta una delle seguenti condizioni:

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