イベント構造リファレンス

次のフィールドは、イベントバスに配信されるすべてのイベントに表示され、イベントのメタデータ を構成します。

{
  "version": "0",
  "id": "UUID",
  "detail-type (ディテールタイプ)": "event name",
  "ソース": "event source",
  "アカウント": "ARN",
  "time": "timestamp",
  "region": "region",
  "resources": [
    "ARN"
  ],
  "detail": {
    JSON object
  }
}

version

デフォルトでは、これはすべてのイベントで 0（ゼロ）に設定されます。

id

イベントごとに生成されるバージョン 4 UUID。id を使用すると、ルールからターゲットに移動するときのイベントをトレースできます。

detail-type (ディテールタイプ)

[source] フィールドと組み合わせて、[detail] フィールドに表示されるフィールドと値を識別します。

によって配信されるイベントは CloudTrail 、 の値AWS API Call via CloudTrailとして を持ちますdetail-type。

ソース

イベントを発生させたサービスを識別します。 AWS サービスからのイベントはすべて、「AWS」で始まります。顧客から発生したイベントは、「aws」で始まらない限り、このフィールドに値があります。Java パッケージ名のスタイルには逆ドメイン名の文字列を使用することをお勧めします。

AWS サービスの の正しい値を見つけるには、「条件キーテーブルsource」を参照し、リストからサービスを選択し、サービスプレフィックス を探します。例えば、Amazon のsource値は CloudFront ですaws.cloudfront。

アカウント

AWS アカウントを識別する 12 桁の番号。

time

イベントを発生したサービスによって指定できるイベントのタイムスタンプ。イベントが時間間隔にまたがる場合、サービスは開始時間をレポートできるため、この値は、イベントが受け取られるより前の時間になることがあります。

region

イベントが発生した AWS リージョンを識別します。

resources

JSON 配列に、イベントにかかわるリソースを識別する ARN が格納されます。これらの ARN を含めるかどうかは、イベントを生成するサービスによって決まります。例えば、Amazon EC2 インスタンスの状態変更では、Amazon EC2 インスタンス ARN が格納され、Auto Scaling イベントでは、インスタンスと Auto Scaling グループの両方の ARN が格納されますが、 AWS CloudTrail での API コールでは、リソース ARN は格納されせん。

detail

イベントに関する情報を含む JSON オブジェクト。このフィールドの内容は、イベントを生成するサービスによって決まります。"{}" とすることができます。

AWS API コールイベントには詳細オブジェクトがあり、約 50 個のフィールドが複数のレベルの深さにネストされています。

注記

PutEvents は JSON 形式のデータを受け入れます。JSON 番号 (整数) データタイプの場合、制約は、最小値が -9,223,372,036,854,775,808、最大値が 9,223,372,036,854,775,807 です。

例: Amazon EC2 インスタンスの状態変更通知

Amazon の次のイベントは、Amazon EC2 インスタンスが終了される EventBridge ことを示します。

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

有効なカスタムイベントに必要な最小限の情報

カスタムイベントを作成する場合、次のフィールドが含まれている必要があります。

• detail

• detail-type

• source

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