イベントメタデータフィールドリファレンス

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

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

version

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

id

すべてのイベントに対して生成されるバージョン UUID 4。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

イベントに関係するリソースARNsを識別する を含むJSON配列。イベントを生成するサービスは、これらの を含めるかどうかを決定しますARNs。例えば、Amazon EC2インスタンスの状態変更には Amazon EC2インスタンス が含まれARNs、Auto Scaling イベントにはインスタンスと Auto Scaling グループの両方ARNsが含まれますが、 を使用したAPI呼び出し AWS CloudTrail にはリソース は含まれませんARNs。

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