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 e

È inoltre possibile abbinare un valore di prefisso indipendentemente dalla combinazione di maiuscole e minuscole con 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 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 del suffisso ignorando le maiuscole e

È inoltre possibile abbinare un valore di suffisso indipendentemente dalla combinazione di maiuscole e minuscole con equals-ignore-case suffix.

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

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

Anything-but corrispondente

Anything-butla corrispondenza corrisponde a qualsiasi cosa tranne ciò che è 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 ] } ]
  }
}

Anything-but corrisponde ignorando le maiuscole e minuscole

Puoi anche usare insieme equals-ignore-case aanything-but, per far corrispondere i valori delle stringhe indipendentemente dalla combinazione di maiuscole e minuscole.

Il seguente schema di eventi corrisponde ai state campi che non contengono la stringa «initializing», «INITIALIZING», «Initializing» o qualsiasi altra combinazione di maiuscole di tali caratteri.

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

Puoi utilizzarlo anche insieme equals-ignore-case a anything-but per confrontare un elenco di valori:

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

Anything-but corrispondenza sui prefissi

È possibile utilizzarlo insieme prefix a anything-but per abbinare valori di stringa che non iniziano con il valore specificato. Sono inclusi 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 utilizzato con un elenco di valori di prefisso. Questo modello di evento corrisponde a qualsiasi evento che non ha né il prefisso né nel campo"init". "stop" "state"

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

Anything-but corrispondenza sui suffissi

È possibile utilizzarlo insieme suffix a anything-but per abbinare valori di stringa che non terminano con il valore specificato. Sono inclusi valori singoli o un elenco di valori.

Il seguente schema 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 le corrispondenze utilizzate con un elenco di valori di suffisso. Questo modello di evento corrisponde a tutti i valori del FileName campo che non terminano con o. .txt .rtf

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

Anything-but abbinamento con caratteri jolly

Puoi utilizzare il carattere jolly (*) all'interno dei valori specificati per qualsiasi cosa tranne che per la corrispondenza. Sono inclusi valori singoli o un elenco di valori.

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

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

Il seguente schema di eventi mostra tutto tranne le corrispondenze utilizzate 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 confronta i valori come numeri a virgola mobile a doppia precisione a 64 bit (IEEE 754 binary64), il che limita i numeri interi che possono essere abbinati esattamente. I numeri interi vengono abbinati esattamente da -9.007.199.254.740.992 a 9.007.199.254.740.992 (da -2 53 a +2 53). Se un valore non rientra in questo intervallo o non può essere rappresentato esattamente come un doppio, EventBridge rifiuta la regola al momento della creazione quando il valore viene utilizzato in un confronto numerico e un evento contenente tale valore non viene trattato come un numero e non corrisponderà a un confronto numerico.

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

È possibile utilizzare la corrispondenza in base all'indirizzo IP per indirizzi IPv4 e IPv6. 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

La corrispondenza in base all'esistenza è relativa alla presenza o all'assenza di un campo nel JSON dell'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 eventi precedente NON corrisponde all'evento seguente perché non ha un campo 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 abbinamento

Equals-ignore-casela corrispondenza 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 valore InvalidEventPatternException quando si 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 ] } ] }
    ]
  }
}