Riferimento per la struttura degli eventi

I seguenti campi vengono visualizzati in tutti gli eventi inviati a un bus di eventi e comprendono i metadati dell'evento:

{
  "version": "0",
  "id": "UUID",
  "detail-type (tipo di dettaglio)": "event name",
  "source": "event source",
  "account": "ARN",
  "time": "timestamp",
  "Regione": "region",
  "risorse": [
    "ARN"
  ],
  "detail (dettaglio)": {
    JSON object
  }
}

version

Per impostazione predefinita, questo valore è impostato su 0 (zero) in tutti gli eventi.

id

Un UUID versione 4 generato per ogni evento. Puoi utilizzare id per tracciare eventi mentre si spostano attraverso le regole verso le destinazioni.

detail-type (tipo di dettaglio)

Identifica, in combinazione con il campo source (origine), i campi e i valori visualizzati nel campo detail (dettaglio).

Gli eventi che vengono consegnati da CloudTrail hanno AWS API Call via CloudTrail come valore per. detail-type

source

Identifica il servizio che ha generato l'evento. Tutti gli eventi che provengono dai servizi AWS iniziano con "aws". Gli eventi generati dal cliente possono qui presentare qualsiasi valore, purché non inizi con "aws". Consigliamo l'uso di stringhe di nomi di domino inverse che utilizzano lo stile di nomi dei pacchetti di Java.

Per trovare il valore corretto source per un AWS servizio, consulta La tabella delle chiavi di condizione, seleziona un servizio dall'elenco e cerca il prefisso del servizio. Ad esempio, il source valore per Amazon CloudFront èaws.cloudfront.

account

Il numero di 12 cifre che identifica un AWS account.

time

Il timestamp dell'evento, che può essere specificato dal servizio che origina l'evento. Se l'evento si estende per un intervallo di tempo, il servizio potrebbe segnalare l'orario di inizio, pertanto questo valore potrebbe essere antecedente all'orario di ricezione dell'evento.

Regione

Identifica la AWS regione da cui ha avuto origine l'evento.

risorse

Un array JSON che contiene gli ARN che identificano le risorse coinvolte nell'evento. Il servizio che genera l'evento determina se includere questi ARN. Ad esempio, le modifiche dello stato delle istanze Amazon EC2 includono gli ARN delle istanze Amazon EC2, gli eventi Auto Scaling includono gli ARN delle istanze e dei gruppi Auto Scaling, ma la chiamate API con AWS CloudTrail non includono gli ARN di risorsa.

detail (dettaglio)

Un oggetto JSON contenente informazioni sull'evento. Il servizio che genera l'evento determina il contenuto di questo campo. Può essere "{}".

AWS Gli eventi di chiamata API hanno oggetti di dettaglio con circa 50 campi annidati a diversi livelli di profondità.

Nota

PutEventsaccetta dati in formato JSON. Per il tipo di dati numero JSON (intero), i vincoli sono: un valore minimo di -9.223.372.036.854.854.775.808 e un valore massimo di 9.223.372.036.854.854.854.775.807.

Esempio: notifica sulla modifica dello stato dell'istanza di Amazon EC2

Il seguente evento in Amazon EventBridge indica la chiusura di un'istanza Amazon EC2.

{
  "version": "0",
  "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
  "detail-type": "EC2 Instance State-change Notification",
  "source": "aws.ec2",
  "account": "111122223333",
  "time": "2017-12-22T18:43:48Z",
  "region": "us-west-1",
  "resources": [
    "arn:aws:ec2:us-west-1:123456789012:instance/i-1234567890abcdef0"
  ],
  "detail": {
    "instance-id": " i-1234567890abcdef0",
    "state": "terminated"
  }
}

Informazioni minime necessarie per un evento personalizzato valido

Quando crei eventi personalizzati, questi devono includere i seguenti campi:

• detail

• detail-type

• source

{
  "detail-type": "event name",
  "source": "event source",
  "detail": {
  }
}