AWS サービスイベントメタデータ - Amazon EventBridge
有効な最小のカスタムイベント

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS サービスイベントメタデータ

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

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

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

id

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

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

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

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

ソース

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

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

アカウント

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

時系

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

region

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

リソース

イベントに関与するリソース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": {
  }
}