AWS Metadaten von Dienstereignissen

Die folgenden Felder erscheinen in allen Ereignissen, die an einen Event-Bus übermittelt werden, und umfassen 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 Version 4UUID, die für jedes Ereignis generiert wird. 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 geliefert werden CloudTrail AWS API Call via CloudTrail, haben den Wert fürdetail-type.

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.

Den richtigen Wert für source für einen AWS Dienst finden Sie in der Tabelle mit den Bedingungsschlüsseln. 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 Ressourcen enthältARNs, die identifizieren, die an dem Ereignis beteiligt sind. Der Dienst, der das Ereignis generiert, bestimmt, ob diese berücksichtigt werden sollenARNs. Beispielsweise umfassen Änderungen des EC2 Amazon-Instance-Status EC2 Amazon-InstancesARNs, Auto Scaling Scaling-Ereignisse beziehen ARNs sich sowohl auf Instances als auch auf Auto Scaling Scaling-Gruppen, aber API Aufrufe mit schließen AWS CloudTrail keine Ressourcen ARNs ein.

Detail

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

AWS APIAnrufereignisse 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 Statusänderung der EC2 Amazon-Instance

Das folgende Ereignis in Amazon EventBridge weist darauf hin, dass eine EC2 Amazon-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": {
  }
}