Referenz der Ereignisstruktur

Die folgenden Felder erscheinen in allen Ereignissen, die an einen Event-Bus übermittelt werden, und enthalten die Metadaten des Ereignisses:

{
  "version": "0",
  "id": "UUID",
  "detail-type": "event name",
  "Quelle": "event source",
  "Konto": "ARN",
  "time": "timestamp",
  "Region": "region",
  "Ressourcen": [
    "ARN"
  ],
  "Detail": {
    JSON object
  }
}

version

Die Standardeinstellung bei allen Ereignissen lautet 0 (Null).

id

Eine UUID der Version 4, die für jedes Ereignis generiert wurde. Sie können id verwenden, um Ereignisse zu verfolgen, während sie sich durch Regeln zu Zielen bewegen.

detail-type

Identifiziert in Kombination mit dem Feld source die Felder und Werte, die im Feld detail angezeigt werden.

Ereignisse, die von CloudTrail haben AWS API Call via CloudTrail als Wert für übermittelt detail-type werden.

Quelle

Identifiziert den Service, aus dem das Ereignis stammt. Alle Ereignisse, die von AWS -Services stammen, beginnen mit „aws“. Vom Kunden generierte Ereignisse können hier jeden Wert haben, solange sie nicht mit "aws" beginnen. Wir empfehlen, Reverse-Domänennamen-Zeichenfolgen im Namensstil von Java-Paketen zu verwenden.

Um den richtigen Wert für source für einen AWS Dienst zu finden, schauen Sie sich die Tabelle mit den Bedingungsschlüsseln an, wählen Sie einen Dienst aus der Liste aus und suchen Sie nach dem Dienstpräfix. Zum Beispiel CloudFront ist der source Wert für Amazonaws.cloudfront.

Konto

Die 12-stellige Zahl, die ein AWS Konto identifiziert.

time

Der Zeitstempel eines Ereignisses, der von dem Service, aus dem das Ereignis stammt, festgelegt werden kann. Wenn das Ereignis ein Zeitintervall umfasst, kann der Service die Startzeit berichten, sodass dieser Wert vor dem Zeitpunkt liegen kann, zu dem das Ereignis empfangen wird.

Region

Identifiziert die AWS Region, in der das Ereignis seinen Ursprung hat.

Ressourcen

Ein JSON-Array, das die ARNs enthält, die die am Ereignis beteiligten Ressourcen identifizieren. Der Service, der das Ereignis generiert, bestimmt, ob diese ARNs eingeschlossen werden. So enthalten Amazon EC2-Instance-Statusänderungen beispielsweise Amazon EC2-Instance-ARNs, und Auto Scaling-Ereignisse umfassen ARNs sowohl für Instances als auch Auto Scaling-Gruppen, jedoch schließen API-Aufrufe mit AWS CloudTrail keine Ressourcen-ARNs ein.

Detail

Ein JSON-Objekt, das Informationen zum Ereignis enthält. Der Service, der das Ereignis generiert, bestimmt den Inhalt dieses Feldes. Das kann "{}" sein.

AWS API-Aufrufereignisse enthalten Detailobjekte mit etwa 50 Feldern, die mehrere Ebenen tief verschachtelt sind.

Anmerkung

PutEventsakzeptiert Daten im JSON-Format. Für den Datentyp JSON-Zahl (Ganzzahl) gelten folgende Einschränkungen: ein Mindestwert von -9,223,372,036,854,775,808 und ein Höchstwert von 9,223,372,036,854,775,807.

Beispiel: Benachrichtigung über die Statusänderung für eine Amazon-EC2-Instance

Das folgende Ereignis in Amazon EventBridge weist darauf hin, dass eine Amazon EC2 EC2-Instance beendet wurde.

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

Mindestinformationen, die für ein gültiges benutzerdefiniertes Ereignis erforderlich sind

Wenn Sie benutzerdefinierte Ereignisse erstellen, müssen sie die folgenden Felder umfassen:

• detail

• detail-type

• source

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